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

Temporal.Duration.compare()メソッドは、2つのTemporal.Durationオブジェクトを比較し、それらの期間の相対的な順序を示す数値を返すメソッドです。このメソッドはTemporal.Durationクラスの静的メソッドとして提供されており、Temporal.Durationオブジェクトを生成することなく直接呼び出すことができます。

比較の際は、引数として渡された2つのTemporal.Durationオブジェクトが保持する年、月、週、日、時間、分、秒、ミリ秒、マイクロ秒、ナノ秒といった時間要素が順番に考慮されます。最初の期間が2番目の期間よりも短い場合は負の数（例: -1）を返し、両方の期間が等しい場合はゼロ（0）を返します。また、最初の期間が2番目の期間よりも長い場合は正の数（例: 1）を返します。

このメソッドは、複数の期間データをソートしたり、特定の期間が別の期間より長いか短いかを正確に判断したりする必要がある場面で非常に役立ちます。例えば、イベントの継続期間を比較して最も長いものを見つけたり、タスクの実行時間を比較して優先順位をつけたりする際に、一貫した比較ロジックを提供します。Temporal.Duration.compare()を使用することで、時間データの管理と操作をより堅牢に行うことが可能になります。

Copy
1const durationOne = Temporal.Duration.from({ hours: 1, minutes: 30 });
2const durationTwo = Temporal.Duration.from({ minutes: 90 });
3const comparisonResult = Temporal.Duration.compare(durationOne, durationTwo);

one, two

• one: 比較対象となる最初のTemporal.Durationオブジェクト
• two: 比較対象となる2番目のTemporal.Durationオブジェクト

number

Temporal.Duration.compare() メソッドは、2つの Temporal.Duration オブジェクトを比較した結果を表す数値（number）を返します。

• 戻り値が 1 の場合、最初の Duration オブジェクトが2番目の Duration オブジェクトよりも大きいことを示します。
• 戻り値が -1 の場合、最初の Duration オブジェクトが2番目の Duration オブジェクトよりも小さいことを示します。
• 戻り値が 0 の場合、2つの Duration オブジェクトは等しいことを示します。