Skip to main content
Temporal.DifferenceOptions.largestUnit - Temporal - Web documentation
property Temporal.DifferenceOptions.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.

Type