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

公開ツールEpochタイムスタンプ精密変換(秒〜ナノ秒)

目次
  1. 桁数の取り違えが実務で起こる理由
  2. ツールを使わずに桁数だけで判別する方法
  3. 混同しやすいポイント
  4. まとめ
  5. よくある質問

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 年というありえない日付になります。

計算の手順をまとめる

計算の手順は次のとおりです。

  1. 数値の桁数を数える。
  2. 桁数のルール(11 / 14 / 17 桁の境界)に従って単位を決める。
  3. ミリ秒なら 1000 で割って秒に変換する。秒を JavaScript の Date に渡す場合は、逆に 1000 を掛けてミリ秒に変換する。
  4. 作成した Date オブジェクトを、toISOString()(UTC)と toString()(ローカル)でそれぞれ確認する。

桁数を数えて割り算や掛け算を手作業で繰り返す代わりに、Dynamic Labs の無料ツール「Epochタイムスタンプ精密変換(秒〜ナノ秒)」(桁数で単位を自動判定・相対時間・リアルタイムEpoch時計)で確認できます。

Epochタイムスタンプ精密変換(秒〜ナノ秒)

数値の桁数から単位を自動判定し、秒・ミリ秒・マイクロ秒・ナノ秒をUTCとローカル時刻にすぐ変換します。無料で、処理はブラウザ内だけで完結します。

混同しやすいポイント

同じ瞬間を指す値でも、単位ごとに桁数が異なります。以下は、先ほど検証した数値をそのまま表にまとめたものです。

桁数単位例の値指す時刻(UTC)
1〜11 桁秒17842982582026-07-17 14:24:18
12〜14 桁ミリ秒17842982580872026-07-17 14:24:18.087
15〜17 桁マイクロ秒17842982580870002026-07-17 14:24:18.087(同じ瞬間)
18 桁以上ナノ秒17842982580870000002026-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 年より前の時点を意味します。
  • マイクロ秒・ナノ秒の値は、ミリ秒の値を掛けて作った計算値です。
Epochタイムスタンプ精密変換(秒〜ナノ秒)

数値の桁数から単位を自動判定し、秒・ミリ秒・マイクロ秒・ナノ秒をUTCとローカル時刻にすぐ変換します。無料で、処理はブラウザ内だけで完結します。

よくある質問

桁数のルールだけで、単位を常に確実に判断できますか?

現在に近い年代を扱う実務のタイムスタンプであれば、このルールで十分に判別できます。ただし、これは「秒単位の値は西暦 5138 年まで 11 桁で表現できる」という計算に基づく慣例的な判別方法です。それよりはるか先の未来を指す秒単位の値は 12 桁以上になりうるため、ルールが当てはまらない場合があります。

負のタイムスタンプも入力できますか?

はい、1970年1月1日より前の日付を表す負の値も正しく計算されます。たとえば -3600 は、1969年12月31日23時(UTC)を意味します。

入力した数値はサーバーに送信されますか?

いいえ。単位の判別も日付の計算も、すべてブラウザ内で JavaScript により即座に処理され、入力した数値がサーバーに送信されることはありません。

マイクロ秒・ナノ秒の値は、実測値と同じ精度ですか?

いいえ。表示されるマイクロ秒・ナノ秒の値は、ミリ秒の値に 1000、1,000,000 を掛けて作った計算値です。元のシステムが実際にマイクロ秒単位まで独立して計測した値であれば、その値の下位の桁とは異なることがあります。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. アメリカの計量カップと日本の違い 1カップ何mLかアメリカのレシピの1カップ(236.59mL)は日本の計量カップ(200mL)と異なります。ガロン・クォート・パイント・カップ・大さじ・小さじをmLに換算する固定の比率と計算方法をまとめました。
  2. アメリカのレストランのチップ計算方法と1人あたりの金額アメリカのレストランで会計にチップをいくら足すか、チップ総額・合計・1人あたりの支払額の計算式を、国ごとのチップの扱いの違いとあわせて解説します。
  3. アメリカ給与の手取り計算|税金3段階で解説2026年の米国給与の手取りを、標準控除$16,100、連邦所得税、FICA、州税の順に年収$75,000の例で計算。2027年のIRS税率表と無料計算機も紹介します。
  4. アメリカのチップ計算方法|税抜・税込基準の比較アメリカのレシートのSubtotal・Tax・Totalの構造に沿って計算し、チップを税抜基準と税込基準で出した場合に1人あたりの金額がどれだけ変わるかを、数字で比べる方法をまとめました。
  5. UVインデックスの計算方法|等級・SPF・安全時間UVインデックスのWHO基準5段階の危険レベルと、肌タイプ・SPF・帽子・日陰が安全に屋外で過ごせる時間にどう影響するかを、計算式と例で解説します。
  6. VATの計算方法|税込額に10%を掛けると間違う理由税込の合計金額に税率をそのまま掛けると、VATの金額がずれます。税抜→税込(掛け算)と税込→分離(÷1.1)の違いを例の数字で示し、税率別に検算する方法も紹介します。

関連ツール