array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'datetime.sub.php', 1 => 'DateTime::sub', ), 'up' => array ( 0 => 'class.datetime.php', 1 => 'DateTime', ), 'prev' => array ( 0 => 'datetime.settimezone.php', 1 => 'DateTime::setTimezone', ), 'next' => array ( 0 => 'class.datetimeimmutable.php', 1 => 'DateTimeImmutable', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/datetime/datetime/sub.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateTime::sub -- date_sub — 对 DateTime 对象减去一定量的日、月、年、小时、分钟和秒。
面向对象风格
过程化风格
对指定 DateTime 对象,减去指定 DateInterval 对象。
跟 DateTimeImmutable::sub() 一样,但适用于 DateTime。
过程化版本将 DateTime 对象作为第一个参数。
object
仅过程化风格:由 date_create() 返回的 DateTime 类型的对象。此函数会修改这个对象。
interval
DateInterval 对象
返回方法链修改后的 DateTime 对象。
仅限于面向对象的API:如果尝试不受支持的操作,比如使用 DateInterval 对象表示相对时间规格(如
next weekday
)的,将会抛出 DateInvalidOperationException。
版本 | 说明 |
---|---|
8.3.0 | 当尝试执行不受支持的操作时,DateTime::sub() 现在会抛出 DateInvalidOperationException,而不是警告。date_sub() 尚未更改。 |