PHP函数参考08-日期与时间扩展

• DateTimeInterface接口
• 时间格式DateTime 类
• 时间格式DateTimeImmutable类
• 时区DateTimeZone类
• 时间间隔DateInterval类
• 时间周期DatePeriod 类
• 范例
• datetime函数
• 关于时间格式

原文：
PHP函数参考08-日期与时间扩展 - 9ong
PHP函数参考09-文件系统函数与扩展类 - 9ong

DateTimeInterface接口

DateTimeInterface接口是为了给类DateTime类和DateTimeImmutable类做类型约束用的。

该接口定义了6个方法：

• diff(absolute = false)：返回两个DateTime对象的差值。接受两个参数，第一个为要进行比较的日期DateTimeInterface对象，第二个参数为可选的表示是否差值必须是正数，如果为true则总是返回正数。默认为false。返回一个 DateInterval对象来表示两个日期的差值，若比较失败则返回false。
• format($format)：返回根据指定格式格式化后的日期。接受一个参数为日期的格式字符串。若失败则返回false。此方法不受区域设置影响。
• getOffset：以秒为单位返回日期与当前时区偏移量。
• getTimestamp：获取unix时间戳。等同于strtotime函数。
• getTimezone：返回日期的时区信息类DateTimeZone的对象。
• __wakeup：魔术方法，返回一个实例化的DateTime对象。

时间格式DateTime 类

PHP 5.2后新增的处理时间格式类，可以输出、转换、计算时间，很好的替代了 date() 、strtotime()等函数。

public __construct ([ string $time = "now" [, DateTimeZone $timezone = NULL ]] )

构造返回一个DateTime对象。

除了实现DateTimeInterface接口6个方法外，DateTime类也有自己的一些方法，比如add、sub、modify、setTime、setDate、setTimestamp、setTimezone 等

时间格式DateTimeImmutable类

DateTimeImmutable类是 PHP 5.5后新增的处理时间格式类，该类与DateTime相同，只是它从不修改自己，而是返回一个新对象。

时区DateTimeZone类

DateTimeZone 表示时区的类。

可以通过getLocation 、getName 获得时区的相关信息。

时间间隔DateInterval类

表示一个时间间隔的类。

一个时间间隔表示固定量的时间（多少年，月，天，小时等）， 也可以表示一个字符串格式的相对时间， 当表示相对时间的时候，字符串格式是DateTime类的构造函数所支持的格式。

时间间隔表示格式：构造函数参数 string $duration 如：P2W。格式以字母P开头，每个持续时间段由一个整数值表示，后跟一个间隔标志符。 如果持续时间包含时间元素（表中的HMS），则在规范的该部分之前加上字母T。

周期指示	描述
Y	years
M	months
D	days
W	weeks. These get converted into days,so can not be combined with D.
H	hours
M	minutes
S	seconds

范例：注意P和T

$interval = new DateInterval('P2Y4DT6H8M');
var_dump($interval);

时间周期DatePeriod 类

DatePeriod 类表示一个时间周期。

一个时间周期可以用来在给定的一段时间之内，以一定的时间间隔进行迭代。

范例

$date = new DateTimeImmutable();
echo $date->getTimestamp().PHP_EOL;
echo $date->format("Y-m-d H:i:s").PHP_EOL;
echo time().PHP_EOL;
echo date("Y-m-d H:i:s",time()).PHP_EOL;

$timestr = "2020-12-12 12:12:10";
$date = new DateTimeImmutable($timestr);
$time = $date->getTimestamp();
echo PHP_EOL;
echo $time.PHP_EOL;
echo date("Y-m-d H:i:s",$time).PHP_EOL;
echo strtotime($timestr).PHP_EOL;

输出：

1615711430
2021-03-14 16:43:50
1615711430
2021-03-14 16:43:50

1607746330
2020-12-12 12:12:10
1607746330

DatePeriod与DateInterval的区别哪里？可以看下面的例子就更清楚两个类的用途了：

$start = new DateTime('2020-01-01');//定义一个时间周期的开始时间
$interval = new DateInterval('P7D');//初始化一个时间间隔7天
$end = new DateTime('2020-01-31');//定义一个时间周期的结束时间

$period = new DatePeriod($start, $interval, $end,DatePeriod::EXCLUDE_START_DATE);//通过开始时间、结束时间、时间间隔，初始化一个时间周期对象

//通过遍历DatePeriod对象
//打印该时间段内所有的重复日期。
//注意，在EXCLUDE_START_DATE下，2020-07-01不打印。
foreach ($period as $date) {
    echo $date->format('Y-m-d')."\n";
}

输出：

2020-01-08
2020-01-15
2020-01-22
2020-01-29

datetime函数

datetime函数在php代码中用都很广泛，特别是date、strtotime、mktime、time、microtime等函数，很多函数都可以通过以上的接口和5个类来实现相应的逻辑。

当然像time、microtime获取当下的时间戳还是很简便的。

但对于strtotime，如果需要时区信息时，我们建议考虑功能更强大的DateTimeImmutable类来实现。

使用时间和日期相关类，更符合编程思想。

关于时间格式

参考官方：PHP: Relative Formats - Manual

---

原文：
PHP函数参考08-日期与时间扩展 - 9ong
PHP函数参考09-文件系统函数与扩展类 - 9ong