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

Temporal.ZonedDateTime.prototype.daysInYearプロパティは、Temporal.ZonedDateTimeオブジェクトが表す特定の年の総日数に関する情報を保持するプロパティです。このプロパティは、日付とタイムゾーンの情報を持つTemporal.ZonedDateTimeのインスタンスに対して使用され、そのインスタンスが指し示す年の正確な日数を数値として提供します。

具体的には、このプロパティは、指定された年がうるう年であるかどうかを自動的に判断し、その年に含まれる正確な日数を返します。例えば、2024年のようなうるう年であれば366を、2023年のような平年であれば365を返します。この機能は、日付計算を正確に行う上で非常に重要であり、開発者がうるう年の判定ロジックを自前で実装する手間を省き、より堅牢で正確な日付関連の処理を記述することを可能にします。

システム開発においては、ある年の総日数を把握することが多々あります。例えば、年間のレポートを生成する際に年内の日数を基準とした計算が必要な場合や、特定の年の残りの日数を計算するロジックを実装する場合、あるいは年間の計画や予算編成において日数を考慮する必要がある場合などに、このdaysInYearプロパティが役立ちます。Temporal.ZonedDateTimeはタイムゾーン情報も持つため、このプロパティが返す日数は、そのオブジェクトが表す特定のタイムゾーンと日付に基づいたものとなります。このプロパティは読み取り専用であり、直接値を変更することはできません。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from("2024-03-01T10:00:00+09:00[Asia/Tokyo]");
2
3const daysInYear = zonedDateTime.daysInYear;
4
5console.log(daysInYear);

引数なし

引数はありません

number

そのTemporal.ZonedDateTimeインスタンスが表す年における日数を返します。