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

Temporal.Instant.prototype.equals()メソッドは、Temporal.Instantオブジェクトのインスタンスが、他のTemporal.Instantオブジェクトと完全に同じ時点を表しているかどうかを比較し、その結果を真偽値で返すメソッドです。このメソッドは、JavaScriptのTemporal APIの一部として提供され、特定の瞬間を正確に比較します。Temporal.Instantオブジェクトは、UTC協定世界時におけるエポック（1970年1月1日0時0分0秒UTC）からの経過ナノ秒数として、一瞬の時刻を表現します。equals()メソッドは、引数として渡された別のTemporal.Instantインスタンスと、自身の保持する時点が完全に一致するかどうかを判定します。比較対象のオブジェクトが自身と完全に同じ時点を指していれば「true」を、そうでなければ「false」を返します。この機能は、日時情報の厳密な比較が求められる場合に特に重要です。例えば、時間に基づくイベントの順序付けや、システム内で厳密な時刻同期が必要なアプリケーションにおいて、正確な時間の一致を確認するために不可欠です。本メソッドは、時間に関するロジックの正確性と信頼性向上に貢献します。

Copy
1const instantA = Temporal.Instant.from('2023-01-01T12:00:00Z');
2const instantB = Temporal.Instant.from('2023-01-01T12:00:00Z');
3
4const areEqual = instantA.equals(instantB);

other

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

boolean

2つのTemporal.Instantオブジェクトが同じ日時を表す場合にtrueを返します。それ以外の場合はfalseを返します。