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

Temporal.PlainDateTime.prototype.eraYearプロパティは、JavaScriptのTemporal APIにおいて、Temporal.PlainDateTimeオブジェクトが保持する特定の日付の「紀元年」（era year）を数値で保持するプロパティです。

Temporal.PlainDateTimeは、タイムゾーンや夏時間の影響を受けない、純粋な日付と時刻の値を表現するためのオブジェクトです。このeraYearプロパティは、そのPlainDateTimeインスタンスが表す日付が、現在適用されている暦法（カレンダーシステム）において、特定の「紀元（era）」内での何年目にあたるかを示します。

例えば、日本の和暦のように、特定の元号（紀元）を基準として年数を数える暦法を使用する場合、このプロパティは「令和5年」の「5」といった紀元年数を返します。これは、単に西暦年（yearプロパティ）を返したり、紀元の開始年からの絶対的な年数を返したりするのではなく、選択された暦法に固有の紀元年を正確に表現するためのものです。

eraYearプロパティは読み取り専用のアクセサープロパティであり、値を設定することはできません。このプロパティにアクセスすることで、日付オブジェクトに格納されている紀年年の情報を安全に取得できます。国際化された日付表示や、特定の暦法に基づく複雑な日付計算が必要なシステム開発において、非常に強力な機能を提供します。

Copy
1const plainDateTimeInstance = Temporal.PlainDateTime.from({ year: 2023, month: 1, day: 15, calendar: "japanese" });
2const eraYearValue = plainDateTimeInstance.eraYear;

引数なし

引数はありません

Number

このプロパティは、Temporal.PlainDateTime オブジェクトの年の一部を、グレゴリオ暦における紀元（西暦）を表す数値で返します。