目录

DateTimeInterface接口

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

该接口定义了6个方法:

  • diff($datetime2, $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