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

公開ツールUnixタイムスタンプ変換(秒・ミリ秒)

目次
  1. ログには単位の表示がなく、数字だけが残っている
  2. ツールを使わずに自分で変換する方法
  3. 同じ値がローカル・UTC・ISOで違って見える理由
  4. よくある間違い:単位を勘違いすると1000倍ずれる
  5. まとめ
  6. よくある質問

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タイムスタンプ変換(秒・ミリ秒)」(今のタイムスタンプをすぐ確認、日付 ↔ 秒・ミリ秒だけを手早く)で確認してみてください。

Unixタイムスタンプ変換(秒・ミリ秒)

数字を入れると秒・ミリ秒を自動判別して現地・UTC・ISOの時刻に、日付を選ぶと秒・ミリ秒の値に変換します。インストール不要で、ブラウザ上で処理されます。

同じ値がローカル・UTC・ISOで違って見える理由

ツールに1700000000を入れると、3行の結果が表示されます。同じ数字1つなのに時刻がそれぞれ違って見えるので、戸惑うかもしれません。

形式表示意味
ローカル(現地)2023-11-15 07:13:20ブラウザのタイムゾーン(KST=UTC+9)基準
UTC2023-11-14 22:13:20 UTCタイムゾーンオフセット0基準
ISO 86012023-11-14T22:13:20.000ZUTCを国際標準の文字列で表記

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であることを示す印です。
Unixタイムスタンプ変換(秒・ミリ秒)

数字を入れると秒・ミリ秒を自動判別して現地・UTC・ISOの時刻に、日付を選ぶと秒・ミリ秒の値に変換します。インストール不要で、ブラウザ上で処理されます。

よくある質問

10桁と13桁の数字はどうやって見分けますか?

桁数で判別します。ツールは11桁以下を秒、12桁以上をミリ秒とみなします。現在の時点では秒単位の値が10桁、ミリ秒単位の値が13桁なので、たいていはっきり区別できます。秒の値は日付に変換するため、内部で1000を掛けて計算します。

現地時刻とUTCで表示が違うのはなぜですか?

タイムスタンプはタイムゾーンを持たない絶対値で、現地時刻はそこにブラウザのタイムゾーンオフセットを足した結果だからです。韓国標準時はUTC+9なので現地時刻はUTCより9時間進んで見え、場合によっては日付も1日繰り上がります。2行は表示が違うだけで、同じ瞬間を指しています。

日付からタイムスタンプに逆変換することもできますか?

はい。ツールの2番目の欄で日付と時刻を選ぶと、その瞬間の秒の値とミリ秒の値をまとめて表示し、それぞれコピーできます。秒の値は、ミリ秒を1000で割って小数点以下を切り捨てた整数です。

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

いいえ。単位の判別と日付の計算はすべてブラウザ内で即時に処理されます。別途の送信やインストールは不要で、入力するとすぐに結果が変わります。

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

関連記事

  1. 大文字小文字の反転・交互変換の仕組みと4つの規則英文の大文字と小文字を反転する方法、aBaB・AbAbで1文字ずつ交互に切り替える規則、50対50のランダム変換まで、4つの変換が何を計算しているのかを例で説明します。
  2. TOML JSON 変換の文法対応を実例で確認TOMLをJSONにすると[table]は入れ子のオブジェクト、[[table]]はオブジェクトの配列に。JSONから戻すときの最上位の規則、nullキーの省略、日付やアンダースコア入り数値の扱いまで変換結果で確認できます。
  3. TOTP生成器の仕組み|6桁コードの計算方法TOTPの6桁コードがどう計算されるのかを、Base32の秘密鍵とUTC時刻の30秒カウンターからHMAC-SHA1で求める標準手順に沿って解説。otpauthのQRコードに含まれる値や、番号が合わない原因もツールで確認できます。
  4. Unicodeエスケープ変換と復元、6つの形式の違いを整理\uXXXX・U+コードポイント・HTMLエンティティの相互変換と復元の方法を例で整理しました。各形式の意味と違い、絵文字が2つに分かれる理由、ASCIIが変わらない理由まで解説します。
  5. URL正規化とは?utm・追跡パラメータを削除して標準リンクにutm_やfbclid・gclid・refなどの追跡パラメータを消し、ホストの小文字化や既定ポートの削除、末尾スラッシュやパラメータ整列まで、URL正規化の規則と「適用された変更」の読み方をまとめました。
  6. URLエンコードで空白が%20になる理由と仕組みURLエンコードで空白が%20、韓国語の「가」が%EA%B0%80になる仕組みをUTF-8バイトから説明します。全体URLと構成要素の2モードの違い、二重エンコードなどの失敗例も確認できます。

関連ツール