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

Temporal.PlainDateTime.prototype.daysInYearプロパティは、Temporal.PlainDateTimeオブジェクトが表す日付が属する年の総日数を保持するプロパティです。このプロパティは、その年が平年か閏年（うるうどし）かに応じて、年間の日数を数値として提供します。具体的には、2月が29日ある閏年であれば366を返し、2月が28日である平年であれば365を返します。

Temporal.PlainDateTimeはタイムゾーン情報を含まない日付と時刻のオブジェクトであるため、このプロパティが返す値は、インスタンスが保持する日付情報のみに基づいて、グレゴリオ暦におけるその年の日数を正確に示します。例えば、2024年のような閏年の日付インスタンスからこのプロパティにアクセスすると366が返され、2023年のような平年の日付インスタンスからは365が返されます。

システムエンジニアが日付計算を行う際、特定の年の正確な日数を把握することは非常に重要です。このプロパティを使用することで、開発者は手動で閏年の判定ロジックを実装することなく、信頼性の高い方法で年間の日数を取得できます。これにより、日付に関連する処理のコードが簡潔になり、年間イベントのスケジュール調整や期間の正確な算出など、さまざまな場面で効率的かつ正確な日付操作を実現できます。

Copy
1const plainDateTime = new Temporal.PlainDateTime(2024, 1, 1);
2const days = plainDateTime.daysInYear;

引数なし

引数はありません

number

そのPlainDateTimeオブジェクトの年における日数を示します。