UNIXタイムスタンプの桁数で秒・ミリ秒を見分ける方法

API のレスポンスやサーバーログに出力された 1784298258 のような数値が、正確にいつの時刻を指しているのかは、桁数を数えるだけで判別できます。Unix タイムスタンプは、秒単位かミリ秒単位かによって、桁数の範囲が決まっています。
このルールを知らずに数値をそのまま JavaScript の Date コンストラクタに渡すと、1970年代付近の日付や、西暦数万年といった途方もない日付が出てきます。この記事では、桁数だけで秒・ミリ秒・マイクロ秒・ナノ秒を見分けるための計算ルールをまとめます。
要約 ① 桁数が 1〜11 桁なら秒、12〜14 桁ならミリ秒、15〜17 桁ならマイクロ秒、18 桁以上ならナノ秒です。 ② 10 桁の秒の値をミリ秒と取り違えてそのまま Date に渡すと 1970 年付近になり、13 桁のミリ秒の値を秒と取り違えて 1000 を掛けると、西暦数万年といった値になります。 ③ 同じタイムスタンプでも、UTC とローカル時刻ではタイムゾーンのオフセット分だけ表示が異なります。また、負の値は 1970 年より前の時点を意味します。
桁数の取り違えが実務で起こる理由
サーバーログや API のレスポンスでは、タイムスタンプが単位の表記なしに数値だけで出力されることがよくあります。システムによって秒単位で返すものもあればミリ秒単位で返すものもあるため、フィールド名が同じ(created_at、timestamp など)でも、実際の値の桁数が異なることがあります。
問題は、JavaScript の Date コンストラクタが常にミリ秒を基準に動作する点です。new Date(x) は、x を 1970年1月1日0時(UTC)から何ミリ秒経過したかとして解釈します。
ここに秒単位の数値をそのまま渡すと、実際の 1000 分の 1 の小さな値をミリ秒として読むことになり、計算結果の日付が 1970 年付近になってしまいます。
逆の間違いもあります。ミリ秒単位の数値を秒単位だと思い込んで 1000 を掛けてから Date に渡すと、実際の日付より 1000 倍遠い未来になってしまいます。どちらの間違いでもコードはエラーなくそのまま実行されるため、画面におかしな日付が表示されるまで気づきにくいのが厄介です。
ツールを使わずに桁数だけで判別する方法
判別ルールと 11 桁が境界になる理由
判別ルールは次のとおりです。整数部分の桁数を数え、1〜11 桁なら秒、12〜14 桁ならミリ秒、15〜17 桁ならマイクロ秒、18 桁以上ならナノ秒とみなします。
境界が 11 桁なのには理由があります。11 桁の最大値である 99999999999 を秒として変換すると、5138年11月16日になります。
つまり、秒単位のタイムスタンプは 11 桁だけでも西暦 5138 年まで表現できるため、12 桁以上の数値が出てきた場合は、秒ではなくより小さい単位である可能性がはるかに高いといえます。
実際の数値で検証する
実際の数値で検証してみましょう。この記事を書いている時点の秒単位のタイムスタンプは 1784298258(10 桁)で、秒として正しく解釈すると 2026年7月17日14時24分(UTC)になります。
ところが、この数値を誤って new Date(1784298258) のようにミリ秒の位置にそのまま渡すと、結果は 1970年1月21日になります。1784298258 ミリ秒は約 20 日にしかならないためです。
同じ瞬間のミリ秒単位の値は 1784298258087(13 桁)です。この数値を逆に秒単位だと思い込み、1000 を掛けて new Date(1784298258087 * 1000) のように渡すと、結果は西暦 58512 年というありえない日付になります。
計算の手順をまとめる
計算の手順は次のとおりです。
- 数値の桁数を数える。
- 桁数のルール(11 / 14 / 17 桁の境界)に従って単位を決める。
- ミリ秒なら 1000 で割って秒に変換する。秒を JavaScript の Date に渡す場合は、逆に 1000 を掛けてミリ秒に変換する。
- 作成した Date オブジェクトを、toISOString()(UTC)と toString()(ローカル)でそれぞれ確認する。
桁数を数えて割り算や掛け算を手作業で繰り返す代わりに、Dynamic Labs の無料ツール「Epochタイムスタンプ精密変換(秒〜ナノ秒)」(桁数で単位を自動判定・相対時間・リアルタイムEpoch時計)で確認できます。
数値の桁数から単位を自動判定し、秒・ミリ秒・マイクロ秒・ナノ秒をUTCとローカル時刻にすぐ変換します。無料で、処理はブラウザ内だけで完結します。

混同しやすいポイント
同じ瞬間を指す値でも、単位ごとに桁数が異なります。以下は、先ほど検証した数値をそのまま表にまとめたものです。
| 桁数 | 単位 | 例の値 | 指す時刻(UTC) |
|---|---|---|---|
| 1〜11 桁 | 秒 | 1784298258 | 2026-07-17 14:24:18 |
| 12〜14 桁 | ミリ秒 | 1784298258087 | 2026-07-17 14:24:18.087 |
| 15〜17 桁 | マイクロ秒 | 1784298258087000 | 2026-07-17 14:24:18.087(同じ瞬間) |
| 18 桁以上 | ナノ秒 | 1784298258087000000 | 2026-07-17 14:24:18.087(同じ瞬間) |
UTC・ローカル時刻と相対時間の違い
UTC とローカル時刻で表示が異なる理由は、タイムスタンプそのものが特定のタイムゾーンに属さない絶対的な値(1970年1月1日0時 UTC からの経過時間)だからです。ローカル時刻は、この絶対値にブラウザで設定されているタイムゾーンのオフセットを加えた結果です。
たとえば、上の表の値は UTC では 7月17日14時24分ですが、日本標準時(UTC+9)では同じ瞬間が 7月17日23時24分と表示されます。
相対時間(「3時間後」のような表示)は、対象の時刻と現在時刻の差を秒単位で計算し、分・時間・日のうち人が読みやすい単位に換算して表示した値です。対象が現在より未来なら「〜後」、過去なら「〜前」と付きます。
負のタイムスタンプと計算で求めた下位単位
負のタイムスタンプも有効な値です。負の値は、1970年1月1日0時(UTC)より前の時点を意味します。たとえば -3600 は、その基準時刻から 3600 秒(1 時間)前にあたる 1969年12月31日23時(UTC)を指します。
最後に、マイクロ秒・ナノ秒の値は、ミリ秒の値にそれぞれ 1000、1,000,000 を掛けて作った計算値であることも知っておく必要があります。元のシステムが実際にマイクロ秒単位まで独立して計測していた場合、その元の値の下位の桁は、この計算値とは異なることがあります。
まとめ
- 桁数が 1〜11 桁なら秒、12〜14 桁ならミリ秒、15〜17 桁ならマイクロ秒、18 桁以上ならナノ秒です。
- 11 桁の秒の最大値でも西暦 5138 年にすぎないため、12 桁以上なら秒ではない可能性が高くなります。
- 10 桁の秒の値をミリ秒の位置にそのまま渡すと 1970 年代付近に、13 桁のミリ秒の値を秒と取り違えて 1000 を掛けると、途方もない未来になります。
- 同じタイムスタンプでも、UTC とローカル時刻はタイムゾーンのオフセット分だけ異なって表示され、負の値は 1970 年より前の時点を意味します。
- マイクロ秒・ナノ秒の値は、ミリ秒の値を掛けて作った計算値です。
数値の桁数から単位を自動判定し、秒・ミリ秒・マイクロ秒・ナノ秒をUTCとローカル時刻にすぐ変換します。無料で、処理はブラウザ内だけで完結します。
よくある質問
桁数のルールだけで、単位を常に確実に判断できますか?
現在に近い年代を扱う実務のタイムスタンプであれば、このルールで十分に判別できます。ただし、これは「秒単位の値は西暦 5138 年まで 11 桁で表現できる」という計算に基づく慣例的な判別方法です。それよりはるか先の未来を指す秒単位の値は 12 桁以上になりうるため、ルールが当てはまらない場合があります。
負のタイムスタンプも入力できますか?
はい、1970年1月1日より前の日付を表す負の値も正しく計算されます。たとえば -3600 は、1969年12月31日23時(UTC)を意味します。
入力した数値はサーバーに送信されますか?
いいえ。単位の判別も日付の計算も、すべてブラウザ内で JavaScript により即座に処理され、入力した数値がサーバーに送信されることはありません。
マイクロ秒・ナノ秒の値は、実測値と同じ精度ですか?
いいえ。表示されるマイクロ秒・ナノ秒の値は、ミリ秒の値に 1000、1,000,000 を掛けて作った計算値です。元のシステムが実際にマイクロ秒単位まで独立して計測した値であれば、その値の下位の桁とは異なることがあります。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む