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

Temporal.ZonedDateTime.prototype.timeZoneIdプロパティは、JavaScriptのTemporal APIにおいて、Temporal.ZonedDateTimeオブジェクトが保持しているタイムゾーンの識別子を取得するために用いられるプロパティです。Temporal.ZonedDateTimeは、特定の日時を、特定のタイムゾーンの規則に従って表現するオブジェクトであり、このプロパティはそのオブジェクトがどのタイムゾーンに属しているかを示します。

このプロパティにアクセスすることで、例えば「Asia/Tokyo」や「America/New_York」のようなIATAタイムゾーンデータベース形式の文字列値を取得することができます。この識別子は、Temporal.ZonedDateTimeインスタンスがどの地理的な地域や政治的な地域で時間を扱っているかを明確にし、日時の計算や表示において不可欠な情報となります。

システムエンジニアにとって、異なるタイムゾーンをまたぐシステムや、世界中のユーザーに対応するアプリケーションを開発する際に、日時の正確な処理は非常に重要です。timeZoneIdプロパティは、ZonedDateTimeオブジェクトが表現する時間の文脈を正確に把握し、タイムゾーンの差異によって発生する可能性のある問題を避けるために役立ちます。このプロパティは、ZonedDateTimeインスタンスの生成時に設定されたタイムゾーン情報を変更することはできず、常にその時点でのタイムゾーンの識別子を読み取り専用として提供します。

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

引数なし

引数はありません

String

このプロパティは、Temporal.ZonedDateTimeオブジェクトが表す日付と時刻のタイムゾーンの識別子を文字列として返します。例えば、"Asia/Tokyo"や"UTC"のような値になります。