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

Temporal.ZonedDateTime.prototype.millisecondプロパティは、Temporal.ZonedDateTimeオブジェクトのインスタンスが保持する、現在の時刻のミリ秒部分を示す数値を保持するプロパティです。このプロパティは、JavaScriptの新しい日付と時刻の操作を目的としたTemporal APIの一部として提供されます。

Temporal.ZonedDateTimeオブジェクトは、特定の日付、時刻、およびタイムゾーン情報を厳密に持つ時点を表します。このmillisecondプロパティにアクセスすることで、そのZonedDateTimeが示す時刻におけるミリ秒の値を数値として取得できます。取得される値は、0から999までの範囲で、現在の秒におけるミリ秒の精度を表します。

このプロパティは、特定のイベントの発生時刻をミリ秒単位で詳細に把握したい場合や、時間の比較、表示フォーマットの調整など、高精度な時間情報が必要となる場面で活用されます。millisecondは読み取り専用のアクセサープロパティであるため、既存のZonedDateTimeオブジェクトのミリ秒の値を読み取るために使用され、その値を直接変更することはできません。これにより、ZonedDateTimeオブジェクトが持つ時間情報の正確性と整合性が維持されます。タイムゾーンを考慮した上で、時間におけるミリ秒の要素を正確に取得する際に不可欠なプロパティです。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from('2023-10-27T10:30:45.123+09:00[Asia/Tokyo]');
2const millisecond = zonedDateTime.millisecond;

引数なし

引数はありません

number

このプロパティは、Date-Timeオブジェクトが表す瞬間のミリ秒部分を数値で返します。