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

Temporal.ZonedDateTime.prototype.nanosecondプロパティは、JavaScriptのTemporal APIにおいて、Temporal.ZonedDateTimeオブジェクトが保持する時刻情報のうち、ナノ秒の値を読み取るためのプロパティです。Temporal.ZonedDateTimeは、特定の日付、時刻、およびタイムゾーン情報を組み合わせて、地球上の特定の一時点を厳密に表現するオブジェクトです。

このプロパティにアクセスすると、当該Temporal.ZonedDateTimeインスタンスが示す時刻の、ナノ秒成分が数値として返されます。ナノ秒は1秒の10億分の1にあたる非常に細かい時間単位であり、このプロパティは0から999までの整数値を保持します。例えば、ZonedDateTimeオブジェクトが「2024年1月1日 12時00分00秒.123456789」の時刻を表している場合、nanosecondプロパティは「789」という値を返します。

このプロパティは読み取り専用（accessor property）であり、Temporal.ZonedDateTimeオブジェクトのナノ秒を直接変更することはできません。高精度な時刻情報を扱うアプリケーションや、時間的な順序を極めて厳密に管理する必要があるシステムにおいて、詳細な時刻要素として利用されます。

Copy
1const instant = new Temporal.Instant(0n);
2const timeZone = new Temporal.TimeZone("UTC");
3const zonedDateTime = new Temporal.ZonedDateTime(instant, timeZone);
4
5const nanoseconds = zonedDateTime.nanosecond;

引数なし

引数はありません

number

このプロパティは、ZonedDateTimeオブジェクトが表す日時のナノ秒単位の値を数値で返します。