DateTime::diff
DateTimeImmutable::diff
DateTimeInterface::diff
date_diff
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateTime::diff -- DateTimeImmutable::diff -- DateTimeInterface::diff -- date_diff — Returns the difference between two DateTime objects
说明
面向对象风格
$targetObject
, bool $absolute
= false
) : DateInterval$targetObject
, bool $absolute
= false
) : DateInterval过程化风格
$baseObject
, DateTimeInterface $targetObject
, bool $absolute
= false
) : DateIntervalReturns the difference between two DateTimeInterface objects.
参数
-
datetime
-
The date to compare to.
-
absolute
-
Should the interval be forced to be positive?
返回值
The DateInterval object represents the
difference between the two dates 或者在失败时返回 false
.
The return value more specifically represents the interval to apply to the
original object ($this
or
$originObject
) to arrive at the
$targetObject
. This process is not always
reversible.
范例
示例 #1 DateTime::diff() example
面向对象风格
<?php
$origin = new DateTime('2009-10-11');
$target = new DateTime('2009-10-13');
$interval = $origin->diff($target);
echo $interval->format('%R%a days');
?>
过程化风格
<?php
$origin = date_create('2009-10-11');
$target = date_create('2009-10-13');
$interval = date_diff($origin, $target);
echo $interval->format('%R%a days');
?>
以上例程会输出:
+2 days
示例 #2 DateTime object comparison
注意:
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);
?>
以上例程会输出:
bool(false) bool(true) bool(false)
参见
- DateInterval::format() - Formats the interval
- DateTime::add() - 给一个 DateTime 对象增加一定量的天,月,年,小时,分钟 以及秒。
- DateTime::sub() - 对一个 DateTime 对象减去一定量的 日、月、年、小时、分钟和秒。