日時のトラブルは3種類
| 症状 | 疑う原因 |
|---|---|
| ちょうど9時間(または9時間の倍数に近い値)ずれる | タイムゾーン(UTC と日本時間)の取り違え |
| 1970年1月1日になる、または遠い未来(5万年後など)になる | 空の値(0)や、秒とミリ秒の取り違え |
| 日付の形式が読めない・エラーになる | 形式(ISO 8601 など)の違い |
9時間ずれる:UTC と日本時間
日本標準時(JST)は、世界の基準時刻 UTC より9時間進んでいます。同じ瞬間を、UTC では 2026-10-04 03:00:00、日本時間では 2026-10-04 12:00:00 と書きます。UNIX時間(エポック秒)はこの瞬間を 1791082800 という1つの数字で表すので、タイムゾーンの情報を持ちません。
9時間ずれるときは、次のどれかです。
- 日本時間の値を、UTC だと思って変換した(またはその逆)
- サーバーのタイムゾーンが UTC になっていて、日本時間のつもりで表示している
- データベースにタイムゾーンなしで保存した日時を、別のタイムゾーンの環境で読んだ
原則は、保存と受け渡しは UTC(または UTC 基準の UNIX時間)、画面に出すときだけ日本時間に変換することです。変換は、このツールのUNIX時間変換で、秒・ミリ秒を自動判定しながら確かめられます。
日時の書き方(ISO 8601)
システム間で日時を文字列でやり取りするときは、ISO 8601 形式が標準的です。
| 書き方 | 意味 |
|---|---|
2026-10-04T12:00:00+09:00 | 日本時間の2026年10月4日12時(UTC より +9時間) |
2026-10-04T03:00:00Z | 同じ瞬間を UTC で書いたもの(Z は UTC の印) |
2026-10-04T12:00:00 | タイムゾーンの指定がない。どの時刻か、読む側の設定で変わる |
2026-10-04 | 日付だけ |
タイムゾーンの指定がない文字列は、プログラム言語によって解釈が違います。たとえば JavaScript の new Date('2026-10-04T12:00:00') は、動いている環境の時刻(日本なら日本時間)として読みますが、new Date('2026-10-04') のように日付だけの形は UTC の午前0時として読みます。日本時間では午前9時になるので、日付の表示が前後することがあります。必ず +09:00 や Z を付けると、読む側で迷いません。
秒とミリ秒の取り違え
現在の UNIX時間は、秒なら10桁、ミリ秒なら13桁です。JavaScript の Date.now() や Java の System.currentTimeMillis() はミリ秒、PHP の time()、Python の time.time()、シェルの date +%s は秒を返します。
- ミリ秒の値を「秒」として読むと、約5万年後の日付になる
- 秒の値を「ミリ秒」として読むと、1970年1月の日付になる
API や JWT の exp は秒が標準なので、JavaScript で作るときは Math.floor(Date.now() / 1000) のように1000で割ります。
1970年になる
UNIX時間の 0 は 1970年1月1日 0時0分0秒(UTC)で、日本時間では 1970-01-01 09:00:00 です。日時の値が空(null、未設定)のはずなのに 1970年と表示されるときは、空の値が 0 に変換されてしまっています。画面に出す前に、空の値かどうかを確認してください。
データベースの日時型の違い
| 種類 | 特徴 |
|---|---|
MySQL DATETIME | タイムゾーンの情報を持たず、書いた値をそのまま保存する。読む側の設定は影響しない |
MySQL TIMESTAMP | 内部では UTC で持ち、接続のタイムゾーン設定に合わせて変換して出し入れする。範囲は 1970〜2038年 |
PostgreSQL timestamp | タイムゾーンなし。書いた値をそのまま保存する |
PostgreSQL timestamptz | UTC で保存し、セッションのタイムゾーンに合わせて表示する。通常はこちらが安全 |
サーバーを移したら時刻がずれた、というときは、DB のタイムゾーン設定(time_zone)と、接続側(アプリ)の設定のどちらが変わったかを確認します。
2038年問題
UNIX時間を符号付き32ビット整数で持っていると、最大値 2147483647 を超えられません。この値は日本時間で2038年1月19日 12時14分07秒にあたり、その1秒後にあふれて、負の値(1901年)に戻ってしまいます。64ビット整数を使えば避けられますが、古い組み込み機器や、MySQL の TIMESTAMP(2038年まで)には、この制約が残っています。
夏時間とタイムゾーン名
日本には夏時間(サマータイム)がありませんが、海外のシステムと連携するときは、夏時間で UTC との差が季節で変わる地域があります。+09:00 のような固定の差ではなく、Asia/Tokyo のようなタイムゾーン名(IANA の名前)で扱うと、規則の変更にも対応できます。
チェックリスト
- その値は、秒か、ミリ秒か(桁数で見分ける)。
- その値は、どのタイムゾーンの時刻か(UTC か、日本時間か、指定なしか)。
- 空の値が
0に変換されていないか。 - 保存は UTC、表示だけ日本時間、になっているか。
- 文字列で受け渡すときは
+09:00かZが付いているか。 - 期限(
expなど)の確認は、JWTデコードで日本時間に直して見る。