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

Temporal.PlainDateTime.prototype.inLeapYearプロパティは、Temporal.PlainDateTimeオブジェクトが表す日付の年が閏年であるかどうかを示す真偽値（trueまたはfalse）を保持するプロパティです。

Temporal.PlainDateTimeは、タイムゾーンに依存しない日付と時刻の情報をカレンダーシステムに従って表現するためのオブジェクトです。このinLeapYearプロパティは、そのTemporal.PlainDateTimeインスタンスが保持する日付情報に基づき、関連する年が閏年であるかを判断します。具体的には、プロパティにアクセスすると、その日付の年が閏年であればtrueを返し、そうでなければfalseを返します。

例えば、2024年2月29日を表すTemporal.PlainDateTimeインスタンスのinLeapYearプロパティを参照するとtrueが得られますが、2023年2月29日（存在しない日付）ではなく、2023年内の任意の日付インスタンスであればfalseが返されます。このように、開発者は閏年の複雑な判定ロジックを自身で記述することなく、シンプルかつ正確に日付の閏年情報を取得できます。

このプロパティは、ある日付が閏年に属するかどうかをプログラムで確認したい場合や、閏年を考慮した日付計算を行う際に特に有用です。Temporal APIの一部として、日付に関する堅牢な機能を提供し、閏年の判定を効率的に行うための標準的な手段を提供します。

Copy
1const plainDateTime = new Temporal.PlainDateTime(2024, 1, 1);
2const isLeapYear = plainDateTime.inLeapYear;

引数なし

引数はありません

boolean

このメソッドは、Temporal.PlainDateTimeオブジェクトがうるう年を表すかどうかを判定し、その結果を真偽値（trueまたはfalse）で返します。