タイムゾーンの奥地は思ったよりも闇深いかもしれない

タイムゾーンの奥地は思ったよりも闇深いかもしれない 2025-04-12 スー | PHP Conference Odawara 2025 1

所属株式会社TechBowl 何やってる？「TechTrain」というサービスで反復横跳びし続けている何でも屋さん(Laravel, Next.js, AWS, etc...) 2025-04-12 スー
| PHP Conference Odawara 2025 2

本題に入っていく前に・・・ 2025-04-12 スー | PHP Conference Odawara 2025 3

Q. そもそもタイムゾーンってそんなに大事・・・？ 2025-04-12 スー | PHP Conference Odawara 2025 4

A. 大事ですよ！ 2025-04-12 スー | PHP Conference Odawara 2025 5

雰囲気実装を少し抜け出そう！RFCからPHPの実装までを考えるタイムゾーンとサマータイム！！！ 2025-04-12 スー | PHP Conference Odawara 2025 6

他に例えばですが 2025-04-12 スー | PHP Conference Odawara 2025 7

面談マッチングして面談するようなサービスサービス特性だけではないトラブルもおきます 2025-04-12 スー | PHP Conference Odawara 2025 8

SSL証明書が有効ではなくなる可能性です (一撃がデカすぎる) 2025-04-12 スー | PHP Conference Odawara 2025 9

どうです？聴きたくなったのではないでしょうか・・・？ (ガクブル) 2025-04-12 スー | PHP Conference Odawara 2025
10

そのほかありそうなこと「ログの時刻がズレてる？該当ログがないんだけど・・・」「海外ユーザー向け機能で決済の日時がおかしい？」「なんかセッションが切れるログインがある」 2025-04-12 スー | PHP Conference Odawara
2025 11

今日のゴールタイムゾーンとは？時刻同期がそもそもどういうプロトコルの元動いているのかを知る OSごとのタイムゾーン管理の違いがどうなっているのか？タイムゾーンデータ更新の重要性を知る 2025-04-12 スー | PHP Conference
Odawara 2025 12

タイムゾーンの基本を復習 2025-04-12 スー | PHP Conference Odawara 2025 13

2025-04-12 スー | PHP Conference Odawara 2025 14

タイムゾーンはどう決まるのか？地球を24の区域に分割（経度15度ごと）国や地域の政治的決定が影響夏時間の採用も政治的決定によるもの IANAタイムゾーンデータベースで管理 2025-04-12 スー | PHP Conference
Odawara 2025 15

IANAタイムゾーンデータベースって何？タイムゾーンの正式なデータベース「Asia/Tokyo」「Europe/Paris」などの地域ベースの識別子歴史的な変更も含む年に数回更新される ← テストに出ます 2025-04-12 スー |
PHP Conference Odawara 2025 16

変更の例を試しに出すと 2025-04-12 スー | PHP Conference Odawara 2025 17

Q.その変更をどういう形式でどう管理しているんだっけ？ 2025-04-12 スー | PHP Conference Odawara 2025 19

OSごとにはどういう形式？データフォーマット: Linux/macOS: 標準的なtzfileフォーマット Windows: 独自形式（Time Zone Information Registry Format）
識別子の違い: Linux/macOS: "Asia/Tokyo" (IANA形式) Windows: "Tokyo Standard Time" (Windows独自形式) 2025-04-12 スー | PHP Conference Odawara 2025 21

OSごとにどこにあるのか？ 2025-04-12 スー | PHP Conference Odawara 2025 22

Linux /usr/share/zoneinfo/ ディレクトリにデータ /etc/localtime へのシンボリックリンクで設定 tzdata パッケージで更新 # タイムゾーン設定確認 ls
-la /etc/localtime # タイムゾーン設定変更 sudo timedatectl set-timezone Asia/Tokyo 2025-04-12 スー | PHP Conference Odawara 2025 23

Windows レジストリで管理 Windowsアップデートで更新 NTPサーバーとの同期 # PowerShellでタイムゾーン確認 Get-TimeZone # タイムゾーン変更 Set-TimeZone
-Id "Tokyo Standard Time" 2025-04-12 スー | PHP Conference Odawara 2025 24

macOS /usr/share/zoneinfo/ ディレクトリ（Linuxと類似）システム環境設定からも変更可能 OSアップデートで更新 # タイムゾーン確認 sudo systemsetup -gettimezone
# タイムゾーン変更 sudo systemsetup -settimezone Asia/Tokyo 2025-04-12 スー | PHP Conference Odawara 2025 25

Q. IANAの形式にWindows従ってるんですか？ 2025-04-12 スー | PHP Conference Odawara 2025 26

Q. 当然従ってくれてますよね！？！？！？！？ 2025-04-12 スー | PHP Conference Odawara 2025 27

Q. ね！？！？！？！？！？！？！？！？ 2025-04-12 スー | PHP Conference Odawara 2025 28

A. いいえ。独自形式があります。 2025-04-12 スー | PHP Conference Odawara 2025 29

たくさんの方が変換に倒れており Windowsの方がいらっしゃいましたら、注意が必要 2025-04-12 スー | PHP Conference Odawara 2025 31

タイムゾーンの情報ってどういうルールで日時を同期してるの？ 2025-04-12 スー | PHP Conference Odawara 2025 32

時刻情報の同期とNTP Network Time Protocol (NTP)は時刻同期の標準プロトコル階層化されたサーバー群（ストラタム）で構成インターネット上の原子時計と同期ミリ秒単位の精度で時刻を同期 2025-04-12 スー

NTPサーバーの階層ストラタム0: 原子時計・GPS ストラタム1: 直接接続するサーバーストラタム2: ストラタム1に接続するサーバー一般的にはストラタム3〜4を利用 2025-04-12
スー | PHP Conference Odawara 2025 34

NTPにおける大問題 - 2036年問題 1900年1月1日 0時0分0秒 (UTC)を起点とする「何秒たったか」を積算する32ビットの積算秒数で表現する「およそ2の32乗秒」までしか計算ができないため、42億9496万7295秒までしか表現ができず、起点から42億9496万7295秒経過 2036年2月7日
6時28分15秒 (UTC) の次の秒、2036年2月7日 6時28分16秒には桁あふれを起こす「新たな起点になった」とリセットされてしまい、NTPが誤動作すると予想する 2025-04-12 スー | PHP Conference Odawara 2025 35

2036年問題の対策 1. NTPサーバが送信するデータを64ビット整数にする → 扱う西暦3000億年使える 2. 受信側でうまくやる → オーバーフローしたら、受け手側で未来の時間として扱う

システムレベルの2036年問題の対策 NTPデーモン（ntpd, chronyd）を最新バージョンに保つ NTPv4（64ビット対応）を使用するサーバーを参照する設定に更新 2025-04-12 スー | PHP Conference Odawara
2025 37

PHPアプリケーションでの2036年問題の対策 PHPは内部的に64ビットタイムスタンプを使用しているが、OSの時計に依存重要なシステムでは必要な場合は、外部タイムサーバーと直接比較する仕組みを実装時刻に依存する重要処理では絶対時間を使用し、許容範囲を設定する 2025-04-12 スー | PHP Conference
Odawara 2025 38

NTPに従っているシステムはどのタイミングで同期してる？ 2025-04-12 スー | PHP Conference Odawara 2025 39

日時同期のタイミング Linux: ntpdやchronydサービスで常時または定期的に同期 Windows: デフォルトで週に1回、手動設定で変更可能 macOS: 起動時と定期的（デフォルトでは1時間ごと）に同期 PHPはOSの時計に依存するため、OSの同期設定が重要 2025-04-12 スー

コンテナ環境での時刻同期 Dockerコンテナは通常ホストマシンの時刻を継承 Kubernetesでは各ノードがNTP同期を担当コンテナ内でのntpdの実行は一般的に非推奨タイムスタンプの精度に依存するアプリでは注意が必要 2025-04-12 スー | PHP Conference
Odawara 2025 41

NTP設定と確認方法 # Linuxで現在のNTP状態確認 timedatectl status # NTPサーバーリストの確認（Linux, macOS） cat /etc/ntp.conf
# server time.asia.apple.com ← macOSの場合 # Windowsで同期設定確認 w32tm /query /status # 手動での時刻同期（Linux） sudo ntpdate pool.ntp.org とこんなふうに確認できます！ぜひお手元でmacOSの部分を試してみてください！ 2025-04-12 スー | PHP Conference Odawara 2025 42

ここからは時刻同期のトラブルシューティングの話そもそも触る人ー？ 2025-04-12 スー | PHP Conference Odawara 2025
43

いなければスキップ 2025-04-12 スー | PHP Conference Odawara 2025 44

時刻同期の問題とトラブルシューティング NTPサーバーへの接続失敗ファイアウォールによるNTPポート（UDP 123）のブロック大幅な時刻ずれによる段階的補正仮想環境特有の時刻ドリフト問題 2025-04-12 スー | PHP
Conference Odawara 2025 45

同期エラーの検出方法 # Linuxでのログ確認 journalctl -u systemd-timesyncd grep -i ntp /var/log/syslog
# Windowsでの診断 w32tm /query /status w32tm /stripchart /computer:pool.ntp.org /samples:5 # ntpstatコマンド（要インストール） ntpstat ntpq -p 2025-04-12 スー | PHP Conference Odawara 2025 46

同期エラーの判定基準接続状態: NTPサーバーに到達できない No server suitable for synchronization found Stratum値が16（同期未確立）
僕は本番で出会ったことはないので、もし戦士の方がいらっしゃいましたら教えてください 2025-04-12 スー | PHP Conference Odawara 2025 47

同期エラーの判定基準時刻ずれ: オフセット値が大きすぎる一般的に100ms以上は要注意ミッションクリティカルシステムでは10ms以上で警告 2025-04-12 スー | PHP Conference
Odawara 2025 48

同期エラーの判定基準同期状態フラグ: unsynchronised または unreachable w32tm /query /status で同期状態が unsynchronized
ntpstat で "unsynchronised" と表示高いjitter値: 時刻値の揺らぎが大きい通常は数msが正常、100ms以上で問題の可能性 2025-04-12 スー | PHP Conference Odawara 2025 49

スキップはここまで！ 2025-04-12 スー | PHP Conference Odawara 2025 50

ここまでで話したことタイムゾーンのルールの話日時同期の話(NTP) [optional] 日時同期エラーのトラブルシューティング 2025-04-12 スー | PHP Conference
Odawara 2025 51

ここからいよいよタイムゾーンのファイルの中身の話 2025-04-12 スー | PHP Conference Odawara 2025 52

タイムゾーンファイルの実体次の3つからなります tzfile形式ヘッダー構造データセクション 2025-04-12 スー | PHP Conference
Odawara 2025 53

タイムゾーンファイルの実体 tzfile形式バイナリ形式でタイムゾーン情報を格納 /usr/share/zoneinfo/ 以下の各ファイル 2025-04-12 スー | PHP Conference
Odawara 2025 54

タイムゾーンファイルの実体ヘッダー構造マジックナンバー "TZif" バージョン識別子 (v1, v2, v3) 64ビットタイムスタンプ対応（v2以降） 2025-04-12

タイムゾーンファイルの実体データセクション移行時間 (transition times) タイプインデックス (indices) タイプテーブル (types with
UTC offsets) 略称文字列 (abbreviation strings) うるう秒情報 (leap seconds) 2025-04-12 スー | PHP Conference Odawara 2025 56

tzfileの中身を見る # hexdumpでバイナリ内容を確認 hexdump -C /usr/share/zoneinfo/Asia/Tokyo # zdumpでタイムゾーンの移行時間を確認 zdump -v
/usr/share/zoneinfo/Asia/Tokyo | head # PHPでタイムゾーン情報を詳細表示 php -r 'print_r((new DateTimeZone("Asia/Tokyo"))->getTransitions());' 2025-04-12 スー | PHP Conference Odawara 2025 58

PHPにおけるタイムゾーンの内部実装 TimeZoneクラス: C言語実装の timelib_tzinfo 構造体をラップ OS依存のTZデータベースをパースタイムゾーンキャッシュ: パフォーマンス向上のためメモリ内キャッシュを使用 date.timezone_cache の影響（php.ini設定）
データの取得元: デフォルト: システムの /usr/share/zoneinfo PHP組み込みのデータ（ timezonedb.h ）拡張モジュール（ timezonedb ）からの上書き 2025-04-12 スー | PHP Conference Odawara 2025 59

PHP内部でのタイムゾーン処理フロー 1. 文字列識別子からの解決: $tz = new DateTimeZone('Asia/Tokyo'); → 内部で timelib_fetch_timezone_offset()
呼び出し 2. タイムスタンプの変換: $dt = new DateTime('2025-03-23 14:00:00', $tz); → timelib_get_time_zone_info() で特定時刻のオフセット計算 3. タイムゾーンプロパティの取得: $transitions = $tz->getTransitions(); 2025-04-12 スー | PHP Conference Odawara 2025 60

PHP-src: タイムゾーン実装の実態 ext/date/lib/timelib.h での定義: /* タイムゾーン情報を格納する構造体 */ typedef struct _timelib_tzinfo
{ char *name; /* タイムゾーン名 */ struct { uint32_t ttisgmtcnt; /* UTC/標準フラグの数 */ uint32_t ttisstdcnt; /* 標準/夏時間フラグの数 */ uint32_t leapcnt; /* うるう秒情報の数 */ uint32_t timecnt; /* 移行時間の数 */ uint32_t typecnt; /* タイプの数 */ uint32_t charcnt; /* 略称の文字数 */ } bit32; /* ... 移行時間やタイプデータへのポインタなど ... */ } timelib_tzinfo; 2025-04-12 スー | PHP Conference Odawara 2025 61

タイムゾーン情報の読み込み ext/date/lib/parse_tz.c から読み込み処理: /* タイムゾーンファイルを解析する関数 */ timelib_tzinfo *timelib_parse_tzfile( char *timezone,
const timelib_tzdb *tzdb) { /* ... */ /* tzfileからデータを読み込み */ if (memcmp(buffer, "TZif", 4) == 0) { /* マジックナンバーの検証 */ version = *(buffer + 4); /* ... */ /* 移行時間の読み込み */ for (i = 0; i < header->timecnt; i++) { /* ... タイムスタンプとタイプインデックスの解析 ... */ } } /* ... */ } 2025-04-12 スー | PHP Conference Odawara 2025 62

php-src: DateTimeZone実装 ext/date/php_date.c からのPHPクラスインターフェース: /* DateTimeZoneクラスのメソッドテーブル */ static const zend_function_entry
date_timezone_methods[] = { PHP_ME(DateTimeZone, __construct, arginfo_timezone_construct, ZEND_ACC_PUBLIC) PHP_ME(DateTimeZone, getName, arginfo_timezone_void, ZEND_ACC_PUBLIC) PHP_ME(DateTimeZone, getOffset, arginfo_timezone_getoffset, ZEND_ACC_PUBLIC) PHP_ME(DateTimeZone, getTransitions, arginfo_timezone_gettransitions, ZEND_ACC_PUBLIC) /* ... */ }; /* getTransitionsメソッドの実装 */ PHP_METHOD(DateTimeZone, getTransitions) { /* ... */ /* タイムゾーン情報からすべての移行情報を取得 */ for (i = 0; i < tz->timecnt; i++) { /* 各移行時間を配列として返す */ array_init(&element); add_assoc_long(&element, "ts", tz->trans[i]); add_assoc_string(&element, "time", timelib_time_to_string(dummy)); /* ... */ 2025-04-12 スー | PHP Conference Odawara 2025 63

date.timezone設定の解決順序 ini/php.ini-development の設定 [Date] ; タイムゾーン定義 ; http://php.net/date.timezone ;date.timezone =

date.timezone設定の解決順序 ext/date/php_date.c での解決順序: /* タイムゾーン設定の取得ロジック */ static timelib_tzinfo *get_timezone_info(void) {
/* 1. システムのタイムゾーン環境変数 */ if ((env = getenv("TZ")) != NULL) { /* ... */ } /* 2. php.ini設定 */ if (DATEG(default_timezone) && *DATEG(default_timezone)) { /* ... */ } /* 3. PHPが推測したタイムゾーン */ if (!found_guess) { /* ... */ php_error_docref(NULL, E_WARNING, "date.timezone設定がありません。システムから自動検出が必要です。"); } 2025-04-12 スー | PHP Conference Odawara 2025 65

php-srcを追うのはここまで・・・！ 2025-04-12 スー | PHP Conference Odawara 2025 66

タイムゾーン取り扱いの推奨される方法: php.ini で date.timezone を適切に設定する: サーバー環境全体で一貫したデフォルトタイムゾーンを提供します。 DateTime および DateTimeZone
オブジェクトを使用する: 特定のタイムゾーンで日時を扱いたい場合、これらのオブジェクトを使うことで、デフォルト設定に依存せず、より明確かつ柔軟にタイムゾーンを管理できます。 2025-04-12 スー | PHP Conference Odawara 2025 67

あとは UTC 2025-04-12 スー | PHP Conference Odawara 2025 68

タイムゾーンのおすすめの取り扱いはわかったけど、トラブルの時のデバッグどうすんの？ (特にコンテナ環境) 2025-04-12 スー | PHP Conference Odawara 2025
69

コンテナ環境での時刻確認アプリケーションレベルでの確認 PHPのログに時刻情報を出力 error_log('Current time: ' . date('Y-m-d H:i:s.u T'));
ヘルスチェックエンドポイントに時刻情報を追加 2025-04-12 スー | PHP Conference Odawara 2025 70

コンテナ環境での時刻確認 CloudWatch Logs Insights での分析複数コンテナのログから時刻パターンを抽出 filter @message like /Current
time:/ | parse @message "Current time: * " as timestamp | display timestamp ※ 出力形式によって上記のようなクエリでできるという例 2025-04-12 スー | PHP Conference Odawara 2025 71

コンテナ環境での時刻確認 ECS Exec（AWS CLI）の活用 aws ecs execute-command --cluster your-cluster \
--task your-task-id \ --container your-container \ --command "date" \ --interactive 2025-04-12 スー | PHP Conference Odawara 2025 72

DBとアプリケーションサーバーの時刻差確認 -- DBサーバーとアプリケーションサーバーの時刻差を秒単位で計算 SELECT TIMESTAMPDIFF( SECOND, FROM_UNIXTIME(?), -- PHPのtime()値をパラメータとして渡して実行 NOW()
) AS time_diff; 2025-04-12 スー | PHP Conference Odawara 2025 73

分散システムの時刻同期診断サーバー間時刻差の可視化: // 各サーバーで実行して結果を比較 $server_time = date('Y-m-d H:i:s.u T'); $db_time
= $pdo->query('SELECT NOW() AS time')->fetch()['time']; error_log("Server time: $server_time, DB time: $db_time"); 2025-04-12 スー | PHP Conference Odawara 2025 74

確認はまぁわかった。ズレる対策はどうするの？ 2025-04-12 スー | PHP Conference Odawara 2025 75

コンテナ環境での時刻ずれ対策ホストレベルでのNTP設定 ECSホストインスタンスのNTP設定がコンテナに継承される EC2起動時のユーザーデータでNTP設定を強化 2025-04-12 スー | PHP Conference Odawara
2025 76

コンテナ環境での時刻ずれ対策コンテナイメージの工夫ベースイメージ選定時にタイムゾーンデータを確認 Dockerfileでタイムゾーン設定を明示 ENV TZ=Asia/Tokyo RUN ln -snf /usr/share/zoneinfo/$TZ
/etc/localtime && echo $TZ > /etc/timezone 2025-04-12 スー | PHP Conference Odawara 2025 77

良い子は、Asia/Tokyoにするなよ・・・！！！ 2025-04-12 スー | PHP Conference Odawara 2025 78

コンテナ環境での時刻ずれ対策監視とアラート CloudWatchカスタムメトリクスで時刻ずれを監視 X-Ray トレースでサービス間の時刻ずれを検知 2025-04-12 スー | PHP Conference
Odawara 2025 79

もし頼れるインフラ担当がおられるチームかつ、日時にこだわる必要があるプロダクトの場合 2025-04-12 スー | PHP Conference Odawara 2025 80

コンテナ環境での追加対策ホストマシンの時刻同期を優先的に設定 Kubernetes環境: Node Problem Detector で時刻ずれを検知アプリケーションレベルでの時刻検証重要なワークロードには専用NTPサーバーの検討サイドカーコンテナでの監視
時刻監視専用のコンテナを追加 Prometheusエクスポーターとして機能 2025-04-12 スー | PHP Conference Odawara 2025 81

まとめ 2025-04-12 スー | PHP Conference Odawara 2025 82

PHPとOSの関係 PHPは基本的にOSのタイムゾーンデータを使用 PHPのバージョンアップがタイムゾーン定義も更新コンテナ環境では注意が必要 2025-04-12 スー | PHP Conference Odawara
2025 83

明日から取り組めるアクション 1. 全環境の php.ini とOS設定の整合性をチェックし、事情がなければできるだけ UTCにする 2. アプリの初期化処理で最悪UTCで取り扱えるように date_default_timezone_set('UTC') やデフォルトの設定を確認
3. 日時保存における処理についても理由がなければUTCを使おう 2025-04-12 スー | PHP Conference Odawara 2025 84

タイムゾーンデータは「生き物」だから闇を生む・・・タイムゾーンは政治的決定にかなり影響されるとあるOSの標準には頭を悩ませるものの、IANAデータベースが標準 PHPではdate.timezone設定とDateTimeクラスが重要開発ではUTC処理+表示時変換が基本 NTPは2038年問題があります！頭の隅に置く！ 2025-04-12 スー |
PHP Conference Odawara 2025 85

参考資料 PHP公式ドキュメント - タイムゾーン IANAタイムゾーンデータベース PHPでのDateTimeのベストプラクティス RFC 6557 - Procedures
for Maintaining the Time Zone Database タイムゾーン呪いの書 (知識編) すごくありがたい記事でした！ 2025-04-12 スー | PHP Conference Odawara 2025 86

ご静聴ありがとうございました！ X: @suguru_ohki GitHub: @SuguruOoki 2025-04-12 スー | PHP Conference
Odawara 2025 87

おまけ 2025-04-12 スー | PHP Conference Odawara 2025 88

NTPとPTPの比較項目 NTP PTP 精度ミリ秒〜マイクロ秒マイクロ秒〜ナノ秒実装主にソフトウェアハードウェア支援が望ましい
複雑さ比較的シンプルより複雑導入コスト低い高い（特にハードウェア対応機器） Webアプリでの利用一般的特殊用途（高頻度取引等）のみ PHPアプリケーションでは通常NTPで十分マイクロ秒以上の精度が必要な場合はPTPを検討 2025-04-12 スー | PHP Conference Odawara 2025 89

政治的変更の実例ロシアの永久夏時間採用と廃止（2011-2014） 2011年永久夏時間→2014年に標準時へ結果: Sochi冬季オリンピック放送時間混乱トルコの夏時間政策変更（2016）突然の夏時間廃止決定（数日前通知）結果: システム全体の混乱、予約システム障害 2025-04-12

アルゼンチン・サンルイス州の事例（2009）アルゼンチン全土が夏時間を終了するなか、サンルイス州だけが独自の道を選択 2009年3月15日からUTC-4（西部アルゼンチン時間/WART）を採用他の州とは異なるタイムゾーンで運用結果: 国内取引システムでのタイムスタンプ不整合予約システムの混乱州境をまたぐ業務での日程調整問題 2025-04-12 スー

データ更新の必要性 OSのアップデート (zoneinfoファイルの更新) PHP: timezonedb PECL拡張のアップデートリスク: DST切替時刻のズレ、オフセット間違いタイムゾーンデータが古いと: 予約システムの時間ズレ
バッチ処理タイミングの誤り国際APIの認証エラー 2025-04-12 スー | PHP Conference Odawara 2025 92

タイムゾーンの更新について 2025-04-12 スー | PHP Conference Odawara 2025 93

タイムゾーンデータの更新内容名称やエイリアスの追加/変更: 歴史的データの修正: うるう秒の情報: 2025-04-12 スー | PHP Conference Odawara
2025 94

タイムゾーンデータの更新内容名称やエイリアスの追加/変更: 地域名の変更に伴う識別子の更新互換性のための別名追加例: Burma → Myanmar, Rangoon →
Yangon 2025-04-12 スー | PHP Conference Odawara 2025 95

タイムゾーンデータの更新内容歴史的データの修正: 過去の時刻切り替え日時の訂正歴史研究により判明した情報の反映 2025-04-12 スー | PHP Conference Odawara
2025 96

タイムゾーンデータの更新内容うるう秒の情報: 地球の自転速度変化に基づく調整直近では2016年12月31日に追加 2025-04-12 スー | PHP Conference Odawara
2025 97

タイムゾーン更新の実際の影響予期せぬ動作: 日付計算が突然変わる特定地域のみでスケジュールタスクが異常動作過去の日時データが不正確に変換される 2025-04-12 スー | PHP Conference
Odawara 2025 98

タイムゾーン更新の実際の影響影響範囲: OSレベル: /usr/share/zoneinfo の更新ライブラリレベル: ICU、tzdata、phpのTimeZoneData アプリケーションレベル: キャッシュされたタイムゾーン情報 2025-04-12

タイムゾーン更新の実際の影響実例: ブラジルの夏時間廃止（2019年）多くのシステムで混乱が発生数百万ドル規模の経済的損失 2025-04-12 スー | PHP Conference
Odawara 2025 100

タイムゾーン更新への対応方法定期的な更新確認: IANAのTZデータ発表をウォッチ PHPとOS両方の更新が必要 2025-04-12 スー | PHP Conference Odawara
2025 101

タイムゾーン更新への対応方法テスト方法: 異なるタイムゾーンでの日付計算テスト自動化タイムゾーン更新前後での動作検証 2025-04-12 スー | PHP Conference Odawara
2025 102

タイムゾーン更新への対応方法障害に強い設計: 絶対時間（UTC）での内部保存局所的な表示時のみ変換タイムゾーン情報の明示的な保存 2025-04-12 スー | PHP Conference
Odawara 2025 103

PTP (Precision Time Protocol) IEEE 1588標準の高精度時刻同期プロトコル NTPよりさらに高精度（ナノ秒〜マイクロ秒レベル）主な用途：金融取引システム（高頻度取引）産業オートメーション
電力網制御システム通信ネットワーク特徴：ハードウェアタイムスタンプ対応ネットワーク遅延の非対称性を考慮 2025-04-12 スー | PHP Conference Odawara 2025 104

PHP内部でのタイムゾーン処理は、どのタイムゾーンをデフォルトとして使用するかを決定するための一連の優先順位に従います。以下にそのフローを説明します。 2025-04-12 スー | PHP Conference Odawara 2025 105

PHP内部でのタイムゾーン処理のフロー 1. date_default_timezone_set() 関数による設定: スクリプトの実行中に date_default_timezone_set() 関数が呼び出されると、その設定が最優先されます。ここで指定されたタイムゾーンが、それ以降の date()
関数や DateTime オブジェクト（明示的にタイムゾーンが指定されない場合）などの日付・時刻関連の処理で使用されるデフォルトのタイムゾーンになります。例: date_default_timezone_set('Asia/Tokyo'); 2025-04-12 スー | PHP Conference Odawara 2025 106

2. php.ini ファイルの date.timezone 設定: date_default_timezone_set() がスクリプト中で呼び出されなかった場合、PHPは php.ini ファイル内の
date.timezone ディレクティブの設定値を使用しようとします。これはサーバー全体、または特定のディレクトリ/アプリケーションに対するデフォルトのタイムゾーン設定として機能します。サーバー管理者が設定するのが一般的です。例 (php.ini内): date.timezone = "Asia/Tokyo" 現在の設定値は ini_get('date.timezone') で確認できます。 2025-04-12 スー | PHP Conference Odawara 2025 107

3. 環境変数 TZ (非推奨・限定的): 上記1と2の設定がない場合、一部の環境（主にUnix系システム）では環境変数 TZ を参照することがあります。しかし、PHPのドキュメントではこの方法への依存は推奨されておらず、動作は環境によって異なる可能性があるため、通常は考慮すべきではありませ
ん。 2025-04-12 スー | PHP Conference Odawara 2025 108

4. PHPによるシステム設定の推測 (非推奨・エラー発生): 上記1、2、3のいずれも利用できない場合、PHPはOS（オペレーティングシステム）のタイムゾーン設定を推測しようと試みることがありました (古いバージョン)。しかし、この推測は信頼性が低く、また、近年のPHPバージョン (PHP 5.1.0
以降) では、 date_default_timezone_set() または php.ini でタイムゾーンが明示的に設定されていない場合、日付/時刻関数を使用するたびに E_WARNING レベルのエラー（またはバージョンによっては E_NOTICE）が発生します。これは、開発者にタイムゾーン設定を強制するためです。 2025-04-12 スー | PHP Conference Odawara 2025 109

5. デフォルトのUTC: 上記1〜4のいずれの方法でもタイムゾーンが決定できず、かつエラー抑制などが行われているような特殊な状況下では、最終的に UTC (協定世界時) が使用される可能性があります。しかし、前述の通り、通常はその前に警告/エラーが発生するため、意図せずUTCになるケースは少ないはずです。 2025-04-12

フローの要約: PHPは以下の順序でデフォルトタイムゾーンを決定します。 1. date_default_timezone_set() (スクリプト実行中の設定) 2. php.ini の date.timezone (サーバー/アプリケーション設定)
3. (警告/エラー発生) PHPがタイムゾーン設定を見つけられない場合、警告またはエラーが発生します。 4. (最終手段: UTC) 上記で決まらずエラーも発生しない特殊な場合、UTCになる可能性があります。推奨される方法: php.ini で date.timezone を適切に設定する: サーバー環境全体で一貫したデフォルトタイムゾーンを提供します。 DateTime および DateTimeZone オブジェクトを使用する: 特定のタイムゾーン 2025-04-12 スー | PHP Conference Odawara 2025 111

<?php // デフォルトタイムゾーンを取得 (php.iniの設定などに依存) echo "Default timezone before set: "
. date_default_timezone_get() . "\n"; echo "Current time (default): " . date('Y-m-d H:i:s') . "\n\n"; // スクリプト内でデフォルトタイムゾーンを上書き date_default_timezone_set('America/New_York'); echo "Default timezone after set: " . date_default_timezone_get() . "\n"; echo "Current time (New York): " . date('Y-m-d H:i:s') . "\n\n"; // DateTimeオブジェクトで特定のタイムゾーンを指定 (デフォルト設定に影響されない) $tokyoTime = new DateTime('now', new DateTimeZone('Asia/Tokyo')); echo "Current time (Tokyo using DateTime): " . $tokyoTime->format('Y-m-d H:i:s P') . "\n"; $londonTime = new DateTime('now', new DateTimeZone('Europe/London')); echo "Current time (London using DateTime): " . $londonTime->format('Y-m-d H:i:s P') . "\n"; // DateTimeオブジェクトでタイムゾーンを指定しない場合、デフォルトタイムゾーンが使われる $defaultTimeObj = new DateTime('now'); echo "Current time (Default using DateTime): " . $defaultTimeObj->format('Y-m-d H:i:s P') . "\n"; ?> 2025-04-12 スー | PHP Conference Odawara 2025 112

このフローを理解することで、PHPアプリケーションで日時を正確に扱うための設定やコーディングが可能になります。特に、 php.ini での設定漏れによる警告や、意図しないタイムゾーンでの時刻表示を防ぐことが重要です。 2025-04-12 スー | PHP Conference
Odawara 2025 113

タイムゾーンの奥地は思ったよりも闇深いかもしれない

タイムゾーンの奥地は思ったよりも闇深いかもしれない

More Decks by Suguru Ohki

Other Decks in Programming

Featured

Transcript