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

Temporal.ZonedDateTime.prototype.offsetプロパティは、Temporal.ZonedDateTimeオブジェクトが保持する、協定世界時（UTC）からのタイムゾーンオフセットを分単位で表す数値を保持するプロパティです。このプロパティは、特定の日付と時刻をタイムゾーン情報と共に扱うTemporal.ZonedDateTimeインスタンスに付随し、そのインスタンスが示す時点におけるUTCとの時間差を正確に取得するために使用されます。

Temporal.ZonedDateTimeは、夏時間（サマータイム）などのタイムゾーン規則によるオフセットの変動を考慮して時刻を扱いますが、offsetプロパティはまさにその時点での実際のオフセット値を分単位の整数で提供します。例えば、UTCより9時間進んでいるタイムゾーン（日本標準時など）の場合、このプロパティは540（9時間 × 60分）を返します。UTCより遅れているタイムゾーンであれば、負の値が返されます。

このプロパティは読み取り専用であり、ZonedDateTimeオブジェクトの持つタイムゾーンオフセットをプログラムから確認したい場合や、UTCからの絶対的な時間差に基づいて何らかの計算を行う際に利用されます。システムの正確な時刻処理において、現在のタイムゾーンオフセットを把握するための重要な情報源となります。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from("2023-10-27T10:00:00+09:00[Asia/Tokyo]");
2const offsetInSeconds = zonedDateTime.offset;

引数なし

引数はありません

戻り値なし

戻り値はありません