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

Temporal.PlainYearMonth.prototype.calendarIdプロパティは、JavaScriptのTemporal APIにおいて、特定の年と月を表すPlainYearMonthオブジェクトがどのカレンダーシステムに基づいているかを識別するための文字列を保持するプロパティです。

Temporal APIは、JavaScriptで日付と時刻を扱うための新しい標準として導入されました。その中でPlainYearMonthオブジェクトは、タイムゾーンや夏時間を考慮せず、純粋に「年」と「月」の情報のみを扱います。例えば、「2023年6月」といった情報を保持し、特定の「日」や「時刻」は含まれません。

このcalendarIdプロパティは、そのPlainYearMonthインスタンスがどのカレンダーシステム（暦）で表現されているかを一意に識別する文字列を提供します。現代のアプリケーション開発では、世界中の多様なカレンダーシステム（グレゴリオ暦、日本の和暦、イスラム暦など）を扱う必要があるため、Temporal APIではこれらのサポートを強化しています。

calendarIdの値は、例えばグレゴリオ暦であれば"iso8601"、日本の和暦であれば"japanese"のような標準化された文字列となります。このプロパティを参照することで、開発者は異なるカレンダーシステムで作成されたPlainYearMonthオブジェクトが、それぞれどの暦に基づいているのかを容易に確認し、適切に処理を分岐させたり、国際化された日付表示に対応したりすることが可能になります。calendarIdプロパティは読み取り専用であり、PlainYearMonthオブジェクトが作成された後にその値を変更することはできません。これは、日付と時刻の情報の正確性と一貫性を保証するために重要な特性です。

Copy
1const plainYearMonth = new Temporal.PlainYearMonth(2023, 10);
2const calendarIdentifier = plainYearMonth.calendarId;

引数なし

引数はありません

string

この calendarId プロパティは、Temporal.PlainYearMonth オブジェクトが使用しているカレンダーの識別子を文字列として返します。