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

Temporal.PlainYearMonth.prototype.eraプロパティは、Temporal.PlainYearMonthオブジェクトが表現する年月の、カレンダーシステムにおける「紀元（era）」を識別する文字列を保持するプロパティです。

Temporal.PlainYearMonthオブジェクトは、特定の日付やタイムゾーン情報を含まず、年と月のみを扱うオブジェクトです。このeraプロパティは、そのオブジェクトが使用するカレンダーシステムにおいて、当該の年月がどの紀元に属するかを示す文字列を提供します。

「紀元」とは、特定の日付の数え方の基準となる時代区分であり、例えばグレゴリオ暦では「CE」（Common Era）といった値が一般的です。和暦のような独自の歴史的区分を持つカレンダーシステムでは、「令和」や「平成」といった元号の文字列が返されます。

このプロパティを活用することで、開発者は異なるカレンダーシステム間でのデータ表示や処理において、各文化圏に合わせた正確な紀元情報を統一的に取得できます。特に、国際的なアプリケーションや、多種多様なカレンダー要件に対応するシステムを構築する際に、適切な紀元情報の表示や計算ロジックの実装に不可欠な、読み取り専用の文字列データとして機能します。

Copy
1const plainYearMonthInstance = new Temporal.PlainYearMonth(2023, 10);
2const eraIdentifier = plainYearMonthInstance.era;

引数なし

引数はありません

string

このプロパティは、Temporal.PlainYearMonthオブジェクトが表す年月の紀元（西暦、元号など）を文字列として返します。