【JavaScript ECMAScript】Temporal::Temporal.PlainMonthDay.prototype.equalsインスタンスメソッドの使い方

Temporal.PlainMonthDay.prototype.equals()メソッドは、2つのTemporal.PlainMonthDayオブジェクトが同じ月と日を表しているかどうかを比較し、その結果を真偽値で返すメソッドです。Temporal APIは、JavaScriptにおける日付と時刻の複雑な処理をより簡単かつ正確に行うために設計された新しいグローバルオブジェクト群です。その中でもTemporal.PlainMonthDayは、年に関する情報を含まずに、月と日のみを表現するオブジェクトとして利用されます。例えば、「毎年5月1日」といった、年によらず固定の月日を扱う際に便利です。

このequals()メソッドは、引数として比較対象となる別のTemporal.PlainMonthDayオブジェクトを受け取ります。そして、呼び出し元のオブジェクトと引数で渡されたオブジェクトの月と日が完全に一致するかどうかを判定します。もし両者の月と日がまったく同じであればtrueを返し、一つでも異なる点があればfalseを返します。この機能は、アプリケーション内で特定の記念日やイベントが同一の日付であるかをプログラム的に確認する必要がある場合に非常に役立ちます。例えば、ユーザーが入力した月日が、あらかじめ設定された休日リストと一致するかどうかを効率的にチェックすることができます。正確な日付比較が求められるシステムにおいて、このequals()メソッドは重要な役割を果たします。

Copy
1const plainMonthDay1 = new Temporal.PlainMonthDay(1, 15);
2const plainMonthDay2 = new Temporal.PlainMonthDay(1, 15);
3plainMonthDay1.equals(plainMonthDay2);

other

• other: Temporal.PlainMonthDay: 比較対象となる別の PlainMonthDay オブジェクト

boolean

このメソッドは、呼び出し元の Temporal.PlainMonthDay オブジェクトと、引数で指定された Temporal.PlainMonthDay オブジェクトが等しいかどうかを示す真偽値（boolean）を返します。