PHP gmdate()関数
PHP Date/Time リファレンスマニュアル
例
GMT/UTC の日付と時刻をフォーマットし、フォーマットされた日付文字列を返します:
<?php
// Prints the day
echo gmdate("l") . "<br>";
// Prints the day,
date, month, year, time, AM or PM
echo gmdate("l jS of F Y h:i:s A");
?>
例を実行 »
定義と使い方
gmdate() 関数は GMT/UTC の日付と時刻をフォーマットし、フォーマットされた日付文字列を返します。
構文
gmdate(format,timestamp);
| パラメータ |
説明 |
| format |
必須。出力する日付文字列の形式を指定します。次の文字を使用できます:
- d - 月内の日(01 から 31)
- D - 曜日のテキスト表記(3文字)
- j - 月内の日、先頭のゼロなし(1 から 31)
- l('L' の小文字)- 曜日の完全なテキスト表記
- N - ISO-8601 形式の曜日数値(1 は Monday[月曜日]、7 は Sunday[日曜日])
- S - 月内の日の英語の序数接尾辞(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 - 年の4桁表記
- y - 年の2桁表記
- a - 小文字表記:am または pm
- A - 大文字表記:AM または PM
- B - Swatch Internet Time(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 エポック(January 1 1970 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 など)では、タイムスタンプは 01-01-1970 から 19-01-2038 までに制限されていました。 PHP 5.1.1:format パラメータを指定するための標準の日付/時刻形式定数が追加されました。 |
PHP Date/Time リファレンスマニュアル その他の拡張