【JavaScript ECMAScript】Temporal::Temporal.PlainTime.prototype.roundインスタンスメソッドの使い方
Temporal.PlainTime.prototype.round()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Temporal.PlainTime.prototype.round()メソッドは、日付情報を含まない純粋な時間オブジェクトであるTemporal.PlainTimeインスタンスの時刻を、指定された最小単位で丸めるために使用されるメソッドです。
このメソッドは、丸めの基準となる最小単位（例えば、'second'や'minute'など）と、丸め処理の具体的な方法（例えば、四捨五入に相当する'halfExpand'、切り上げの'ceil'、切り捨ての'floor'など）をオプションオブジェクトとして受け取ります。これにより、秒未満の端数を切り捨てたり、最も近い分に丸めたりするなど、柔軟な時間操作が可能です。
round()メソッドは、元のTemporal.PlainTimeオブジェクトを変更することなく、丸められた新しいTemporal.PlainTimeオブジェクトを返します。この不変性は、予期せぬ副作用を防ぎ、より堅牢なコードを記述する上で重要です。
例えば、ユーザーインターフェースで時間を表示する際に秒単位まで表示する必要がない場合や、特定の時間単位でイベントをグループ化する際に便利です。時間の表示精度を調整したり、特定の時間単位でデータを集計したりする場面で、正確かつ意図した通りの丸め処理を実現できます。
公式リファレンス: Temporal.PlainTime.prototype.round()
構文(syntax)
1const plainTime = Temporal.PlainTime.from('12:34:56.789'); 2const roundedTime = plainTime.round({ smallestUnit: 'minute' });
引数(parameters)
roundTo
- roundTo: 時間を丸める単位を指定するオブジェクト
戻り値(return)
Temporal.PlainTime
指定された時間単位（例えば「秒」や「ミリ秒」）で丸められた新しいTemporal.PlainTimeオブジェクトを返します。