【JavaScript ECMAScript】Temporal::Temporal.ZonedDateTime.prototype.toInstantインスタンスメソッドの使い方

Temporal.ZonedDateTime.prototype.toInstant()メソッドは、Temporal.ZonedDateTimeオブジェクトが表す特定のタイムゾーンにおける日付と時刻の情報を、タイムゾーンに依存しない絶対的な時点であるTemporal.Instantオブジェクトに変換するメソッドです。

Temporal.ZonedDateTimeは、日付、時刻、オフセット、およびタイムゾーンの名前を組み合わせて、地球上の特定の位置における特定の瞬間を表現します。これに対し、Temporal.Instantは、UNIXエポック（1970年1月1日00:00:00 UTC）からの経過時間をナノ秒単位で示す、世界中で一意の絶対的な時点を表します。つまり、Instantはタイムゾーンや夏時間の概念を含まず、どこから見ても同じ時間を指します。

このtoInstant()メソッドを呼び出すことで、ZonedDateTimeオブジェクトが持つタイムゾーン情報とその時点でのオフセットを正確に考慮し、その瞬間がUTC（協定世界時）のどの絶対的な時点に相当するかを計算します。そして、その計算結果を新しいTemporal.Instantオブジェクトとして返します。

システムエンジニアが異なるタイムゾーンのデータを扱う際、例えば、世界中のユーザーからのイベントログを収集して、それらをタイムゾーンの概念抜きで時系列順に並べたり、複数のタイムゾーンにまたがるシステム間の同期を正確に行ったりする場合に、この変換機能は非常に役立ちます。タイムゾーンの違いによる複雑さを解消し、純粋な時間軸上での比較や処理を可能にするために利用されます。このメソッドは引数を取りません。

Copy
1const zonedDateTimeInstance = Temporal.ZonedDateTime.from('2023-10-27T10:00:00+02:00[Europe/Berlin]');
2const instant = zonedDateTimeInstance.toInstant();

引数なし

引数はありません

Temporal.Instant

このメソッドは、指定された日付と時刻がUTC（協定世界時）でどの時点に相当するかを示すTemporal.Instantオブジェクトを返します。