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

Temporal.ZonedDateTime.prototype.round()メソッドは、Temporal.ZonedDateTimeオブジェクトが保持する日時情報を、指定された精度で丸める（端数処理する）ために実行するメソッドです。

Temporal.ZonedDateTimeは、特定の日付と時刻にタイムゾーンの情報を組み合わせた、厳密な日時表現を行うオブジェクトです。このround()メソッドを利用することで、例えば秒単位や分単位、あるいは時間単位といった、より粗い粒度で日時を調整できます。

具体的には、丸めたい時間単位（年、月、日、時、分、秒、ミリ秒など）と、どのように端数を処理するか（例えば、最も近い値への四捨五入、常に切り上げ、常に切り捨てなど）をオプションとして指定できます。これにより、元のZonedDateTimeオブジェクトの正確さを保ちつつ、用途に応じた柔軟な日時調整が可能となります。

このメソッドは、元のオブジェクトを変更することなく、丸められた新しいZonedDateTimeオブジェクトを生成して返します。システムにおいて、UI表示のために特定の粒度で時刻を揃えたい場合や、データ集計の際に特定の時間単位で日時を正規化する必要がある場合に、非常に有用です。初心者の方でも、日付と時刻の正確な扱い方を学ぶ上で、このメソッドは日時計算の基礎として役立ちます。

Copy
1const zonedDateTimeInstance = new Temporal.ZonedDateTime(
2  Temporal.Instant.from('2023-10-27T10:30:45.123456789Z'),
3  'America/Los_Angeles'
4);
5
6const roundedZonedDateTime = zonedDateTimeInstance.round({
7  smallestUnit: 'minute',
8  roundingMode: 'halfExpand'
9});

roundTo, options

• roundTo: 丸めの単位を指定します。'year', 'month', 'week', 'day', 'hour', 'minute', 'second', 'millisecond', 'microsecond', 'nanosecond' のいずれかの文字列を指定します。
• options: オブジェクト。丸めの挙動を制御するオプションを指定します。largestUnit、smallestUnit、remainder、roundingMode、roundingIncrement を指定できます。

Temporal.ZonedDateTime

Temporal.ZonedDateTime.prototype.round() メソッドは、指定された時間単位で丸められた新しい Temporal.ZonedDateTime オブジェクトを返します。