DateInterval::format
(PHP 5 >= 5.3.0, PHP 7)
DateInterval :: format - 格式化时间间隔
描述
public string DateInterval::format ( string $format )格式化时间间隔。
参数
format
格式字符 | 描述 | 示例值 |
|---|---|---|
% | 文字％ | % |
Y | 年份，数字，至少2位数，前导0 | 01, 03 |
y | 年，数字 | 1, 3 |
M | 月份，数字，至少2位数，前导0 | 01, 03, 12 |
m | 几个月，数字 | 1, 3, 12 |
D | 天，数字，至少2位数，前导0 | 01, 03, 31 |
d | 天，数字 | 1, 3, 31 |
a | DateTime :: diff（）或（未知）的结果总天数 | 4, 18, 8123 |
H | 小时，数字，至少2位数，前导0 | 01, 03, 23 |
h | 小时，数字 | 1, 3, 23 |
I | 分钟，数字，至少2位数，前导0 | 01, 03, 59 |
i | 分钟，数字 | 1, 3, 59 |
S | 秒，数字，至少2位数，前导0 | 01, 03, 57 |
s | 秒，数字 | 1, 3, 57 |
F | 微秒，数字，至少6位数，前导0 | 007701, 052738, 428291 |
f | 微秒，数字 | 7701, 52738, 428291 |
R | “ - ”表示否定，“+”表示正面 | -, + |
r | 签名“ - ”时为负数，正数时为空 | -, |
返回值
返回格式化的时间间隔。
注意
注意：DateInterval :: format（）方法不会重新计算结转时间字符串的点或日期段。这是预料之中的，因为它不可能像“32天”那样溢出，可以解释为从“1个月和4天”到“1个月和1天”之间的任何值。
更新日志
版 | 描述 |
|---|---|
7.1.0 | 添加了F和f格式的字符。 |
例子
示例 #1 DateInterval example
<?php
$interval?=?new?DateInterval('P2Y4DT6H8M');
echo?$interval->format('%d?days');
?>上面的例子将输出：
4 days示例 #2 DateInterval and carry over points
<?php
$interval?=?new?DateInterval('P32D');
echo?$interval->format('%d?days');
?>上面的例子将输出：
32 days示例 #3 DateInterval and DateTime::diff() with the %a and %d modifiers
<?php
$january?=?new?DateTime('2010-01-01');
$february?=?new?DateTime('2010-02-01');
$interval?=?$february->diff($january);
//?%a?will?output?the?total?number?of?days.
echo?$interval->format('%a?total?days')."\n";
//?While?%d?will?only?output?the?number?of?days?not?already?covered?by?the
//?month.
echo?$interval->format('%m?month,?%d?days');
?>上面的例子将输出：
31 total days
1 month, 0 days本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com
