【JavaScript ECMAScript】Temporal::Temporal.ZonedDateTime.prototype.epochMillisecondsインスタンスアクセサプロパティの使い方

Temporal.ZonedDateTime.prototype.epochMillisecondsプロパティは、JavaScriptのTemporal.ZonedDateTimeオブジェクトが保持する特定の日時を、協定世界時（UTC）における1970年1月1日00時00分00秒（Unixエポック）からの経過ミリ秒数として表現した数値を保持するプロパティです。

Temporal.ZonedDateTimeは、日付、時刻、そして特定のタイムゾーン情報を組み合わせて表現する、ECMAScriptの新しいTemporal APIの一部です。このepochMillisecondsプロパティは、そのZonedDateTimeインスタンスが示す日時を、グローバルな時間基準であるUnixエポックからの経過ミリ秒数として数値で提供します。

このプロパティを利用することで、タイムゾーンの違いを意識することなく、異なる日時を数値として直接比較したり、システム内部で一貫した時間表現として扱ったりすることが可能になります。取得される値は常に整数であり、ミリ秒単位の精度を持ちます。このプロパティは読み取り専用のアクセサープロパティであるため、値を直接変更することはできません。Temporal.ZonedDateTimeインスタンスが表す日時が変わると、このプロパティの値も自動的に更新されます。システム開発において、タイムゾーンを考慮した日時計算や、異なるシステム間での日時連携を行う際に非常に有用な機能です。

Copy
1const zonedDateTime = new Temporal.ZonedDateTime(0n, "UTC");
2const epochMilliseconds = zonedDateTime.epochMilliseconds;

引数なし

引数はありません

Number

このプロパティは、ZonedDateTimeオブジェクトの表す時点を、UTC（協定世界時）の1970年1月1日午前0時からの経過ミリ秒数で取得します。