date_interval_format()

1. 定义

该函数为DateTime对象的函数format()的别名,用以格式化时间间隔。

2. 语法

public DateInterval::format ( string $format ) : string

date_interval_format( DateInterval $object, string $format ) : string

3. 参数说明

参数 可选性 数据类型 描述
$object 必需 DateInterval DateInterval时间对象
$format 必需 字符串 符合规范的解析日期/时间的格式化字符串

其中,$format参数有以下可选值:

符号 描述
% 格式化标识符
Y 带前导零的间隔年份
y 不带前导零的间隔年份
M 带前导零的间隔月份
m 不带前导零的间隔月份
D 带前导零的间隔天数
d 不带前导零的间隔天数,不计算年月相隔
a 间隔总天数
H 带前导零的间隔小时数
h 不带前导零的间隔小时数
I 带前导零的间隔分钟数
i 不带前导零的间隔分钟数
S 带前导零的间隔秒数
s 不带前导零的间隔秒数
F 带前导零的至少六位数的间隔微秒数
f 不带前导零的间隔微秒数
R 带正负号
r 不带正负号

4. 示例

<?php

// date_interval_format()
// 格式化时间间隔

$time1 = new DateTime('2019-07-31');
$time2 = new DateTime('2019-09-01');
$diff = $time1->diff($time2);
$interval = $diff->format('%a');
echo '两个日期之间相隔了', $interval, '天',"\n";// 输出:两个日期之间相隔了32天

$time1 = date_create('2019-08-31');
$time2 = date_create('2019-09-01');
$diff = date_diff($time1, $time2);
date_interval_format($diff, '%a');
echo '两个日期之间相隔了', $interval, '天';// 输出:两个日期之间相隔了32天

5. 延展阅读

  • date_diff():对象DateTime的方法diff()的别名。返回两个DateTime对象之间的时间间隔信息