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

Temporal.PlainDateTime.prototype.equals()メソッドは、あるTemporal.PlainDateTimeオブジェクトが、別のTemporal.PlainDateTimeオブジェクトと完全に等しいかどうかを比較し、その結果を真偽値で返すメソッドです。このメソッドは、引数として比較対象となる別のTemporal.PlainDateTimeオブジェクトを一つ受け取ります。

比較の結果、両方のPlainDateTimeオブジェクトが持つ日付と時刻のすべての要素、具体的には年、月、日、時間、分、秒、ミリ秒、マイクロ秒、ナノ秒がそれぞれ完全に一致する場合にtrueを返します。もしこれらの要素のうち、一つでも異なる部分があれば、falseを返します。

このメソッドは、JavaScriptの通常の比較演算子（==や===）ではオブジェクトの参照先が同じであるかどうかの比較になるため、オブジェクトの内容である日付や時刻の具体的な値を正確に比較したい場合に非常に重要です。例えば、アプリケーション内でユーザーが入力した特定の日付と、システムが保持している日付データが厳密に一致するかどうかを確認する際などに活用できます。日付や時刻の厳密な等価性を判定するロジックをシンプルかつ正確に記述するために、このequals()メソッドが提供されています。

Copy
1const plainDateTimeInstance = new Temporal.PlainDateTime(2023, 1, 1, 12, 0, 0);
2const otherPlainDateTimeInstance = new Temporal.PlainDateTime(2023, 1, 1, 12, 0, 0);
3const areEqual = plainDateTimeInstance.equals(otherPlainDateTimeInstance);

other

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

boolean

指定されたTemporal.PlainDateTimeインスタンスが、別のTemporal.PlainDateTimeインスタンスと年、月、日、時、分、秒、ミリ秒、マイクロ秒、ナノ秒のすべてにおいて等しい場合に true を、そうでない場合に false を返します。