PHP date_interval_format() 関数

二つの日期間の間隔を計算して、時間間隔をフォーマットします:

<?php
$date1=date_create("1984-01-28");
$date2=date_create("1980-10-15");
$diff=date_diff($date1,$date2);
// %a は合計日数を出力
echo $diff->format("合計日数:%a.");
?>

実行例

定義と使用法

date_interval_format() 関数は DateInterval::format() の別名です。

DateInterval::format() 関数は時間間隔をフォーマットするために使用されます。

文法

DateInterval::format(format);
パラメータ 説明
format

必須。フォーマットを指定します。format パラメータの文字列は以下の文字を使用できます:

  • % - 文字列の %
  • Y - 年、少なくとも2桁、先頭にゼロ(例:03)
  • y - 年(例:3)
  • M - 月、先頭にゼロ(例:06)
  • m - 月(例:6)
  • D - 日、先頭にゼロ(例:09)
  • d - 日(例:9)
  • a - date_diff() から得られる2つの日付間隔の合計日数
  • H - 時、先頭にゼロ(例:08、23)
  • h - 時(例:8、23)
  • I - 分、先頭にゼロ(例:08、23)
  • i - 分(例:8、23)
  • S - 秒、先頭にゼロ(例:08、23)
  • s - 秒(例:8、23)
  • R - 負の数の場合はシンボル "-"、正の数の場合はシンボル "+"
  • r - 負の数の場合はシンボル "-"、正の数の場合は空

コメント:各フォーマット文字列は % 符号で始まる必要があります!

技術的な詳細

返り値: フォーマットされた時間間隔を返します。
PHP バージョン: 5.3+