【JavaScript ECMAScript】Temporal::Temporal.PlainTime.compare静的メソッドの使い方

Temporal.PlainTime.compare()メソッドは、2つのTemporal.PlainTimeオブジェクトを比較し、その時刻の順序関係を示す数値を返すメソッドです。このメソッドは、Temporal.PlainTimeクラスの静的メソッドとして提供されており、特定のインスタンスに紐づくことなく直接クラス名から呼び出すことができます。

比較したい2つのTemporal.PlainTimeオブジェクトを引数として渡します。比較の結果は数値で返され、もし最初の引数で指定された時刻が2番目の引数で指定された時刻より前の場合は負の数が返されます。逆に、最初の引数の時刻が2番目の引数の時刻より後の場合は正の数が返されます。両方の時刻が完全に同じである場合には、ゼロが返されます。

この機能は、日付情報を含まない純粋な時刻情報のみに基づいて、時間の前後関係を判断したり、複数の時刻データを時刻順に並べ替えたりする際に非常に役立ちます。例えば、タスクの開始時刻と終了時刻を比較したり、イベントリストを時間順にソートしたりする際に、明確で簡潔な比較ロジックを実装することができます。これにより、システムの内部で時刻のソートやフィルタリングといった処理を効率的に行えるようになります。

Copy
1const plainTimeOne = new Temporal.PlainTime(9, 0, 0);
2const plainTimeTwo = new Temporal.PlainTime(17, 30, 0);
3const comparisonResult = Temporal.PlainTime.compare(plainTimeOne, plainTimeTwo);

one, two

• one: Temporal.PlainTime: 比較対象の1つ目の時間
• two: Temporal.PlainTime: 比較対象の2つ目の時間

number

2つのTemporal.PlainTimeオブジェクトを比較した結果を数値で返します。 -1は最初の時間が2番目の時間より前であることを、1は最初の時間が2番目の時間より後であることを、0は2つの時間が等しいことを示します。