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

Temporal.PlainYearMonth.prototype.inLeapYearプロパティは、Temporal.PlainYearMonthオブジェクトが表す年がうるう年であるかどうかを示す真偽値を保持する読み取り専用プロパティです。このプロパティは、対象の年がうるう年であればtrueを、そうでなければfalseを返します。

Temporal.PlainYearMonthは、JavaScriptの新しい日付時刻APIであるTemporalの一部で、日付の「日」情報を含まず、特定の「年」と「月」の組み合わせのみを表すオブジェクトです。例えば、2024年2月のように、年と月だけに着目したい場合に利用されます。inLeapYearプロパティは、このPlainYearMonthオブジェクトが指し示す年が、グレゴリオ暦におけるうるう年の規則（通常は4年に一度ですが、100で割り切れるが400で割り切れない年はうるう年ではないなどの例外があります）に従っているかを正確に判定します。

このプロパティは、カレンダー機能の開発、月ごとの日数計算、期間の検証など、日付や時間の扱いにおいて「年がうるう年であるか」の判定が必要となる場面で非常に有用です。開発者は、複雑なうるう年判定ロジックを自ら記述することなく、このプロパティを使用するだけで、正確かつ簡潔にその情報を取得できます。これにより、コードの可読性とメンテナンス性が向上し、日付計算の正確性を確保できます。

Copy
1const yearMonth = new Temporal.PlainYearMonth(2024, 2);
2const isInLeapYear = yearMonth.inLeapYear;

引数なし

引数はありません

戻り値なし

戻り値はありません