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

Temporal.PlainYearMonth.prototype.eraYearプロパティは、JavaScriptの新しい日付・時刻APIであるTemporalに属する、タイムゾーンやUTCオフセットを含まない特定の年と月を表すTemporal.PlainYearMonthオブジェクトの元号年を保持するプロパティです。このプロパティは、Temporal.PlainYearMonthオブジェクトに設定されている暦（カレンダーシステム）に基づいて、その暦における元号内の年数を数値として提供します。

例えば、日本の和暦のように、特定の元号とその元号内での年で日付を表現するカレンダーシステムを扱う場合に、このプロパティは非常に有用です。これにより、開発者はさまざまな国際的な暦表現に柔軟に対応できるようになります。

eraYearプロパティは読み取り専用であり、その値を直接変更することはできません。もし、関連付けられた暦システムが元号の概念をサポートしていない場合、このプロパティはundefinedを返します。システムエンジニアを目指す方にとって、国際化対応が求められるアプリケーション開発において、異なる暦体系での年数を正確に取得・表示するための基本的な理解として重要です。

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

引数なし

引数はありません

number

Temporal.PlainYearMonth.prototype.eraYear は、この年月のエラ年（グレゴリオ暦における西暦年）を表す数値です。