round method

  1. @Possible({RangeError})
  2. @useResult
DateTime round(
  1. TemporalUnit unit,
  2. int value
)

Returns a copy of this rounded to the nearest unit and value.

Contract

Throws RangeError if value <= 0.

Example

DateTime(2023, 4, 15).round(DateUnit.months, 6); // 2023-06-01 00:00
DateTime(2023, 8, 15).round(DateUnit.months, 6); // 2023-06-01 00:00

Implementation

@Possible({RangeError})
@useResult DateTime round(TemporalUnit unit, int value) => _adjust(unit, (date) => date.roundTo(value));