【JavaScript ECMAScript】Date::Date.prototype.toTemporalInstantインスタンスメソッドの使い方

Date.prototype.toTemporalInstant()メソッドは、既存のJavaScriptのDateオブジェクトが表す特定の時点を、新しいTemporal APIのTemporal.Instantオブジェクトへ変換するメソッドです。Temporal APIは、JavaScriptにおける日付と時刻の処理をより堅牢かつ柔軟にするための新しい標準提案であり、このメソッドはその移行を支援します。

具体的には、Dateオブジェクトが保持するミリオ秒精度のUNIXエポックからの経過時間を基に、Temporal.Instantオブジェクトを生成します。Temporal.Instantは、特定のタイムゾーンやカレンダーシステムに依存せず、絶対的な時間の特定の時点をナノ秒単位の精度で表すことを目的としています。これにより、タイムゾーンの考慮が不要な、純粋な時間点に関する操作が可能になります。

このメソッドを使用することで、現在利用しているDateオブジェクトの値を、Temporal APIが提供する豊富な機能や高精度な時間操作の恩恵を受けられる新しい時間の表現形式へスムーズに移行させることができます。例えば、異なるタイムゾーン間の時間計算や、より複雑な時間間隔の処理を行う際に、Temporal.Instantが基点となり、正確な時間管理を実現します。新しい日付・時刻APIへの対応を検討する際に、既存コードとの連携を図る上で重要な役割を果たすメソッドです。

Copy
1const dateObject = new Date();
2const temporalInstant = dateObject.toTemporalInstant();

引数なし

引数はありません

Temporal.Instant

このメソッドは、Dateオブジェクトの値をUTC（協定世界時）の時点として表すTemporal.Instantオブジェクトを返します。Temporal.Instantは、特定の時刻を正確に表現するための、よりモダンで堅牢なデータ型です。