Unixタイムスタンプ変換（エポック秒）

ログやAPIのタイムスタンプを読む

ログ、データベース、JWTの有効期限のフィールド、APIのレスポンスでは、時刻を1970年1月1日（UTC）からの秒数（またはミリ秒数）で保存しています。貼り付ければ、UTCと手元のタイムゾーンでの日時がわかります。単位は桁数から判別するので、1730000000も1730000000000も正しく変換されます。

タイムゾーンと2038年の上限

タイムスタンプにはタイムゾーンがありません。どこでも同じ瞬間を表し、変わるのは表示だけです。好きなタイムゾーンを選べば夏時間も含めた現地時刻がわかり、コード用にISO 8601の形式でコピーできます。日本時間（JST）はUTC+9です。タイムスタンプを符号付き32ビット整数で保存しているシステムは2038年1月19日3時14分7秒（UTC）で止まりますが、64ビットならその上限はありません。

APIでのタイムスタンプ

REST APIでは、書式付きの日付の文字列ではなくUnixタイムスタンプがよく使われます。タイムゾーンに依存せず、あいまいさがなく、コンパクトで、数値として比べやすいからです。1742045400のようなタイムスタンプは、サーバーやクライアントがどこにあっても、まったく同じ意味になります。

秒（Unixの標準）を使うAPIもあれば、ミリ秒（JavaScriptの標準）を使うAPIもあるので、必ずAPIのドキュメントを確認しましょう。見分け方はかんたんで、10桁なら秒、13桁ならミリ秒です。

タイムゾーンとUTC：バグの温床

タイムゾーンがらみのバグは、ソフトウェア開発でもっとも多いバグの1つです。UTCで保存したタイムスタンプは絶対的ですが、ユーザーのタイムゾーンで表示するには時差を知る必要があり、その時差は夏時間で変わります。日本には夏時間がないので気づきにくいのですが、海外のユーザーやサーバーが関わると問題になります。

ベストプラクティスは、タイムスタンプを常にUTC（またはUnixタイムスタンプ）で保存し、表示するときだけローカル時刻に変換することです。タイムゾーンの情報なしにローカル時刻を保存してはいけません。

コード例

現在のタイムスタンプの取得：JavaScriptでは、Date.now()がミリ秒を返すので、秒にはMath.floor(Date.now()/1000)を使います。Pythonのtime.time()は秒を浮動小数点数で返し、PHPのtime()は秒を、JavaのSystem.currentTimeMillis()はミリ秒を返します。

タイムスタンプから日時への変換：JavaScriptはnew Date(timestamp * 1000)、Pythonはdatetime.fromtimestamp(timestamp)、PHPはdate('Y-m-d H:i:s', timestamp)、SQLはMySQLならFROM_UNIXTIME(timestamp)、PostgreSQLならto_timestamp(timestamp)です。