タイムスタンプの日付変換|秒・ミリ秒とUTCの読み方

目次
APIのレスポンスやデータベースに1700000000のような数字で保存された時刻を、人が読める日付に変換したい人向けの記事です。Unixタイムスタンプは1970年1月1日0時(UTC)から経過した秒、またはミリ秒にすぎないので、ルールさえ分かれば、ある数字が何時を指すのか正確に読み取れます。逆に単位を勘違いすると、同じ数字が1970年に見えたり、数千年後になったりします。
要点 ① タイムスタンプは1970-01-01 00:00:00 UTC(エポック)から経過した秒、またはミリ秒です。 ② 桁数が11桁以下なら秒、12桁以上ならミリ秒と判別します。単位を勘違いすると、結果の日付が約1000倍ずれます。 ③ 同じタイムスタンプでも、ローカル・UTC・ISOの3形式ではタイムゾーンのオフセット分だけ表示が異なります。
ログには単位の表示がなく、数字だけが残っている
サーバーログやAPIのレスポンスでは、時刻がcreated_at: 1700000000のように数字1つだけで残っていることがよくあります。人が読む「2023年11月」ではなく、エポックからの経過時間をそのまま保存しているからです。
問題は、この数字に「秒」なのか「ミリ秒」なのか、単位が一緒に書かれていないことです。あるシステムは秒単位、別のシステムはミリ秒単位で記録するため、フィールド名が同じでも実際の値の桁数は異なることがあります。
そのため、ログで1700000000と1700000000000を並べて見ても、この2つが同じ瞬間なのか、まったく別の時刻なのか、ひと目では分かりにくいものです。この記事では、その数字を正確な日付として読み取るルールを整理します。
ツールを使わずに自分で変換する方法
ステップ1: エポックの定義から
Unixタイムスタンプの基準点(エポック)は1970年1月1日 00:00:00 UTCです。タイムスタンプは、この瞬間から何秒(または何ミリ秒)が経過したかを表す1つの数字です。
ここで重要なのは、基準がUTCだという点です。タイムスタンプ自体にタイムゾーンの情報はなく、どの地域で読んでも同じ絶対的な瞬間を指します。
ステップ2: 桁数で単位を見分ける
整数部分の桁数を数えます。11桁以下なら秒、12桁以上ならミリ秒とみなします。現在の時点では秒単位の値が10桁、ミリ秒単位の値が13桁なので、実務ではたいていはっきり区別できます。
秒単位の値を日付に変換するには、ミリ秒に合わせる必要があります。JavaScriptのDateは常にミリ秒を基準に動作するため、秒の値には1000を掛けます。
ステップ3: 実際に計算する
もっとも確実な方法は、ブラウザの開発者コンソールを使うことです。秒の値なら1000を掛けて渡します。
new Date(1700000000 * 1000).toString() // ローカル時刻
new Date(1700000000 * 1000).toUTCString() // UTC
new Date(1700000000 * 1000).toISOString() // ISO 8601
コマンドラインのほうが楽なら、Macではdate -r 1700000000 -u、Linuxではdate -d @1700000000 -uでUTCの時刻を確認できます。
スプレッドシートでは、=A1/86400 + DATE(1970,1,1)という数式で秒の値をUTCの日付に変換できます。韓国の時刻で見たい場合は、これに9/24を足します(UTC+9)。
ステップ4: UTCを現地時刻に
UTCの値が出たら、自分の地域のオフセットを足します。韓国標準時(KST)はUTC+9なので、UTCに9時間を足した値が現地時刻です。
Dynamic Labsの無料ツール「Unixタイムスタンプ変換(秒・ミリ秒)」(今のタイムスタンプをすぐ確認、日付 ↔ 秒・ミリ秒だけを手早く)で確認してみてください。
数字を入れると秒・ミリ秒を自動判別して現地・UTC・ISOの時刻に、日付を選ぶと秒・ミリ秒の値に変換します。インストール不要で、ブラウザ上で処理されます。

同じ値がローカル・UTC・ISOで違って見える理由
ツールに1700000000を入れると、3行の結果が表示されます。同じ数字1つなのに時刻がそれぞれ違って見えるので、戸惑うかもしれません。
| 形式 | 表示 | 意味 |
|---|---|---|
| ローカル(現地) | 2023-11-15 07:13:20 | ブラウザのタイムゾーン(KST=UTC+9)基準 |
| UTC | 2023-11-14 22:13:20 UTC | タイムゾーンオフセット0基準 |
| ISO 8601 | 2023-11-14T22:13:20.000Z | UTCを国際標準の文字列で表記 |
3つの値はすべて同じ瞬間を指しています。タイムスタンプはタイムゾーンを持たない絶対値なので、どの形式で読むかによって表示が変わるだけです。
現地時刻がUTCより9時間進んでいるのは、KSTがUTC+9だからです。この例では9時間を足した結果、日付も11月14日から15日へと1日繰り上がっています。
ISO 8601文字列の末尾にあるZは、「この時刻はUTC」という印です。そのためISOとUTCの行は形式が違うだけで、指している時刻は同じです。
よくある間違い:単位を勘違いすると1000倍ずれる
いちばん多いミスは、単位を取り違えることです。秒の値をミリ秒として、またはミリ秒の値を秒として勘違いすると、結果が約1000倍ずれます。
| 入力した数字 | 扱った単位 | 計算される時刻(UTC) |
|---|---|---|
| 1700000000(10桁) | 秒(正常) | 2023-11-14 22:13:20 |
| 1700000000000(13桁) | ミリ秒(正常) | 2023-11-14 22:13:20 |
| 1700000000 | ミリ秒と勘違い | 1970-01-20 16:13:20 |
1700000000はもともと秒の値なので、1000を掛けて初めて2023年になります。これをそのままミリ秒として扱うと約17億ミリ秒、つまり20日あまりにしかならないため、1970年1月に飛んでしまいます。
逆に、13桁のミリ秒値に誤ってもう一度1000を掛けると、西暦数万年台というありえない日付になります。ツールは桁数から単位を先に判別するので、こうした掛け算のミスを減らせます。
ただし、桁数による判別はあくまで慣習だという点も覚えておくとよいでしょう。12桁以上をミリ秒とみなすため、非常に遠い未来を指す秒の値だとルールが当てはまらないことがあります。
まとめ
- Unixタイムスタンプは1970-01-01 00:00:00 UTC(エポック)から経過した秒、またはミリ秒です。
- 桁数が11桁以下なら秒、12桁以上ならミリ秒です。現在の秒の値は10桁、ミリ秒の値は13桁です。
- 単位を勘違いすると結果が約1000倍ずれ、1970年付近やとんでもない未来に飛んでしまいます。
- 同じタイムスタンプでも、ローカル・UTC・ISOはタイムゾーンのオフセット分だけ表示が違うだけで、同じ瞬間を指します。
- ISO 8601の末尾の
Zは、その時刻がUTCであることを示す印です。
数字を入れると秒・ミリ秒を自動判別して現地・UTC・ISOの時刻に、日付を選ぶと秒・ミリ秒の値に変換します。インストール不要で、ブラウザ上で処理されます。
よくある質問
10桁と13桁の数字はどうやって見分けますか?
桁数で判別します。ツールは11桁以下を秒、12桁以上をミリ秒とみなします。現在の時点では秒単位の値が10桁、ミリ秒単位の値が13桁なので、たいていはっきり区別できます。秒の値は日付に変換するため、内部で1000を掛けて計算します。
現地時刻とUTCで表示が違うのはなぜですか?
タイムスタンプはタイムゾーンを持たない絶対値で、現地時刻はそこにブラウザのタイムゾーンオフセットを足した結果だからです。韓国標準時はUTC+9なので現地時刻はUTCより9時間進んで見え、場合によっては日付も1日繰り上がります。2行は表示が違うだけで、同じ瞬間を指しています。
日付からタイムスタンプに逆変換することもできますか?
はい。ツールの2番目の欄で日付と時刻を選ぶと、その瞬間の秒の値とミリ秒の値をまとめて表示し、それぞれコピーできます。秒の値は、ミリ秒を1000で割って小数点以下を切り捨てた整数です。
入力した数字はサーバーに送信されますか?
いいえ。単位の判別と日付の計算はすべてブラウザ内で即時に処理されます。別途の送信やインストールは不要で、入力するとすぐに結果が変わります。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む