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

Temporal.ZonedDateTime.prototype.offsetNanosecondsプロパティは、Temporal.ZonedDateTimeオブジェクトが保持する日付と時刻において、協定世界時（UTC）からの時間差（オフセット）をナノ秒単位で保持するプロパティです。

Temporal.ZonedDateTimeオブジェクトは、特定の日付、時刻、そしてタイムゾーン情報を組み合わせて時間を表現するものです。このプロパティは、その特定のZonedDateTimeインスタンスが属するタイムゾーンが、基準となるUTCに対してどれだけ進んでいるか、あるいは遅れているかをナノ秒という極めて細かい精度で数値として提供します。

例えば、日本標準時（JST）のようにUTCより9時間進んでいるタイムゾーンの場合、このプロパティは正のナノ秒値（9時間分のナノ秒）を返します。一方、UTCより遅れているタイムゾーンの場合、負のナノ秒値を返します。この値は常に整数です。

システムエンジニアが国際的なアプリケーションを開発する際や、タイムゾーンをまたいだイベントの正確な時刻同期、またはうるう秒などの特殊な時間調整を考慮した厳密な時間計算を行う際に、このナノ秒単位のオフセット情報を利用することができます。これにより、時間に関する非常に高度な要件にも対応できる正確な時間処理が可能になります。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from('2023-10-27T10:00:00-07:00[America/Los_Angeles]');
2const offsetNanoseconds = zonedDateTime.offsetNanoseconds;

引数なし

引数はありません

Number

このプロパティは、タイムゾーンオフセットのナノ秒単位の値を返します。