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

Temporal.PlainTime.prototype.since()メソッドは、あるPlainTimeオブジェクトが、比較対象となる別のPlainTimeオブジェクトよりもどれだけ前に位置するか、つまり2つの時刻間の時間差分を計算し、Temporal.Durationオブジェクトとして返却するメソッドです。

このメソッドは、日付情報を含まない純粋な時刻（例: 午後3時30分）のみを扱い、その差分を正確に測定する場面で非常に有用です。例えば、会議の開始時刻と終了時刻、特定の作業が始まった時刻と終わった時刻など、日付の概念を考慮せずに時刻の期間を調べたい場合に利用されます。

メソッドの引数には、比較の基準となる別のPlainTimeオブジェクトを指定します。この時、もし引数で指定した時刻が、メソッドを呼び出したPlainTimeオブジェクトよりも前の時刻である場合、返されるDurationオブジェクトは正の値となります。逆に、引数の時刻が呼び出し元の時刻よりも後の場合は、負の値として期間が表現されます。これにより、「いつからどれくらいの時間が経過したか」や「いつまでどれくらいの時間が残っているか」といった時間差を、一貫した形で得ることが可能です。

計算結果は、時間、分、秒、ミリ秒などの各時間単位で構成されるTemporal.Durationオブジェクトとして提供されます。また、オプション引数を使用することで、計算する時間単位や、端数の丸め方を細かく制御できるため、多様なニーズに応じた柔軟な時間差計算が実現できます。このsince()メソッドは、時間管理を必要とするシステム開発において、信頼性の高い時刻期間計算を可能にする重要な機能です。

Copy
1const plainTime = new Temporal.PlainTime(12, 30);
2const otherPlainTime = new Temporal.PlainTime(10, 0);
3const duration = plainTime.since(otherPlainTime);

other, options

• other: Temporal.PlainTime: 比較対象となる別の Temporal.PlainTime オブジェクト
• options: object: オプションを指定するオブジェクト（省略可能）

Temporal.Duration

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