ログやAPIのレスポンスに出てくる「1710000000」のような10桁の数字。これがUnixタイムスタンプです。本記事では、その仕組みと、実務で知っておきたい注意点を解説します。
Unixタイムスタンプは、1970年1月1日0時0分0秒(UTC)を基準(エポック)として、そこから何秒経過したかを表す数値です。この基準日のことを「Unixエポック」と呼びます。日時を1つの数値で表せるため、プログラムでの比較や計算がしやすく、ログの記録やAPIのやり取りで広く使われています。
タイムスタンプには、秒単位とミリ秒単位の2種類があり、見分け方は桁数です。現在のタイムスタンプは、秒単位ならおおよそ10桁、ミリ秒単位なら13桁になります。
秒単位(10桁): 1742400000 ミリ秒単位(13桁): 1742400000000
桁数を見誤ると、日時への変換結果が大きくずれてしまいます(ミリ秒の数値を秒として扱うと、1970年付近の日付になってしまいます)。
JavaScriptのDateオブジェクトは、内部的にミリ秒単位のタイムスタンプを扱います。new Date(1710000000 * 1000)のように、秒単位のタイムスタンプは1000倍してから渡す必要があります。
古いシステムの一部では、タイムスタンプを32ビットの符号付き整数で扱っています。32ビットで表現できる最大値には限りがあり、2038年1月19日頃に上限に達して、日時が正しく扱えなくなる可能性があるとされています。これを「2038年問題」と呼びます。現在広く使われている64ビットの環境では、この問題は起きません。
Unixタイムスタンプ自体には、タイムゾーンの情報が含まれていません。同じタイムスタンプの値でも、日本時間(JST)で表示するか、協定世界時(UTC)で表示するかによって、見た目の日時が9時間ずれます。変換した日時を人に伝える際は、どのタイムゾーンで表示しているかを明記すると誤解を防げます。
Unixタイムスタンプは便利ですが、運用では次のような注意点があります。
保存はUTC、表示はJSTにする。 タイムスタンプ自体はタイムゾーンを持たないため、保存する時点で基準を決めておく必要があります。保存をUTCに統一し、表示する段階で日本時間に変換すると、サーバーの設定やサマータイムの影響を受けにくくなります。
秒とミリ秒を混ぜない。 ログやAPIの仕様によって、秒単位とミリ秒単位が混在することがあります。値の桁数を確認し、受け取った時点で単位を揃える処理を入れておくと、日時がずれる事故を防げます。
うるう秒は考慮されない。 Unixタイムスタンプは、1日を86400秒として数えるため、うるう秒を反映しません。秒単位の精度が必要な用途では、この前提を理解しておく必要があります。
タイムスタンプ自体には含まれません。表示や変換の段階で、JSTやUTCなどのタイムゾーンを指定します。
32ビットの符号付き整数で時刻を扱う環境では起こり得ます。64ビットの環境では、実用上の問題はほとんどありません。
約1000倍の値になるため、日時が遠い未来にずれます。桁数を確認して、単位を統一してください。
Unixタイムスタンプは、1970年からの経過秒数(またはミリ秒数)で日時を表す仕組みです。桁数で秒・ミリ秒を見分け、タイムゾーンの違いに注意すれば、ログやAPIの日時データを正確に読み取れます。
実際の変換はタイムスタンプ変換ツールから、JST・UTC・ISO 8601・相対時間表示まで、まとめて確認できます。