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

Temporal.PlainDateTime.prototype.monthsInYearプロパティは、Temporal.PlainDateTimeオブジェクトが基づくカレンダーシステムにおける1年間の月数を数値で保持するプロパティです。

Temporal.PlainDateTimeは、JavaScriptの新しい日付と時刻を扱うTemporal APIの一部であり、タイムゾーン情報を含まず、純粋な日付と時刻を表現します。このプロパティは、特定のPlainDateTimeインスタンスが使用しているカレンダーにおいて、1年間がいくつの月で構成されているかを示します。

例えば、日常的に使用されるグレゴリオ暦では、このプロパティは常に12という値を返します。しかし、Temporal APIは様々なカレンダーシステムをサポートしており、カレンダーによっては1年の月数が12とは異なる場合があります。monthsInYearプロパティは、そのようなカレンダー固有の正確な月数を返します。

このプロパティを利用することで、開発者は現在扱っているPlainDateTimeオブジェクトが採用しているカレンダーの特性を把握し、それに基づいた日付の計算や表示を正確に行うことが可能になります。複数のカレンダーシステムに対応するアプリケーションや国際的なシステムを開発する際に、柔軟な日付処理の実装に役立ちます。

Copy
1const plainDateTime = new Temporal.PlainDateTime(2023, 1, 1);
2const numberOfMonths = plainDateTime.monthsInYear;

引数なし

引数はありません

Number

このメソッドは、その PlainDateTime オブジェクトが表す年において、何ヶ月あるかを数値で返します。