PHP gmdate() 関数
例
GMT/UTC の日付と時間をフォーマットし、フォーマットされた日付文字列を返します：
<?php
// 週の何日を出力
echo gmdate("l") . "<br>";
// 時間、週の何日、月、年、時間、午前または午後を出力
echo gmdate("l jS \of F Y h:i:s A");
?>
実行例
定義と使用法
gmdate() 関数は GMT/UTC の日付と時間をフォーマットし、フォーマットされた日付文字列を返します。
文法
gmdate(format,timestamp);
| パラメータ |
説明 |
| format |
必須。出力する日付文字列のフォーマットを定義します。以下の文字を使用できます：
- d - 1ヶ月の中の何日目（01 から 31）
- D - 週のテキスト表現（3文字で表現）
- j - 1ヶ月の中の何日目、先頭の 0 を含まない（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 - 月の数字表現、先頭の 0 を含まない（1 から 12）
- t - 指定された月に含まれる日数
- L - その年が閏年かどうか（閏年の場合は 1、そうでない場合は 0）
- ISO-8601 標準における年数値
- Y - 4桁の年表示
- y - 2桁の年表示
- 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形式の日期（例：Fri, 12 Apr 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（例：Fri, 12 Apr 13 15:52:01 +0000）
- DATE_RFC850 - RFC 850（例：Friday, 12-Apr-13 15:52:01 UTC）
- DATE_RFC1036 - RFC 1036（例：Fri, 12 Apr 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：有効なタイムスタンプの範囲は、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 パラメータ。
|
