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

Temporal.ZonedDateTime.prototype.calendarIdプロパティは、JavaScriptのTemporal APIにおいて、Temporal.ZonedDateTimeオブジェクトが利用しているカレンダーシステムの識別子（ID）を文字列として保持するプロパティです。Temporal.ZonedDateTimeは、特定のタイムゾーンとカレンダー情報を持つ、具体的な日付と時刻を表すオブジェクトです。

このcalendarIdプロパティは、そのZonedDateTimeインスタンスが基づいているカレンダーの種類を識別するために使用されます。例えば、多くのシステムで標準的に用いられる「iso8601」や、日本の元号に基づいた日付計算を行う「japanese」など、様々なカレンダーがサポートされています。

システムエンジニアが国際化されたアプリケーションを開発する際、地域によって異なる日付表記や計算方法に対応する必要があります。このプロパティを参照することで、現在の日付時刻オブジェクトがどの文化圏のカレンダー規則に従っているのかをプログラムから簡単に確認できます。

Temporal.ZonedDateTimeインスタンスからこのプロパティにアクセスするだけで、そのインスタンスが保持するカレンダーIDの文字列値を取得することが可能です。このプロパティは読み取り専用であり、開発者がカレンダー情報を取得し、適切な日付処理を行う上で重要な役割を果たします。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from({
2  year: 2023,
3  month: 10,
4  day: 26,
5  timeZone: "Asia/Tokyo",
6  calendar: "iso8601"
7});
8const calendarId = zonedDateTime.calendarId;

引数なし

引数はありません

string

このプロパティは、Temporal.ZonedDateTime オブジェクトが使用しているカレンダーのIDを文字列で返します。例えば、「iso8601」や「gregory」といった値が返されます。