日時トラブルの原因まとめ:9時間ずれ・UNIX時間・タイムゾーン

日時のバグは、ほとんどが「タイムゾーンの扱い」「形式」「単位(秒かミリ秒か)」のどれかです。原因ごとに見分け方と対策をまとめました。

日時のトラブルは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 timestamptzUTC で保存し、セッションのタイムゾーンに合わせて表示する。通常はこちらが安全

サーバーを移したら時刻がずれた、というときは、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 の名前)で扱うと、規則の変更にも対応できます。

チェックリスト

  1. その値は、秒か、ミリ秒か(桁数で見分ける)。
  2. その値は、どのタイムゾーンの時刻か(UTC か、日本時間か、指定なしか)。
  3. 空の値が 0 に変換されていないか。
  4. 保存は UTC、表示だけ日本時間、になっているか。
  5. 文字列で受け渡すときは +09:00 か Z が付いているか。
  6. 期限(exp など)の確認は、JWTデコードで日本時間に直して見る。

関連ツール