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

Temporal.PlainDate.prototype.equals()メソッドは、2つのTemporal.PlainDateオブジェクトが同じ日付を表しているかどうかを比較するメソッドです。このメソッドは、呼び出し元のTemporal.PlainDateインスタンスと、引数として渡された別のTemporal.PlainDateインスタンスを比較します。具体的には、比較対象となる両方のオブジェクトの年、月、日という3つの要素が完全に一致するかどうかを判定します。

比較の結果、両方のTemporal.PlainDateオブジェクトがまったく同じ日付（例えば、両方とも2023年10月26日）を表している場合には、真を意味するブーリアン値のtrueを返します。もし年、月、日のいずれかの要素が異なる場合や、比較対象として有効なTemporal.PlainDateオブジェクトではない値が渡された場合には、偽を意味するfalseを返します。この比較では、タイムゾーンや時刻、あるいはカレンダーシステムの違いは考慮されず、純粋にカレンダー上の日付の同一性のみに着目します。

システム開発において、特定の日付データが別のデータと一致するかを確認する場面は多く存在します。例えば、イベントの日付がユーザーの入力した日付と同一であるか、あるいはデータベースから取得した日付が最新のデータと一致するか、といった厳密な日付の比較を行う際にこのequals()メソッドが非常に役立ちます。日付の同一性を正確かつ効率的に判定するための基本的な機能として利用されます。

Copy
1const plainDate1 = new Temporal.PlainDate(2023, 10, 26);
2const plainDate2 = new Temporal.PlainDate(2023, 10, 26);
3
4plainDate1.equals(plainDate2);

other

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

boolean

指定された2つの Temporal.PlainDate オブジェクトが同じ日付を表している場合に true を返します。それ以外の場合は false を返します。