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

Temporal.ZonedDateTime.prototype.monthsInYearプロパティは、Temporal.ZonedDateTimeオブジェクトが表現する日付の年が持つ月数を保持するプロパティです。このプロパティは、JavaScriptの新しい日付時刻APIであるTemporalの一部であり、特定の日付、時刻、タイムゾーン、そしてカレンダーシステムを扱うZonedDateTimeインスタンスに利用されます。

monthsInYearプロパティは、ZonedDateTimeインスタンスに設定されたカレンダーシステムに基づいて、その年の月数を数値として返します。例えば、一般的なグレゴリオ暦を使用している場合、この値は通常12です。しかし、ユリウス暦や一部の太陰太陽暦のような、異なるカレンダーシステムを採用している場合には、年間の月数が異なることがあります。このプロパティは、このようなカレンダー固有の情報を正確に提供します。

このプロパティは読み取り専用（アクセサープロパティのゲッター）であり、値を直接設定することはできません。ZonedDateTimeオブジェクトのcalendarプロパティを参照して、そのカレンダーが定義する年間の月数を動的に取得するために使用されます。

システムエンジニアを目指す初心者の方にとって、このmonthsInYearプロパティは、グローバルなアプリケーションや多言語対応のシステムを開発する際に、各カレンダーシステムの特性を考慮した日付処理を実装する上で非常に役立ちます。例えば、特定の年の月数を基にしたループ処理や、カレンダー表示のロジックを組む際に、このプロパティから得られる正確な情報が活用できます。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from('2023-10-27T10:00:00Z[America/Los_Angeles]');
2const monthsInYear = zonedDateTime.monthsInYear;

引数なし

引数はありません

Number

このプロパティは、その ZonedDateTime インスタンスが表す年の合計月数を数値で返します。