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

Temporal.PlainYearMonth.prototype.daysInYearプロパティは、Temporal.PlainYearMonthオブジェクトが表す特定の年における総日数を保持するプロパティです。このプロパティは、JavaScriptの新しい日付時刻APIであるTemporalの一部であり、タイムゾーンや特定の時点を考慮せず、純粋に「年」と「月」の情報のみを扱います。

このプロパティにアクセスすると、対象の年がうるう年（閏年）であるかどうかを自動的に判断し、その年の正確な日数を数値として提供します。例えば、2024年2月を表すPlainYearMonthインスタンスからこのプロパティにアクセスした場合、2024年はうるう年であるため「366」という値が返されます。一方、2023年2月のインスタンスであれば、2023年は平年であるため「365」が返されます。

システム開発において、年間の日数を正確に知る必要があるカレンダー機能やデータ集計処理などで非常に有用です。開発者がうるう年の複雑な判定ロジックを自分で実装する手間を省き、より堅牢で簡潔な日付処理を可能にします。このプロパティは、日付計算の正確性を高め、コードの可読性と保守性を向上させることを目的としています。

Copy
1const plainYearMonth = new Temporal.PlainYearMonth(2024, 2);
2const days = plainYearMonth.daysInYear;

引数なし

引数はありません

Number

このプロパティは、その PlainYearMonth オブジェクトが表す年の各月の日数を表す整数を返します。