❮ 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の日付と時刻をフォーマットし、フォーマットされた日付文字列を返します。
構文
<div>gmdate(<em>format, timestamp)</em></div>
パラメータ値
|
パラメータ |
説明 |
| format |
Required 出力される日付文字列の形式を指定します。次の文字を使用できます。
- d - 月の日(01から31まで)
- D - 日のテキスト表現(3文字)
- j - 先頭ゼロなしの日付(1から31)
- l (小文字の 'L') - 1日の完全なテキスト表現
- N - 日のISO-8601 数値表現(月曜日は1、日曜日は7)
- S - 月の日の英語の序数サフィックス(st、nd、rd、またはthの2文字。jとの組み合わせで上手く機能します)
- w - 日の数値表現 (0は日曜日、6は土曜日)
- z - 年間通算日(0から365)
- W - 年のISO-8601 週番号(月曜日から始まる週)
- F - 月の完全なテキスト表現(1月から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インターネット時間(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)との差(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 Cookie(例: Friday, 12-Apr-13 15:52:01 UTC)
- DATE_ISO8601 - ISO-8601(例: 2013-04-12T15:52:01+0000)
- DATE_RFC822 - RFC 822(例: 2013 年 4 月 12 日金曜日 15:52:01 +0000)
- DATE_RFC850 - RFC 850(例: 2013 年 4 月 12 日金曜日 15:52:01 UTC)
- DATE_RFC1036 - RFC 1036(例: 2013 年 4 月 12 日金曜日 15:52:01 +0000)
- DATE_RFC1123 - RFC 1123(例: 2013 年 4 月 12 日金曜日 15:52:01 +0000)
- DATE_RFC2822 - RFC 2822(2013 年 4 月 12 日金曜日 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 - World Wide Web Consortium(例: 2013-04-12T15:52:01+00:00)
|
| timestamp |
Optional 整数のUnixタイムスタンプを指定します。デフォルトは現在の現地時間です(time()) |
Technical Details
| Return Value: |
成功するとフォーマットされた日付文字列を返します。失敗した場合はFALSE + E_WARNING |
|
PHP バージョン: |
4+ |
|
PHP 変更ログ: |
PHP 5.1:タイムスタンプの有効な範囲は、1901年12月13日金曜日 20:45:54 GMTから2038年1月19日火曜日03:14:07 GMT までです。バージョン 5.1より前のタイムスタンプは、一部のシステム(Windowsなど)で01-01-1970から19-01-2038に制限されていました。
PHP 5.1.1: 追加
formatパラメータで指定できる標準的なdate/timeフォーマットの定数を追加した |
❮ PHP date/timeリファレンス
