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

Temporal.Duration.prototype.round()メソッドは、Temporal.Duration オブジェクトが表す時間の長さを、指定された単位に基づいて丸めるために使用するメソッドです。このメソッドは、秒、分、時間、日などの特定の時間単位で期間を四捨五入、切り上げ、切り捨て、または切り詰める柔軟な機能を提供します。

システムにおいて時間の期間を扱う際、例えば「2時間35分52秒」のような詳細な期間を「約2時間36分」や「約2時間」のように、より大きな単位で表現したい場面があります。Temporal.Duration.prototype.round()メソッドは、このような要件に対応し、期間を特定の精度に揃えることを可能にします。

このメソッドを使用する際には、丸めの最小単位 (smallestUnit)、最大の単位 (largestUnit)、丸め方 (roundingMode)、そして丸めの増分 (roundingIncrement) といったオプションをオブジェクトとして指定します。これにより、例えば5分単位で丸める、または常に切り上げるなど、期間の丸め処理を細かく制御できます。

Temporal.Duration.prototype.round()メソッドは、呼び出されると、元のDurationオブジェクトを変更することなく、丸め処理が適用された新しいTemporal.Durationオブジェクトを返します。元のオブジェクトの不変性（イミュータビリティ）が保たれるため、プログラムの予測可能性が向上し、安全なコードを記述できます。

Copy
1const durationInstance = Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 45.678 });
2const roundedDuration = durationInstance.round({
3  smallestUnit: 'second'
4});

roundTo

• roundTo: Temporal.DurationLike | string: 丸め処理の基準となる時間単位。Temporal.DurationLike オブジェクト（例: { years: 1 }）または時間単位を表す文字列（例: 'year'）を指定します。

Temporal.Duration

このメソッドは、指定された丸め方で丸められた新しいTemporal.Durationオブジェクトを返します。