php date_diff PHP date_diff() 函数

php date_diff

PHP date_diff 函数用于计算两个日期之间的差异。它返回一个 DateInterval 对象，其中包含有关日期差异的信息。

date_diff() 函数需要两个参数，第一个参数是 DateTime 对象，第二个参数是 DateTimeZone 对象。如果不提供第二个参数，则使用默认时区。

$date1 = new DateTime("2020-01-01"); 
$date2 = new DateTime("2020-02-01"); 
$interval = date_diff($date1, $date2); 
echo $interval->format("%R%a days");  // +31 days 

上面的代码将会显示 2020 年 1 月 1 日和 2020 年 2 月 1 日之间相差 31 天。

DateInterval 类还提供了一些方法来获取日期差异的详细信息：

 
$interval->y; // 返回年份差异  
$interval->m; // 返回月份差异  
$interval->d; // 返回天数差异  
$interval->h; // 返回小时差异  
$interval->i; // 返回分钟差异  
$interval->s; // 返回秒数差异  

 

此外，DateInterval 类还提供了 format() 方法来格式化日期间隔：

 

 echo $interval->format('%y Year %m Month %d Day');  // 0 Year 1 Month 0 Day 

 

上面的代码将会显示 0 Year 1 Month 0 Day ，表明 2020 年 1 月 1 日和 2020 年 2 月 1 日之间相隔一个月零一天。

总而言之，PHP date_diff()函数用于获取两个日期之间的详细信息，它返回一个 DateInterval对象，其中包含有关日期差异的信息。我们可以使用DateInterval 类中的方法来获取详细信息，也可以使用 format() 方法来格式化时间间隔。

PHP date_diff() 函数

PHP date_diff() 函数

PHP Date/Time 参考手册

实例

计算两个日期间的差值：

<?php
$date1=date_create("2013-03-15");
$date2=date_create("2013-12-12");
$diff=date_diff($date1,$date2);
?>

运行实例 »

---

定义和用法

date_diff() 函数返回两个 DateTime 对象间的差值。

语法

date_diff(datetime1,datetime2,absolute);

参数	描述
datetime1	必需。规定一个 DateTime 对象。
datetime2	必需。规定一个 DateTime 对象。
absolute	可选。规定一个布尔值。TRUE 表示间隔/差值必须是正的。默认是 FALSE。

技术细节

返回值：	如果成功则返回一个 DateInterval 对象，表示两个日期间的差值。如果失败则返回 FALSE。
PHP 版本：	5.3+

---

PHP Date/Time 参考手册