DateIntervalクラスのformatメソッド

DateIntervalクラスのformatメソッドは、指定されたフォーマットに従って時間間隔を文字列表現に変換します。パラメータとして特殊文字を含むフォーマット文字列を受け取り、フォーマットされた文字列を返します。

構文

phppublic 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<?php
  $interval = new DateInterval('P2DT5H');
  echo $interval->format('%d days, %h hours');
?>

コード実行結果:

php'2 days, 5 hours'

例

完全な表現でのインターバルのフォーマット:

php<?php
  $interval = new DateInterval('P1Y3M5DT7H10M');
  echo $interval->format('%y years %m months %d days %h hours %i minutes');
?>

コード実行結果:

php'1 years 3 months 5 days 7 hours 10 minutes'

例

ゼロ埋めでのインターバルのフォーマット:

php<?php
  $interval = new DateInterval('PT5H3M');
  echo $interval->format('%H:%I');
?>

コード実行結果:

php'05:03'

関連項目

  • 時間間隔を表すクラス DateInterval
  • 日時をフォーマットするメソッド DateTime::format
  • タイムスタンプをフォーマットする関数 date