PHP date() 関数

PHP Date / Time関数

例

ローカルの日付と時間をフォーマットし、フォーマットされた日付文字列を返します：

<?php
// 日を出力
echo date("l") . "<br>";
// 日、日付、月、年、時間 AM または PM を出力
echo date("l jS \of F Y h:i:s A");
?>

実行例

定義と用法

date() 関数はローカルの日付と時間をフォーマットし、フォーマットされた日付文字列を返します。

構文

date(format,timestamp);
パラメータ 説明
format

必要。出力する日付文字列のフォーマットを指定します。以下の文字を使用できます：

  • d - 1ヶ月の中の何日目（01 から 31）
  • D - 週のテキスト表示（3文字で表現）
  • j - 1ヶ月の中の何日目、先頭のゼロなし（1 から 31）
  • l（'L' の小文字）- 週の完全なテキスト表示
  • N - 週の ISO-8601 デジタルフォーマット表示（1 は Monday[月曜日]、7 は Sunday[日曜日]）
  • S - 1ヶ月の中の何日目の英語の序数接尾辞（2文字：st、nd、rd、th。j と組み合わせて使用）
  • w - 週の数字表示（0 は Sunday[日曜日]、6 は Saturday[土曜日]）
  • z - 一年の中の何日目であるか（0 から 365）
  • W - ISO-8601 デジタルフォーマットで一年の週の数字を表現（週は Monday[月曜日]から始まる）
  • F - 月の完全なテキスト表示（January[1月] から December[12月]）
  • m - 月の数字表示（01 から 12）
  • M - 月の短いテキスト表示（3文字で表現）
  • n - 月の数字表示、先頭のゼロなし（1 から 12）
  • t - 指定された月に含まれる日数
  • L - 闰年であるかどうか（闰年の場合は 1、そうでない場合は 0）
  • o - ISO-8601 標準の年份数字
  • Y - 年份的四位数表示
  • y - 年份的两位数表示
  • a - 小写形式表示：am 或 pm
  • A - 大文字で表示される：AM または PM
  • B - Swatch インターネット時間（000 から 999）
  • g - 12 時間制、先頭にゼロなし（1 から 12）
  • G - 24 時間制、先頭にゼロなし（0 から 23）
  • h - 12 時間制、先頭にゼロ（01 から 12）
  • H - 24 時間制、先頭にゼロ（00 から 23）
  • i - 分、先頭にゼロ（00 から 59）
  • s - 秒、先頭にゼロ（00 から 59）
  • u - 微秒（PHP 5.2.2 で追加）
  • e - タイムゾーンの識別子（例：UTC、GMT、Atlantic/Azores）
  • I（i の大文字形式）- 日期が夏時間であるかどうか（夏時間の場合は 1、そうでない場合は 0）
  • O - グリニッジ標準時（GMT）の差分、単位は時間（例：+0100）
  • P - グリニッジ標準時（GMT）の差分、単位は hours:minutes（PHP 5.1.3 で追加）
  • T - タイムゾーンの省略形（例：EST、MDT）
  • Z - 秒単位のタイムゾーンのオフセット。UTC の西時帯のオフセットは負の数（-43200 から 50400）
  • c - ISO-8601 標準の日期（例：2013-05-05T16:34:42+00:00）
  • r - RFC 2822 フォーマットの日期（例：金曜, 12 4月 2013 12:01:05 +0200）
  • U - Unix 紀元（1970年1月1日 00:00:00 GMT）から経過した秒数

同時に、以下のプレデファインドの定数も使用できます（PHP 5.1.0 から利用可能）：

  • DATE_ATOM - Atom（例：2013-04-12T15:52:01+00:00）
  • DATE_COOKIE - HTTP Cookies（例：Friday, 12-Apr-13 15:52:01 UTC）
  • DATE_ISO8601 - ISO-8601（例：2013-04-12T15:52:01+0000）
  • DATE_RFC822 - RFC 822（例：金曜, 12 4月 13 15:52:01 +0000）
  • DATE_RFC850 - RFC 850（例：Friday, 12-Apr-13 15:52:01 UTC）
  • DATE_RFC1036 - RFC 1036（例：金曜, 12 4月 13 15:52:01 +0000）
  • DATE_RFC1123 - RFC 1123（例：Fri, 12 Apr 2013 15:52:01 +0000）
  • DATE_RFC2822 - RFC 2822（Fri, 12 Apr 2013 15:52:01 +0000）
  • DATE_RFC3339 - DATE_ATOM と同じ（PHP 5.1.3から始まる）
  • DATE_RSS - RSS（Fri, 12 Aug 2013 15:52:01 +0000）
  • DATE_W3C - 万国連合（例：2013-04-12T15:52:01+00:00）
timestamp オプションです。整数の Unix タイムスタンプを指定します。デフォルトでは現在のローカル時間（time()）が使用されます。

技術的詳細

返り値： 成功した場合、フォーマットされた日付文字列を返し、失敗した場合、E_WARNING エラーを報告し FALSE を返します。
PHP バージョン： 4+
更新ログ：

PHP 5.1.0：E_STRICT と E_NOTICE 时区エラーが追加されました。有効な範囲のタイムスタンプは、1901年12月13日20:45:54 GMT 金曜日から2038年1月19日03:14:07 GMT 火曜日までです。5.1.0以前のバージョンでは、特定のシステム（例えば Windows）ではタイムスタンプが1970年1月1日から2038年1月19日までに制限されています。

PHP 5.1.1：標準的な日付/時間フォーマット定数が追加され、指定に使用されます。 format パラメータ。

PHP Date / Time関数