Unix時間は何を数えているのか。1700000000は「ミリ秒なら1970年」になる
ログに 1700000000 という数字が出てきた。これは日時なのか。いつなのか。秒なのか、ミリ秒なのか。Unix時間の意味と、読み違えたときに何が起きるかを、手元で測って確かめた。
Unix時間は、「1970年からの秒数」の近似
POSIXの定義(POSIX.1-2017 = IEEE Std 1003.1-2017。確認日:2026年11月3日)を読んだ。
- Epoch(3.150):1970年1月1日 0時0分0秒(UTC)。
- Seconds Since the Epoch(4.16):その時刻から経過した秒数を「近似する値」。1日をちょうど86400秒として数える式が定められている。
定義の式は、1日を常に86400秒として数える。うるう秒を足す仕組みは無く、実際の時刻との対応は、仕様では実装に任されている(実装依存とされている)。つまり、Unix時間は「実際に経過した秒」そのものではない。ふだんのログの読み取りでは、気にする必要はほとんどない。
桁数で、秒とミリ秒を見分けられるか
同じ瞬間(2023年11月14日 22:13:20 UTC)が、単位によって、桁数の違う数字になる。
| 単位 | 値 |
|---|---|
| 秒 | 1700000000(10桁) |
| ミリ秒 | 1700000000000(13桁) |
| マイクロ秒 | 1700000000000000(16桁) |
| ナノ秒 | 1700000000123456789(19桁、下の桁は例) |
現在(2026年11月3日)の Date.now()(Node)は13桁、Goの Unix() は10桁、UnixNano() は19桁、PowerShell の ToUnixTimeSeconds() は10桁だった。言語によって、秒とミリ秒とナノ秒が混ざる。
では、桁数だけで判別できるか。同じ数字を、単位を変えて読むと、こうなった。
| 数字 | 秒として | ミリ秒として |
|---|---|---|
1700000000(10桁) | 2023-11-14 | 1970-01-20 |
1700000000000(13桁) | 55840年 | 2023-11-14 |
999999999(9桁) | 2001-09-09 | 1970-01-12 |
10000000000(11桁) | 2286-11-20 | 1970-04-26 |
100000000000(12桁) | 5138-11-16 | 1973-03-03 |
どの数字も、読み方次第で「日時らしい」値になる。見分ける手がかりは、「どの期間の日時が現実的か」だけだ。ログが2000年代以降のものなら、秒は9〜10桁、ミリ秒は12〜13桁で、重ならない。ただし、1970年代のデータや、遠い未来の日付が入るデータでは、重なる。桁数は、範囲を決めたうえでの目安だ。範囲を決めずに数字を拾うと、IDや注文番号も日時に見える。
2038年に、32ビットは何を数え間違えるか
Unix時間を32ビットの符号付き整数で持つと、表せる最大の値は 2147483647 だ。これを日時にすると、こうなる(Node で確かめた)。
| 値 | 日時(UTC) |
|---|---|
2147483647 | 2038-01-19 03:14:07 |
2147483648 | 2038-01-19 03:14:08 |
4294967295 | 2106-02-07 06:28:15 |
-2147483648 | 1901-12-13 20:45:52 |
2147483648 は、32ビットの符号付き整数には入らない。Go で int32(2147483648) と変換すると、-2147483648 になり、日時にすると 1901-12-13 20:45:52 に戻った。2038年1月19日の次の1秒で、時計が約136年戻る。符号なしの32ビットなら、2106年まで持つ(4294967295)。
今日の値は約 1.79×10⁹ なので、2147483648 まで、あと3億5千万秒(約11年)だ。時刻を32ビットで持つシステムは、今から修正しておく必要がある。ただし、64ビットで持っていれば、この問題はない(Go や PowerShell の FromUnixTimeSeconds で 2147483648 を正しく扱えた)。
ナノ秒は、JavaScriptの数値に入りきらない
ナノ秒は19桁になる。JavaScript の Number が正確に扱える整数は、9007199254740991(16桁)までだ。1700000000123456789 を Number にすると、1700000000123456800 になり、BigInt に戻すと 1700000000123456768(21ナノ秒のずれ)になった。ナノ秒を扱うときは、BigInt を使うか、文字列のままで持つ必要がある。
日本時間とのずれ
もう一つ、よくある間違いが、時差の取り違えだ。2023-11-15 07:13:20(日本時間)を、うっかりUTCとして読むと、こうなる。
| 読み方 | Unix時間 |
|---|---|
| 日本時間(UTC+9)として | 1700000000 |
| UTCとして | 1700032400 |
差は 32400 秒、ちょうど9時間だ。日本時間のログをUTCとして変換すると、9時間先の時刻になる。変換したときは、タイムゾーンを確認してほしい。
範囲を決めて、まとめて変換する
このサイトのツールは、ログに入ったUnix時間を、範囲(既定は2000年〜2050年)を決めて探し、日時にして横に付ける。単位は、秒→ミリ秒→マイクロ秒→ナノ秒の順に、範囲に収まるものを選ぶ。IDや、IPアドレス、UUID、バージョン番号に含まれる数字は、拾わない。32ビットの上限(2147483647)を超える値には、警告を出す。この動作は、計算の検算(check:datetime)で確かめている。
測定の条件
- Node 24、Go 1.27.0、PowerShell 5.1.26100.9818(Windows 11 Pro 10.0.26300)で測った。「現在」の値は2026年11月3日の実行時のもの。
- 日時への変換は、Node の
Date(toISOString)、Go のtime.Unix、PowerShell のFromUnixTimeSecondsで行い、ナノ秒の精度は Node のBigIntで確かめた。 - macOS・Linux の
dateコマンドや、他の言語(Python・Java・C)は試していない。
参考
- The Open Group, POSIX.1-2017(IEEE Std 1003.1-2017)Base Definitions 3.150 Epoch:https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html(2026年11月3日確認)
- The Open Group, POSIX.1-2017 Base Definitions 4.16 Seconds Since the Epoch:https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html(2026年11月3日確認)