ISO 8601 から UNIX タイムスタンプ

ISO 日付から秒数を計算

タイムゾーンが明示された ISO 8601 の日時を Unix 秒へ変換します。API の要求、予約処理、データベースの列が Unix 秒を必要とし、手元の日時に時差が書かれている場合に使います。2024-01-01T00:00:00Z のように Z で UTC を示すか、数値のオフセットを付けた完全な ISO 形式を入力してください。Z もオフセットもない日時は拒否し、ブラウザーのローカルタイムゾーンによって結果が黙って変わることを防ぎます。

1970-01-01T00:00:00Z から秒数を数える前に、記載されたタイムゾーンオフセットを適用します。記載された時計時刻をそのオフセット分だけ UTC にずらし、1970 年のエポックから数えます。したがって 2024-01-01T02:00:00+02:00 と 2024-01-01T00:00:00Z は同じ秒数になります。小数部の一～三桁は保持します。無効な暦の日付、秒の欠落、うるう秒は推測で補わずエラーとして報告します。

瞬間を表す二つの方法

数値の結果は UTC エポックからの秒数です。時計の表示が異なる二つの ISO 文字列でも、オフセットによって同じ瞬間を示すなら同じ数値になります。ISO 入力には明示的なタイムゾーンが必要です。うるう秒とミリ秒を超える精度は、このツールの対象外です。オフセットはその瞬間の時計時刻と UTC との差を表し、夏時間の規則を持つ地域名と同じではありません。この変換は入力に書かれたオフセットを適用し、ISO 出力では UTC を表示します。タイムゾーンのない日時は、ローカル時刻と UTC のどちらと解釈するかで瞬間が変わり得るため、意図的に拒否します。23:59:60 のようなうるう秒は、ここで使う標準の Date 計算の対象外です。ミリ秒より細かい小数も対象外で、非常に遠い年はブラウザーの日付範囲に制限されます。タイムスタンプを貼り付ける前に単位を確認してください。ミリ秒の数値は秒の数値の千倍です。

オフセット、精度、カレンダーのトラブル

末尾の Z は UTC を明示します。+02:00 のオフセットがある日時では、書かれた時計の時刻は UTC より 2 時間進んでいるため、秒数を求める際にはその分を戻します。タイムゾーンを省いた日時は解釈によって答えが変わるので拒否します。API の欄へ入力する前に、単位が秒かミリ秒か、小数秒を受け付けるかを確認してください。このツールが保持する精度は最大でミリ秒であり、数値のオフセットから地域名付きのタイムゾーンを推測しません。

具体例では、入力 2024-01-01T00:00:00.000Z から 1704067200 が得られます。別のアプリケーションと比較するときは元の値も結果の横に残してください。次に出力を逆方向へ変換し、同じ瞬間を表しているか確かめます。タイムゾーンの表記や小数の形式が異なっても、ミリ秒の精度で同じ瞬間を示す場合があります。後で監査が必要になるときに備え、元のタイムゾーン表記も保存してください。