指定された引数 timestamp を、与えられた フォーマット文字列によりフォーマットし、日付文字列を返します。 タイムスタンプが与えられない場合は、現在のローカル時刻が使われま す。つまり、timestampはオプションであり そのデフォルト値はtime()の値です。
注意: 有効なタイムスタンプの範囲は通常 Fri, 13 Dec 1901 20:45:54 GMTからTue, 19 Jan 2038 03:14:07 GMTまでです。 (これらの日付は、32ビット符号付き整数の最小および最大値に対応し ます。) Windowsではこの範囲は1970年1月1日から2038年1月19日GMTに制限されます。
注意: 日付の文字列表現からタイムスタンプを生成するには、 strtotime()を使用できる可能性があります。加 えて、いくつかのデータベースは、(MySQLの UNIX_TIMESTAMP 関数の ような)日付フォーマットからタイムスタンプに変換する関数を有しています。
表 1. 以下の文字はformatパラメータ文字列として認識されます
format character | 説明 | 戻り値の例 |
---|---|---|
a | 午前または午後(小文字) | am または pm |
A | 午前または午後(大文字) | AM または PM |
B | Swatch インターネット時間 | 000 から 999 |
d | 日。二桁の数字(先頭にゼロがつく場合も) | 01 から 31 |
D | 曜日。3文字のテキスト形式。 | Mon から Sun |
F | 月。フルスペルの文字。 | January から December |
g | 時。12時間単位。先頭にゼロを付けない。 | 1 から 12 |
G | 時。24時間単位。先頭にゼロを付けない。 | 0 から 23 |
h | 時。数字。12 時間単位。 | 01 から 12 |
H | 時。数字。24 時間単位。 | 00 から 23 |
i | 分。先頭にゼロをつける。 | 00 to 59 |
I (大文字の i) | サマータイム中か否か | 1ならサマータイム中。 0ならそうではない。 |
j | 日。先頭にゼロをつけない。 | 1 から 31 |
l (小文字の 'L') | 曜日。フルスペル形式。 | Sunday から Saturday |
L | 閏年であるかどうかを表す論理値。 | 1なら閏年。0なら閏年ではない。 |
m | 月。数字。先頭にゼロをつける。 | 01 から 12 |
M | 月。3文字形式。 | Jan から Dec |
n | 月。数字。先頭にゼロをつけない。 | 1 から 12 |
O | グリニッジ標準時(GMT)との時間差 | Example: +0200 |
r | RFC 822 フォーマットされた日付 | 例: Thu, 21 Dec 2000 16:01:07 +0200 |
s | 秒。先頭にゼロをつける。 | 00 から 59 |
S | 英語形式の序数を表すサフィックス。2 文字。 | st, nd, rd または th。 jと一緒に使用する ことができる。 |
t | 指定した月の日数。 | 28 から 31 |
T | このマシーンのタイムゾーンの設定。 | 例: EST, MDT ... |
U | Unix 時(1970年1月1日0時0分0秒)からの秒数 | time()も参照 |
w | 曜日。数値。 | 0 (日曜)から 6 (土曜) |
W | ISO-8601 月曜日に始まる年単位の週番号 (PHP 4.1.0で追加) | 例: 42 (1年の第42週目) |
Y | 年。4 桁の数字。 | 例: 1999または2003 |
y | 年。2 桁の数字。 | 例: 99 または 03 |
z | 年間の通算日。数字。 | 0 から 366 |
Z | タイムゾーンのオフセット秒数。 UTCの西側のタイムゾーン用のオフセットは常に負です。そして、 UTCの東側のオフセットは常に正です。 | -43200 から 43200 |
フォーマット文字列中の認識されない文字は、そのまま表示されます。 Z形式は、 gmdate()で使用した場合、常に"0"を返します。
You can prevent a recognized character in the format string from being expanded by escaping it with a preceding backslash. If the character with a backslash is already a special sequence, you may need to also escape the backslash.
前にバックスラッシュを付けてエスケープすることにより、フォーマッ ト文字列として認識される文字が展開されることを防止することができ ます。バックスラッシュ付きの文字は既に特別なシーケンスであり、バッ クスラッシュもエスケープすることが必要となる可能性があります。
date() と mktime() の 両方を用いて未来または過去の日付を知ることができます。
例 4. date()とmktime()の例
|
注意: サマータイムがあるため日付や月の秒数を単純にタイムスタンプに可 減算するよりもより信頼性があります。
date() フォーマットのいくつかの例を示します。 現在の実装で特別な意味がある文字や今後のPHPのバージョンで意味が割 り付けられるであろう文字については、望ましくない結果を避けるため にエスケープする必要があることに注意してください。エスケープをする 際には、改行文字 \n のような文字を回避するためにシングルークオー トを使用してください。
他の言語で日付をフォーマットするためには、 setlocale() および strftime() 関数を使用する必要があります。
getlastmod(), gmdate(), mktime(), strftime(), time()も参照ください。