(PHP 5 >= 5.3.0, PHP 7)
DateTime::diff -- DateTimeImmutable::diff -- DateTimeInterface::diff -- date_diff — Returns the difference between two DateTime objects
Object oriented style
$datetime2
[, bool $absolute = FALSE
] ) : DateInterval$datetime2
[, bool $absolute = FALSE
] ) : DateIntervalProcedural style
$datetime1
, DateTimeInterface $datetime2
[, bool $absolute = FALSE
] ) : DateIntervalReturns the difference between two DateTimeInterface objects.
datetimeThe date to compare to.
absoluteShould the interval be forced to be positive?
The DateInterval object representing the
difference between the two dates or FALSE on failure.
Example #1 DateTime::diff() example
Object oriented style
<?php
$datetime1 = new DateTime('2009-10-11');
$datetime2 = new DateTime('2009-10-13');
$interval = $datetime1->diff($datetime2);
echo $interval->format('%R%a days');
?>
Procedural style
<?php
$datetime1 = date_create('2009-10-11');
$datetime2 = date_create('2009-10-13');
$interval = date_diff($datetime1, $datetime2);
echo $interval->format('%R%a days');
?>
The above examples will output:
+2 days
Example #2 DateTime object comparison
Note:
As of PHP 5.2.2, DateTime objects can be compared using comparison operators.
<?php
$date1 = new DateTime("now");
$date2 = new DateTime("tomorrow");
var_dump($date1 == $date2);
var_dump($date1 < $date2);
var_dump($date1 > $date2);
?>
The above example will output:
bool(false) bool(true) bool(false)