PHP函数参考08-日期与时间扩展
目录
- DateTimeInterface接口
- 时间格式DateTime 类
- 时间格式DateTimeImmutable类
- 时区DateTimeZone类
- 时间间隔DateInterval类
- 时间周期DatePeriod 类
- 范例
- datetime函数
- 关于时间格式
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类来实现。
使用时间和日期相关类,更符合编程思想。