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

Temporal.PlainTime.prototype.equals()メソッドは、二つのTemporal.PlainTimeオブジェクトが完全に同じ時刻を表しているかどうかを比較するメソッドです。このメソッドは、比較したいもう一つのTemporal.PlainTimeオブジェクトを引数として受け取り、両方のオブジェクトが保持する「時」「分」「秒」「ミリ秒」「マイクロ秒」「ナノ秒」という全ての時間要素が厳密に一致するかどうかを評価します。もし全ての時間要素が一致していれば真（true）を、一つでも異なる要素があれば偽（false）を戻り値として返します。

このequals()メソッドの重要な特性は、時刻の比較においてタイムゾーンやカレンダーの情報を考慮しない点です。Temporal.PlainTimeオブジェクトは、特定のタイムゾーンやカレンダーに依存しない、純粋な「壁時計の時刻」を表現するように設計されています。したがって、このメソッドは、純粋な時刻の数値的な構成要素のみに着目し、それらが同一であるか否かを判断します。例えば、午前9時30分00秒を表す二つのTemporal.PlainTimeオブジェクトが、ミリ秒以下の単位まで含めて完全に同一の時刻であるかを確認する際に非常に有用です。システム内で時刻データを扱う際に、タイムゾーンの違いを考慮せず、純粋な時刻値の一致だけを確認したい場合に役立ちます。

Copy
1const plainTimeInstance1 = new Temporal.PlainTime(9, 30, 0);
2const plainTimeInstance2 = new Temporal.PlainTime(9, 30, 0);
3
4plainTimeInstance1.equals(plainTimeInstance2);

other

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

boolean

このメソッドは、比較対象の Temporal.PlainTime オブジェクトが、この Temporal.PlainTime オブジェクトと等しい場合に true を、そうでない場合に false を返します。