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

Temporal.ZonedDateTime.prototype.microsecondプロパティは、Temporal.ZonedDateTimeオブジェクトが保持する日付と時刻情報の中から、マイクロ秒の値を読み取るためのプロパティです。

Temporal.ZonedDateTimeオブジェクトは、特定のタイムゾーンにおける日付、時刻、およびそのオフセット情報を正確に表現するために使用されます。このmicrosecondプロパティは、そのTemporal.ZonedDateTimeインスタンスが示す時刻のマイクロ秒部分を数値として提供します。マイクロ秒は1秒の100万分の1にあたる時間の単位で、このプロパティからは0から999までの整数値が返されます。

このプロパティは読み取り専用であり、Temporal.ZonedDateTimeオブジェクトのマイクロ秒の値を直接設定することはできません。日付や時刻を高精度に扱いたい場合や、既存のTemporal.ZonedDateTimeオブジェクトから特定の時間要素（この場合はマイクロ秒）を取得して、時間計算や表示処理に利用したい場合に役立ちます。ECMAScriptのTemporal APIは、JavaScriptで日付と時刻をより堅牢かつ直感的に操作するための標準的な方法を提供しており、このmicrosecondプロパティはその時間要素の一つにアクセスするためのものです。

Copy
1const zonedDateTimeInstance = new Temporal.ZonedDateTime(
2  Temporal.Instant.from("2023-10-27T10:30:00.123456789Z").epochNanoseconds,
3  "UTC"
4);
5const microsecond = zonedDateTimeInstance.microsecond;

引数なし

引数はありません

number

Temporal.ZonedDateTime.prototype.microsecond は、この日付と時刻のオブジェクトが表す時刻のマイクロ秒（100万分の1秒）を表す数値を返します。この値は 0 から 999999 の範囲の整数です。