Unix タイムスタンプ変換（エポック ↔ 日時）

Unix タイムスタンプとは？

Unix タイムスタンプ（エポック時間、POSIX 時間）は、1970-01-01 00:00:00 UTC からの経過秒数で、うるう秒は数えません。タイムゾーンに関係なくある 1 つの瞬間を表すため、データベース、ログ、JWT の exp クレーム、API で使われています。タイムゾーンが関係するのは、その瞬間を人が読むカレンダーの日付と時刻に変換するときだけです。

秒・ミリ秒・マイクロ秒・ナノ秒のどれ？

プラットフォームによって数える単位が異なり、それを取り違えるのは典型的なバグです（1970 年や 55,000 年の日付になります）。このコンバーターは桁数を見て判別します。

コードで現在のタイムスタンプを取得する

// JavaScript
Math.floor(Date.now() / 1000)
# Python
import time; int(time.time())
# Bash
date +%s
-- PostgreSQL
SELECT extract(epoch FROM now());

タイムゾーンと夏時間

日付をタイムスタンプに変換するとき、現地時刻は選択した IANA タイムゾーン（たとえば Europe/Istanbul や America/New_York）で、ブラウザのタイムゾーンデータベースを使って解釈されます。夏時間が始まって時計が進む日には存在しない現地時刻があり、夏時間が終わって時計が戻る日には同じ現地時刻が 2 回現れます。その場合は早い方の瞬間が使われます。このような場合、ツールがお知らせします。

2038 年問題

秒数を符号付き 32 ビット整数で保存しているシステムは、2147483647、つまり 2038-01-19 03:14:07 UTC でオーバーフローします。最近のプラットフォームは 64 ビット値を使っていますが、古い組み込みシステムやデータベースのカラムは今も影響を受ける可能性があります。