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

Temporal.ZonedDateTime.prototype.daysInMonthプロパティは、Temporal.ZonedDateTimeオブジェクトが表す特定の月の総日数を取得できるプロパティです。JavaScriptのTemporal APIは、既存のDateオブジェクトが持つ複雑さや問題を解決し、日付と時刻をより堅牢かつ直感的に扱うために設計された新しいグローバルオブジェクトです。その中でもZonedDateTimeは、日付、時刻、そしてタイムゾーンという三つの要素を完全に保持することで、地球上の特定の場所における正確な瞬間を表現します。

このdaysInMonthプロパティは、ZonedDateTimeインスタンスが指し示す月が何日あるかという情報を、数値として提供します。例えば、2月であればそれが28日か29日か（うるう年かどうか）、4月であれば30日か31日かといった、月によって異なる日数を開発者が意識することなく、正確に把握することが可能です。カレンダーの表示や、特定の日付から月末までの日数を計算するような処理において、非常に便利で信頼性の高い情報源となります。

daysInMonthはアクセサープロパティであるため、関数のように呼び出す必要はなく、直接プロパティ名で参照することでその月の総日数の値を取得できます。これにより、開発者は煩雑な日付計算ロジックを自身で実装することなく、シンプルに月の日数情報を利用できます。特定のタイムゾーンにおける月の日数を正確に知りたい場合に活用される、モダンな日時処理のための重要な要素の一つです。

Copy
1const myZonedDateTime = Temporal.ZonedDateTime.from({
2  year: 2024,
3  month: 7,
4  day: 20,
5  timeZone: 'America/New_York'
6});
7const days = myZonedDateTime.daysInMonth;

引数なし

引数はありません

number

このプロパティは、その日付の月の日数を表す数値を返します。