PHP | date_diff()函数

简介

date_diff() 函数可以计算两个日期之间的差值。它返回一个 DateInterval 对象，该对象表示两个日期之间的差值。可以使用该对象来计算各种差异，如年份，月份，天数，小时等。

语法

date_diff ( DateTimeInterface $datetime1 , DateTimeInterface $datetime2 [, bool $absolute = false ] ) : DateInterval

参数说明：

• $datetime1：必需。一个 DateTimeInterface 对象，表示要计算的第一个日期。
• $datetime2：必需。一个 DateTimeInterface 对象，表示要计算的第二个日期。
• $absolute：可选。布尔值，指定是否返回计算出的差值的绝对值。默认为 false。

返回值：

• 如果时间不能被计算，返回 FALSE。
• 如果计算成功，则返回一个 DateInterval 对象，表示两个日期之间的差值。

示例

$datetime1 = new DateTime('2021-01-01');
$datetime2 = new DateTime('2021-03-15');
$interval = date_diff($datetime1, $datetime2);
echo $interval->format('%R%a days');

输出：

+73 days

上述代码计算了 2021 年 1 月 1 日和 2021 年 3 月 15 日之间的天数差异，并将结果格式化为带有正负号的字符串。

注意点

• date_diff() 函数接受两个 DateTimeInterface 对象。这里可以使用 DateTime 对象或 DateTimeImmutable 对象。
• date_diff() 函数返回的是一个 DateInterval 对象，可以通过该对象的方法来获取计算出的差异。例如，format() 方法可以将差异格式化为字符串。

参考链接

• PHP 官方文档