「PHPの基礎 - 日時」の版間の差分

📢 Webサイト閉鎖と移転のお知らせ

このWebサイトは2026年9月に閉鎖いたします。

移転先はhttps://mochiu.net/index.php?title=PHPの基礎 - 日時です。

新しい記事は移転先で追加しております。（旧サイトでは記事を追加しておりません）

新しい編集 →

ビジュアルウィキテキスト

2021年3月4日 (木) 13:53時点における版

概要

PHPの組み込み関数において、日時に関する関数を記載する。

日時を取得する(time, date)

日時を指定するフォーマットを取得する。

string date(string format [, int timestamp])

引数で指定したフォーマットで日付文字列を取得する。
2番目の引数で、取得する日時を指定する。省略する場合は、現在の日時を取得する。

引数:
   format  日付のフォーマット
   timestamp  フォーマットの対象となる日時

戻り値:
   フォーマットされた日付文字列

フォーマットの対象となるタイムスタンプで指定可能な範囲は、Fri, 13 Dec 1901 20:45:54 GMTからTue, 19 Jan 2038 03:14:07 GMTまでとなっている。
省略する場合は、time関数で取得できる現在日時の値が対象となる。

下表に、指定可能なフォーマットの種類を示す。

フォーマット	意味	例
j	日(ゼロパディング無し)	1から31
d	日(ゼロパディング)	01から31
D	曜日(3文字のテキスト形式)	MonからSun
l	曜日(フルスペル形式)	SundayからSaturday
N	ISO-8601形式における曜日の数値表現	1(月曜日)から7(日曜日)
S	英語形式の序数を表すサフィックス(2文字)	st、nd、rdまたはth jと一緒に使用する
w	曜日。数値	0(日曜)から6(土曜)
W	ISO-8601形式における月曜日から始まる年単位の週番号(数値)	例: 42(1年の第42週目)
z	年間の通算日(ゼロから開始)	0から365

フォーマット	意味	例
m	月(ゼロパディング無し)	1から12
n	月(ゼロパディング)	01から12
M	月(3文字のテキスト形式)	JanからDec
F	月(フルスペル形式)	JanuaryからDecember
t	指定した月の日数	28から31

フォーマット	意味	例
y	年(2桁の数字)	例: 99、03、10
Y	年(4桁の数字)	例: 1999、2003、2010
o	ISO-8601形式の年 Yとほぼ同じであるが、ISO週番号(W)が前年あるいは翌年に属する場合がある点で異なる	例: 1999、2003、2010
L	閏年であるかどうかを表す論理値	1 : 閏年 0 : 閏年ではない

フォーマット	意味	例
s	秒(ゼロパディング)	00から59
i	分(ゼロパディング)	00から59
h	時(12時間単位、ゼロパディング)	01から12
H	時(24時間単位、ゼロパディング)	00から23
g	時(12時間単位、パディング無し)	1から12
G	時(24時間単位、パディング無し)	0から23
a	午前または午後(小文字)	amまたはpm
A	午前または午後(大文字)	AMまたはPM
B	スウォッチインターネット時間(Swatch)	000から999

フォーマット	意味	例
e	タイムゾーン識別子	例: UTC、GMT、Atlantic / Azores
l	サマータイム中かどうか	1 : サマータイム 0 : サマータイムではない
O	グリニッジ標準時(GMT)との時間差	例: +0900
T	サーバのタイムゾーンの設定	例: EST、MDT ...
Z	タイムゾーンのオフセット秒数 UTCの西側のタイムゾーン用のオフセットは常に負である。 UTCの東側のオフセットは常に正である。	-43200から43200

フォーマット	意味	例
c	ISO8601形式の日付	例: 2020-01-01T15:19:21+00:00
r	RFC822に基づく日付	例: Thu, 21 Jan 2020 16:01:07 +0200
U	Unix時(1970年1月1日0時0分0秒)からの秒数	--

例えば、2020年01月01日のような日付文字列を取得する場合は、date('Y年m月d日');と記述する。
このように、フォーマット文字列で定義されていない文字を記述する場合、単に文字列として表示する。

また、フォーマット文字列と同じ文字において、文字として表示する場合は、¥でエスケープする。

date('Y m d');      --> 2020 01 01
date('Y年m月d日');  --> 2020年01月01日
date('d day');      --> 01 01am20
date('d ¥d¥a¥y');   --> 01 day
date('c');

※注意
文字をエスケープした結果、ダブルクォーテーションで囲まれた文字列の中で特別な意味を持つ文字になることがある(例: ¥n等)
これを避けるには、¥¥nのように¥自身もエスケープする必要がある。

次に、第2引数であるタイムスタンプについても記載する。
第2引数を省略する場合は、初期値としてtime関数で取得できる現在時刻がフォーマットの対象となる。

int time(void)

現在時刻をUnix時刻(1970年1月1日 00:00:00 GMT)からの通算秒として返す。

引数:
   なし

戻り値:
   通算の秒を表す数値

Unix時刻とは、1970年1月1日 00:00:00を0として、1秒経過するごとに1ずつ増加させた値となる。
例えば、この値を使用して取得した値に+60した値は、現在より1分後の時間となる。

@@ 4行目: / 4行目: @@
 == 日時を取得する(time, date) ==
-日時を指定するフォーマットを取得する。
+日時を指定するフォーマットを取得する。<br>
   string date(string format [, int timestamp])
   引数で指定したフォーマットで日付文字列を取得する。
 番目の引数で、取得する日時を指定する。省略する場合は、現在の日時を取得する。
@@ 17行目: / 17行目: @@
      フォーマットされた日付文字列
 <br>
-フォーマットの対象となるタイムスタンプで指定可能な範囲は、Fri, 13 Dec 1901 20:45:54 GMTからTue, 19 Jan 2038 03:14:07 GMTまでとなっている。
+フォーマットの対象となるタイムスタンプで指定可能な範囲は、Fri, 13 Dec 1901 20:45:54 GMTからTue, 19 Jan 2038 03:14:07 GMTまでとなっている。<br>
-省略する場合は、time関数で取得できる現在日時の値が対象となる。
+省略する場合は、<code>time</code>関数で取得できる現在日時の値が対象となる。<br>
+<br>
-下表に、指定可能なフォーマットの種類を示す。
+下表に、指定可能なフォーマットの種類を示す。<br>
 <center>
 {| class="wikitable" style="background-color:#fefefe;"
@@ 66行目: / 66行目: @@
 |}
 </center>
+<br>
+<center>
+{| class="wikitable" style="background-color:#fefefe;"
+|-
+! style="background-color:#00ffff;" | フォーマット
+! style="background-color:#00ffff;" | 意味
+! style="background-color:#00ffff;" | 例
+|-
+| y || 年(2桁の数字) || 例: 99、03、10
+|-
+| Y || 年(4桁の数字) || 例: 1999、2003、2010
+|-
+| o || ISO-8601形式の年<br>Yとほぼ同じであるが、ISO週番号(W)が前年あるいは翌年に属する場合がある点で異なる || 例: 1999、2003、2010
+|-
+| L || 閏年であるかどうかを表す論理値 || 1 : 閏年<br>0 : 閏年ではない
+|}
+</center>
+<br>
+<center>
+{| class="wikitable" style="background-color:#fefefe;"
+|-
+! style="background-color:#00ffff;" | フォーマット
+! style="background-color:#00ffff;" | 意味
+! style="background-color:#00ffff;" | 例
+|-
+| s || 秒(ゼロパディング) || 00から59
+|-
+| i || 分(ゼロパディング) || 00から59
+|-
+| h || 時(12時間単位、ゼロパディング) || 01から12
+|-
+| H || 時(24時間単位、ゼロパディング) || 00から23
+|-
+| g || 時(12時間単位、パディング無し) || 1から12
+|-
+| G || 時(24時間単位、パディング無し) || 0から23
+|-
+| a || 午前または午後(小文字) || amまたはpm
+|-
+| A || 午前または午後(大文字) || AMまたはPM
+|-
+| B || [https://ja.wikipedia.org/wiki/%E3%82%B9%E3%82%A6%E3%82%A9%E3%83%83%E3%83%81%E3%83%BB%E3%82%A4%E3%83%B3%E3%82%BF%E3%83%BC%E3%83%8D%E3%83%83%E3%83%88%E3%82%BF%E3%82%A4%E3%83%A0 スウォッチインターネット時間(Swatch)] || 000から999
+|}
+</center>
+<br>
+<center>
+{| class="wikitable" style="background-color:#fefefe;"
+|-
+! style="background-color:#00ffff;" | フォーマット
+! style="background-color:#00ffff;" | 意味
+! style="background-color:#00ffff;" | 例
+|-
+| e || タイムゾーン識別子 || 例: UTC、GMT、Atlantic / Azores
+|-
+| l || サマータイム中かどうか || 1 : サマータイム<br>0 : サマータイムではない
+|-
+| O || グリニッジ標準時(GMT)との時間差 || 例: +0900
+|-
+| T || サーバのタイムゾーンの設定 || 例: EST、MDT ...
+|-
+| Z || タイムゾーンのオフセット秒数<br>UTCの西側のタイムゾーン用のオフセットは常に負である。<br>UTCの東側のオフセットは常に正である。 || -43200から43200
+|}
+</center>
+<br>
+<center>
+{| class="wikitable" style="background-color:#fefefe;"
+|-
+! style="background-color:#00ffff;" | フォーマット
+! style="background-color:#00ffff;" | 意味
+! style="background-color:#00ffff;" | 例
+|-
+| c || ISO8601形式の日付 || 例: 2020-01-01T15:19:21+00:00
+|-
+| r || RFC822に基づく日付 || 例: Thu, 21 Jan 2020 16:01:07 +0200
+|-
+| U || Unix時(1970年1月1日0時0分0秒)からの秒数 || --
+|}
+</center>
+<br>
+例えば、2020年01月01日のような日付文字列を取得する場合は、<code>date('Y年m月d日');</code>と記述する。<br>
+このように、フォーマット文字列で定義されていない文字を記述する場合、単に文字列として表示する。<br>
+<br>
+また、フォーマット文字列と同じ文字において、文字として表示する場合は、<code>¥</code>でエスケープする。<br>
+ date('Y m d');      --> 2020 01 01
+ date('Y年m月d日');  --> 2020年01月01日
+ date('d day');      --> 01 01am20
+ date('d ¥d¥a¥y');   --> 01 day
+ date('c');
+<br>
+<u>※注意</u><br>
+<u>文字をエスケープした結果、ダブルクォーテーションで囲まれた文字列の中で特別な意味を持つ文字になることがある(例: <code>¥n</code>等)</u><br>
+<u>これを避けるには、<code>¥¥n</code>のように¥自身もエスケープする必要がある。</u><br>
+<br>
+次に、第2引数であるタイムスタンプについても記載する。<br>
+第2引数を省略する場合は、初期値として<code>time</code>関数で取得できる現在時刻がフォーマットの対象となる。<br>
+ int time(void)
+ 現在時刻をUnix時刻(1970年1月1日 00:00:00 GMT)からの通算秒として返す。
+ 引数:
+    なし
+ 戻り値:
+    通算の秒を表す数値
+<br>
+Unix時刻とは、1970年1月1日 00:00:00を0として、1秒経過するごとに1ずつ増加させた値となる。<br>
+例えば、この値を使用して取得した値に+60した値は、現在より1分後の時間となる。<br>
 <br><br>
 __FORCETOC__
 [[カテゴリ:Web]]