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

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. おしまい！ お付き合いいただき ありがとうございました!!