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

Temporal.PlainDate.prototype.inLeapYearプロパティは、Temporal.PlainDateオブジェクトが表す日付の年がうるう年であるかどうかを示すブール値を保持するプロパティです。JavaScriptのTemporal APIは、日付と時刻の処理をより堅牢で直感的にするための新しい標準であり、Temporal.PlainDateはその中でも、タイムゾーン情報を持たない純粋なカレンダー日付を表現するために使われるオブジェクトです。

このinLeapYearプロパティは、特定のTemporal.PlainDateインスタンスに対してアクセスすることで、その日付が属する年がうるう年であればtrueを、そうでなければfalseを返します。例えば、2024年はうるう年ですので、2024年の日付を持つPlainDateオブジェクトからこのプロパティにアクセスするとtrueが得られます。一方、2023年はうるう年ではないため、2023年の日付を持つPlainDateオブジェクトではfalseが返されます。

システムエンジニアを目指す初心者の方々にとって、日付の計算、特にうるう年の判定は、自力で実装しようとすると複雑な条件分岐が必要となり、間違いやすいポイントの一つです。このプロパティを利用することで、開発者はこのような複雑なロジックを自分で書く手間を省き、組み込みの正確な機能を使って、うるう年に関する日付処理を簡単かつ確実に実行できます。これは、記念日の計算、レポート生成、または特定のイベントのスケジュール調整など、日付を扱う多様なアプリケーション開発において非常に有用です。

Copy
1const plainDate = new Temporal.PlainDate(2024, 1, 1);
2const isInLeapYear = plainDate.inLeapYear;

引数なし

引数はありません

boolean

このプロパティは、Temporal.PlainDate インスタンスが閏年（うるうどし）であるかどうかを示す真偽値（true または false）を返します。