DateInterval::format
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateInterval::format — Formats the interval
参数
format-
The following characters are recognized in the formatparameter string. Each format character must be prefixed by a percent sign (%).formatcharacterDescription Example values %Literal %%YYears, numeric, at least 2 digits with leading 0 01,03yYears, numeric 1,3MMonths, numeric, at least 2 digits with leading 0 01,03,12mMonths, numeric 1,3,12DDays, numeric, at least 2 digits with leading 0 01,03,31dDays, numeric 1,3,31aTotal number of days as a result of a DateTime::diff() or (unknown)otherwise4,18,8123HHours, numeric, at least 2 digits with leading 0 01,03,23hHours, numeric 1,3,23IMinutes, numeric, at least 2 digits with leading 0 01,03,59iMinutes, numeric 1,3,59SSeconds, numeric, at least 2 digits with leading 0 01,03,57sSeconds, numeric 1,3,57FMicroseconds, numeric, at least 6 digits with leading 0 007701,052738,428291fMicroseconds, numeric 7701,52738,428291RSign " -" when negative, "+" when positive-,+rSign " -" when negative, empty when positive-,
返回值
Returns the formatted interval.
更新日志
| 版本 | 说明 |
|---|---|
| 7.2.12 | The F and f format
will now always be positive. |
| 7.1.0 | The F and f format
characters were added. |
示例
示例 #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
注释
注意:
The DateInterval::format() method does not recalculate carry over points in time strings nor in date segments. This is expected because it is not possible to overflow values like
"32 days"which could be interpreted as anything from"1 month and 4 days"to"1 month and 1 day".
＋添加备注
用户贡献的备注 1 note
online dot cloudmeetings dot marco at gmail dot com ¶
7 months ago
Pls note these important abbreviations;
P: period
Y: years
M: months
D: days
T: time
H: hours
M: minutes
S: seconds
The above is from the ISO 8601 - an international standard that defines how to use, store, and transfer date, time, and duration information.