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

Temporal.PlainTime.prototype.until()メソッドは、ある時刻から別の時刻までの期間を計算するメソッドです。これは日付やタイムゾーンの概念を含まない、純粋な時間情報（例えば、午前9時30分や午後5時15分など）を表すTemporal.PlainTimeオブジェクトに対して使用されます。

このメソッドは、メソッドを呼び出す元のTemporal.PlainTimeオブジェクトから、引数として渡されたもう一つのTemporal.PlainTimeオブジェクトまでの時間差を計測します。その結果として、計算された期間を表すTemporal.Durationオブジェクトを返します。Temporal.Durationオブジェクトは、時間、分、秒などの単位で時間の長さを正確に保持します。

計算の際には、期間の基準となる単位（例えば、hoursやminutesなど）や、期間をどのように丸めるかといったオプションを指定することができます。これにより、特定の粒度で時間差を求めたり、端数を切り捨てたり四捨五入したりといった柔軟な処理が可能です。

このメソッドを活用することで、日付やタイムゾーンの影響を受けずに純粋な時間ベースの計算を正確に行うことができます。例えば、イベント間の所要時間の計算、特定の時刻までの残り時間の算出、あるいはタイマー機能の実装など、時間のみを扱う多様なシナリオにおいて、時刻の比較や差分計算を容易にし、より堅牢なアプリケーション開発に貢献します。

Copy
1const startPlainTime = Temporal.PlainTime.from('09:00:00');
2const endPlainTime = Temporal.PlainTime.from('17:30:00');
3const duration = startPlainTime.until(endPlainTime);

other, options = {}

• other: Temporal.PlainTime: 比較対象となる他の PlainTime オブジェクト
• options: object = {}: オプションを指定するオブジェクト（デフォルトは空オブジェクト）

Temporal.Duration

このメソッドは、呼び出し元の PlainTime オブジェクトと、引数で指定された PlainTime オブジェクトとの間の時間差を Temporal.Duration オブジェクトとして返します。