PHP 8.0.24 Released!



(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

public DateTime::sub(DateInterval $interval): DateTime

Procedural style

date_sub(DateTime $object, DateInterval $interval): DateTime

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.



Procedural style only: A DateTime object returned by date_create(). The function modifies this object.


A DateInterval object

Return Values

Returns the modified DateTime object for method chaining or false on failure.

See Also

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top