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

Temporal.PlainDate.prototype.monthsInYearプロパティは、Temporal.PlainDateオブジェクトが表現する日付が属するカレンダーシステムにおける、その年の月数を数値として保持するプロパティです。

これは、JavaScriptの新しい日時API「Temporal」のPlainDateインスタンスに付随する読み取り専用プロパティです。Temporal.PlainDateは、タイムゾーン情報を含まない日付データを扱いますが、内部的には使用しているカレンダーシステム（暦）の情報も保持しています。monthsInYearプロパティにアクセスすることで、そのPlainDateインスタンスが従う暦において、1年が何ヶ月で構成されているかを示す整数値を取得できます。

例えば、多くの地域で使われるグレゴリオ暦ではこのプロパティは常に12を返しますが、Temporal APIは多様なカレンダーシステムに対応するため、特定の暦によっては1年の月数が異なる場合があります。このプロパティを活用することで、開発者は異なる暦の特性をプログラムで適切に扱い、日付処理を柔軟かつ正確に実装できます。これは、日時情報を扱うシステム開発において、世界の多様な暦に対応する汎用的なプログラムを構築する上で重要な情報となります。

Copy
1const plainDate = new Temporal.PlainDate(2023, 10, 26);
2const monthsInYearCount = plainDate.monthsInYear;

引数なし

引数はありません

number

このプロパティは、その PlainDate オブジェクトが表す年の月数を数値で返します。