DateIntervalクラスのformatメソッド
DateIntervalクラスのformatメソッドは、指定されたフォーマットに従って時間間隔を文字列表現に変換します。パラメータとして特殊文字を含むフォーマット文字列を受け取り、フォーマットされた文字列を返します。
構文
public DateInterval::format(string $format): string
特殊文字
| 指定子 | 説明 | 例 |
|---|---|---|
%Y |
年数（最低2桁） |
01, 12 |
%y |
年数（ゼロ埋めなし） | 1, 12 |
%M |
月数（最低2桁） |
01, 11 |
%m |
月数（ゼロ埋めなし） | 1, 11 |
%D |
日数（最低2桁） |
01, 31 |
%d |
日数（ゼロ埋めなし） | 1, 31 |
%H |
時間数（最低2桁） |
01, 23 |
%h |
時間数（ゼロ埋めなし） | 1, 23 |
%I |
分数（最低2桁） |
01, 59 |
%i |
分数（ゼロ埋めなし） | 1, 59 |
%S |
秒数（最低2桁） |
01, 59 |
%s |
秒数（ゼロ埋めなし） | 1, 59 |
%R |
インターバルの符号（+ または -） | +, - |
%r |
インターバルの符号（負の場合は明示的に - ） | , - |
%% |
パーセント記号 | % |
例
日数と時間数でのインターバルのフォーマット：
<?php
$interval = new DateInterval('P2DT5H');
echo $interval->format('%d days, %h hours');
?>
コード実行結果：
'2 days, 5 hours'
例
完全な表現でのインターバルのフォーマット：
<?php
$interval = new DateInterval('P1Y3M5DT7H10M');
echo $interval->format('%y years %m months %d days %h hours %i minutes');
?>
コード実行結果：
'1 years 3 months 5 days 7 hours 10 minutes'
例
ゼロ埋めでのインターバルのフォーマット：
<?php
$interval = new DateInterval('PT5H3M');
echo $interval->format('%H:%I');
?>
コード実行結果：
'05:03'
関連項目
-
時間間隔を表すクラス
DateInterval -
日時をフォーマットするメソッド
DateTime::format -
タイムスタンプをフォーマットする関数
date
