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

Temporal.Instant.prototype.round()メソッドは、Temporal.Instantオブジェクトが表す特定の時点を、指定された単位で丸める（四捨五入する）ために実行するメソッドです。このメソッドは、エポックからのナノ秒数で表現される厳密な時点を、より大きな単位（例えば、秒、分、時間など）で表現し直したい場合に利用されます。

引数には、丸めたい単位（例: 'hour', 'minute', 'second', 'millisecond'など）を示す文字列と、丸め方を示すオプションオブジェクトを渡すことができます。オプションオブジェクトでは、丸めアルゴリズム（例: 'halfExpand'は通常の四捨五入、'ceil'は切り上げ、'floor'は切り捨て、'trunc'はゼロ方向への切り捨て）を指定できます。これにより、時刻データの表示精度を調整したり、特定の時間単位で集計するための準備を行ったりすることが可能です。

round()メソッドは、元のTemporal.Instantオブジェクトを変更せず、丸められた新しいTemporal.Instantオブジェクトを返します。したがって、このメソッドを呼び出すたびに、元のインスタンスとは独立した新しいインスタンスが生成されます。Temporal.Instantはタイムゾーンやカレンダー情報を持たないため、この丸め処理は純粋に絶対的な時間軸上で行われます。システムで時刻データを扱う際に、特定の精度に合わせる必要がある場合や、ユーザーインターフェースでの表示用に整形する場合に非常に有用です。

Copy
1const myInstant = Temporal.Instant.from('2023-10-27T10:30:45.123456789Z');
2const roundedInstant = myInstant.round({ smallestUnit: 'minute' });

roundTo

• roundTo: TemporalUnitまたは文字列: 丸め処理の単位を指定します。TemporalUnitインスタンス、または"year"、"month"、"week"、"day"、"hour"、"minute"、"second"、"millisecond"、"microsecond"、"nanosecond"などの時間単位を表す文字列を指定できます。

Temporal.Instant

指定された秒数、ミリ秒、マイクロ秒、ナノ秒のいずれかの精度に丸められた新しいTemporal.Instantオブジェクトを返します。