largestUnit
The largest unit to allow in the resulting Temporal.Duration
object.
Larger units will be "balanced" into smaller units. For example, if largestUnit
is 'minute'
then a two-hour duration will be output as a 120-minute duration.
Valid values may include 'year'
, 'month'
, 'week'
, 'day'
, 'hour'
, 'minute'
, 'second'
, 'millisecond'
, 'microsecond'
, 'nanosecond'
and 'auto'
, although some types may throw an exception if a value is used that would produce an invalid result. For example, hours
is not accepted by Temporal.PlainDate.prototype.since()
.
The default is always 'auto'
, though the meaning of this depends on the type being used.