PHPで使える日時の表現と、その知り方 #frontend_phpcon_do

フロントエンド・PHPカンファレンス北海道2026での発表資料です(LT)
https://fortee.jp/frontend-phpcon-do-2026/proposal/77172968-2ab4-419b-a9eb-95080beabd75

Transcript

1. PHPで使える日時の表現と、 その知り方 フロントエンド・PHPカンファレンス北海道2026 Hideki Kinjyo GitHub: o0h / X: @o0h_ [公開用] v1.2.1
2. <?php new \DateTimeImmutable( '2026-06-06 10:40:00' ); 
3. <?php new \DateTimeImmutable( '2026-06-06 10:40:00' );  指定日時の 日時オブジェクトを作れる
4. <?php new \DateTimeImmutable( '2026-06-06' );  日付だけでも良いし
5. <?php new \DateTimeImmutable( '10:40:00' );  時刻だけでもOK
6. <?php new \DateTimeImmutable( '@1780671600' );  "@"をつけてunixtimeもOK
7. キーワード指定にも 対応している 
8. <?php new \DateTimeImmutable( 'now' );  「現在日時」
9. <?php new \DateTimeImmutable( 'noon' );  「正午」
10. <?php new \DateTimeImmutable( 'June 6 JST' );  英語やら タイムゾーン指定やら
11. 相対表記も使える 
12. <?php new \DateTimeImmutable( '-3 days' );  「3日前」
13. <?php new \DateTimeImmutable( 'last Wed.' );  「直近の水曜日」
14. 色々と組み合わせることもできる 
15. <?php new \DateTimeImmutable( 'noon - 12 hours' );  「正午」の「12時間前」
16. <?php new \DateTimeImmutable( '+1year +2month +3day +4hour +5min +6sec' ); 
17. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' ); 
18. <?php new \DateTimeImmutable( 'I may wed.' ); 
19. <?php new \DateTimeImmutable( 'A cat sat.' ); 
20. 対応している表現が多い (大変) 
21. マニュアルを見てみよう (http://php.net/datetime.formats) 
22. 「サポートする日付と時刻の書式」 
23. 「サポートする日付と時刻の書式」  丁寧で充実した説明
24. 「サポートする日付と時刻の書式」  情報が盛り沢山🤤 (document.body.innerText.length // 15404)
25. 暗記が大変だ 
26. 暗記が大変だ 仕組みを知ろう 
27. LTタイトルを大発表！ 
28. 自己紹介 • 金城秀樹 / きんじょうひでき • GitHub: @o0h / 𝕏 : @o0h_ • アイコンは美味しい鮭親子丼の写真です • 東京でPHPを使っています • 最近はPodcastをやっています • ハッシュタグ: #readlinefm 
29. やること PHPのソースコードにある ext/date/lib/parse_date.re を開いてください 
30. PHPのソースコードにある ext/date/lib/parse_date.re を開いてください やること .re  re2cというツールの ファイル
31. re2c？ 正規表現でマッチした字句に Cの処理を適用する 
32. re2c？ 正規表現でマッチした字句に Cの処理を適用する 
33.  正規表現のパターン
34. /*!re2c year2 = [0-9]{2}; year4 = [0-9]{4}; */  正規表現のパターン
35. /*!re2c year2 = [0-9]{2}; year4 = [0-9]{4}; */  00 12 88
36. /*!re2c year2 = [0-9]{2}; year4 = [0-9]{4}; */  0001 2026 9999
37. /*!re2c monthlz = "0"[0-9]|"1"[0-2]; daylz = "0"[0-9]|[1-2][0-9]|"3"[01]; */  正規表現のパターン
38. /*!re2c monthlz = "0"[0-9]|"1"[0-2]; daylz = "0"[0-9]|[1-2][0-9]|"3"[01]; */  00 12 09 10 30 31
39. /*!re2c datenocolon = year4 monthlz daylz; */  定義したパターンを 再利用する
40. /*!re2c datenocolon = year4 monthlz daylz; */  21120903 20260606
41. re2c？ 正規表現でマッチした字句に Cの処理を適用する 
42.  Cの処理
43. datenocolon { s->time->y = timelib_get_nr(&ptr,4); s->time->m = timelib_get_nr(&ptr,2); s->time->d = timelib_get_nr(&ptr,2); }  大事な部分だけ 見てみる
44. datenocolon { s->time->y = timelib_get_nr(&ptr,4); s->time->m = timelib_get_nr(&ptr,2); s->time->d = timelib_get_nr(&ptr,2); }  ルール
45. datenocolon { s->time->y = timelib_get_nr(&ptr,4); s->time->m = timelib_get_nr(&ptr,2); s->time->d = timelib_get_nr(&ptr,2); }  アクション
46. datenocolon { s->time->y = timelib_get_nr(&ptr,4); s->time->m = timelib_get_nr(&ptr,2); s->time->d = timelib_get_nr(&ptr,2); }  数字だけ4文字抜き出す
47. datenocolon { s->time->y = timelib_get_nr(&ptr,4); s->time->m = timelib_get_nr(&ptr,2); s->time->d = timelib_get_nr(&ptr,2); }  「time」の「y」に入れる
48. datenocolon { s->time->y = timelib_get_nr(&ptr,4); s->time->m = timelib_get_nr(&ptr,2); s->time->d = timelib_get_nr(&ptr,2); }  「time」の「m」に 「次の数字2文字」を入れる
49. datenocolon { s->time->y = timelib_get_nr(&ptr,4); s->time->m = timelib_get_nr(&ptr,2); s->time->d = timelib_get_nr(&ptr,2); }  「time」の「d」に 「次の数字2文字」を入れる
50. parse_date.reがやっていること  つまり、PHPは 「文字を解釈して日時にする」ために
51. parse_date.reがやっていること  1. 字句パターンを定義して 2. それに対応する「アクション」内で 3. `time`の中身をいじっている
52. 色々な例を見て見る 
53. 例1: 単純なやつ 
54. <?php new \DateTimeImmutable( 'noon' ); 
55. 'noon' { DEBUG_OUTPUT("noon"); TIMELIB_INIT; TIMELIB_UNHAVE_TIME(); TIMELIB_HAVE_TIME(); s->time->h = 12; TIMELIB_DEINIT; return TIMELIB_RELATIVE; } 
56. 'noon' { DEBUG_OUTPUT("noon"); TIMELIB_INIT; TIMELIB_UNHAVE_TIME(); TIMELIB_HAVE_TIME(); s->time->h = 12; TIMELIB_DEINIT; return TIMELIB_RELATIVE; }  'noon'
57. 'noon' { DEBUG_OUTPUT("noon"); TIMELIB_INIT; TIMELIB_UNHAVE_TIME(); TIMELIB_HAVE_TIME(); s->time->h = 12; TIMELIB_DEINIT; return TIMELIB_RELATIVE; }  s->time->h = 12;
58. <?php new \DateTimeImmutable( 'June' ); 
59. monthfull = 'january'|'february'| 'march'|'april'|'may'| 'june'|'july'|'august'| 'september'|'october'| 'november'|'december'; 
60. monthfull | monthabbr { DEBUG_OUTPUT("monthtext"); TIMELIB_INIT; TIMELIB_HAVE_DATE(); s->time->m = timelib_lookup_month(&ptr); TIMELIB_DEINIT; return TIMELIB_DATE_TEXT; }  s->time->m = timelib_lookup_month(&ptr); mouthfull
61. <?php new \DateTimeImmutable( 'June 6th' ); 
62. monthtext = monthfull| monthabbr| monthroman; 
63. datenoyear = monthtext ([ .\t-])* day ([,.stndrh\t ]+|[\000]); 
64. datetextual | datenoyear { int length = 0; DEBUG_OUTPUT("datetextual | datenoyear"); TIMELIB_INIT; TIMELIB_HAVE_DATE(); s->time->m = timelib_get_month(&ptr); s->time->d = timelib_get_nr(&ptr, 2); s->time->y = timelib_get_nr_ex(&ptr, 4, &length); TIMELIB_PROCESS_YEAR(s->time->y, length); TIMELIB_DEINIT; return TIMELIB_DATE_TEXT; } 
65. datetextual | datenoyear { int length = 0; DEBUG_OUTPUT("datetextual | datenoyear"); TIMELIB_INIT; TIMELIB_HAVE_DATE(); s->time->m = timelib_get_month(&ptr); s->time->d = timelib_get_nr(&ptr, 2); s->time->y = timelib_get_nr_ex(&ptr, 4, &length); TIMELIB_PROCESS_YEAR(s->time->y, length); TIMELIB_DEINIT; return TIMELIB_DATE_TEXT; }  datenoyear s->time->m = ... s->time->d = ...
66. <?php new \DateTimeImmutable( 'VI 6' );  コレでも同じ結果になる (datenoyearが適用される)
67. <?php new \DateTimeImmutable( 'now' ); 
68. 'now' { DEBUG_OUTPUT("now"); TIMELIB_INIT; TIMELIB_DEINIT; return TIMELIB_RELATIVE; }  何も値をいじらない = 現在日時のまま
69. 例2: 相対指定 
70. <?php new \DateTimeImmutable( 'yesterday' ); 
71. 'yesterday' { DEBUG_OUTPUT("yesterday"); TIMELIB_INIT; TIMELIB_HAVE_RELATIVE(); TIMELIB_UNHAVE_TIME(); s->time->relative.d = -1; TIMELIB_DEINIT; return TIMELIB_RELATIVE; }  ※ 画面上の都合で、内容を一部改修しています
72. 'yesterday' { DEBUG_OUTPUT("yesterday"); TIMELIB_INIT; TIMELIB_HAVE_RELATIVE(); TIMELIB_UNHAVE_TIME(); s->time->relative.d = -1; TIMELIB_DEINIT; return TIMELIB_RELATIVE; }  s->time->relative.d = -1; 'yesterday' ※ 画面上の都合で、内容を一部改修しています
73. <?php new \DateTimeImmutable( '+1year +2month +3day +4hour +5min +6sec' ); 
74. relative = relnumber reltextunit; 
75. reltextunit = 'ms' | 'µs' | (('msec'|'millisecond'|'µsec'|'mi crosecond'|'usec'|'sec'|'second'| 'min'|'minute'|'hour'|'day'|'fort night'|'forthnight'|'month'|'year ') 's'?) | 'weeks' | daytext; 
76. <?php new \DateTimeImmutable( '+1year +2month +3day +4hour +5min +6sec' );  s->time->relative.y += 1;
77. <?php new \DateTimeImmutable( '+1year +2month +3day +4hour +5min +6sec' );  s->time->relative.m += 2;
78. <?php new \DateTimeImmutable( '+1year +2month +3day +4hour +5min +6sec' );  s->time->relative.d += 3;
79. <?php new \DateTimeImmutable( '+1year +2month +3day +4hour +5min +6sec' );  s->time->relative.h += 4;
80. <?php new \DateTimeImmutable( '+1year +2month +3day +4hour +5min +6sec' );  s->time->relative.i += 5;
81. <?php new \DateTimeImmutable( '+1year +2month +3day +4hour +5min +6sec' );  s->time->relative.s += 6;
82. 例3: 細かくて分かりにくいやつ 
83. <?php new \DateTimeImmutable( 'June 6th' );  datenoyear => 6月6日の0時0分0秒
84. <?php new \DateTimeImmutable( 'June sixth day' ); 
85. <?php new \DateTimeImmutable( 'June sixth day' );  monthfull: s->time->m = 6
86. <?php new \DateTimeImmutable( 'June sixth day' );  reltextnumber
87. <?php new \DateTimeImmutable( 'June sixth day' );  reltextunit
88. <?php new \DateTimeImmutable( 'June sixth day' );  relativetext: s->time->relative.d += 6;
89. 例4: 複雑なやつ 
90. <?php new \DateTimeImmutable( 'A cat sat.' ); 
91. <?php new \DateTimeImmutable( 'A cat sat.' );  タイムゾーン (アルファ時間帯)
92. <?php new \DateTimeImmutable( 'A cat sat.' );  タイムゾーン (中央アフリカ時間) ※ 2つめのタイムゾーン指定は無視される
93. <?php new \DateTimeImmutable( 'A cat sat.' );  土曜日
94. <?php new \DateTimeImmutable( 'I may wed.' ); 
95. <?php new \DateTimeImmutable( 'I may wed.' );  タイムゾーン(インディア時間帯) 5月 水曜日
96. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' ); 
97. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' );  7月の第3月曜日
98. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' );  10時の15分後 = 10:15:00
99. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' );  s->time->relative.d += 3
100. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' );  relativeに持っている値の ＋ーを反転
101. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' );  s->time->relative.h += 99
102. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' );  何もしない
103. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' );  何もしない
104. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' );  s->time->relative.i += 3
105. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' );  s->time->y = 2021
106. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' );  s->time->relative.d += (-1 * 7) s->time->relative.weekday = 1;
107. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' );  s->time->z = 18.00 * 60 * 60
108. <?php new \DateTimeImmutable( 'third mon of june back of 10 -3days ago 99 hour now now 3min 2021 previous week +1800' );  2021-05-15 13:18:00.0 +18:00
109. まとめ 
110. 今、PHPの日時について 完全に理解しかけている 状態です 
111. ① 指定した数字やフレーズが 
112. ② 日時を構成する「どれかの要素」に 
113. ③ 絶対値 もしくは 相対値 をセットして 
114. ④ それらの値を、丸っと処理して 日時の出来上がり！ 
115. 困ったら parse_date.re 
116. という話をしました 〜めでたし めでたし〜 
117. マニュアルを見ても、 「複雑すぎて分からん」 「組み合わせるとどうなるの」 になる場合でも 
118. 実装を見ると 「仕組み」が見えてきて 便利 
119. だとしても 
120. 標準的な表現を使って欲しいと思いました (YYYY-MM-DDとか) 
121. おしまい！ お付き合いいただき ありがとうございました!!