array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), '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' => 'en', '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 — Subtracts an amount of days, months, years, hours, minutes and seconds from a DateTime object
Object-oriented style
Procedural style
Modifies the specified DateTime object, by subtracting the specified DateInterval object.
Like DateTimeImmutable::sub() but works with DateTime.
The procedural version takes the DateTime object as its first argument.
object
Procedural style only: A DateTime object returned by date_create(). The function modifies this object.
interval
A DateInterval object
Returns the modified DateTime object for method chaining.
Object Orientated API only: If an unsupported operation is attempted, such as using a
DateInterval object representing relative time
specifications such as next weekday
, a
DateInvalidOperationException is thrown.
Version | Description |
---|---|
8.3.0 | Now throws a DateInvalidOperationException with DateTime::sub(), instead of a warning when an unsupported operation is attempted. date_sub() has not been changed. |