getLargestDateTimeDurationUnit
Signature
Section titled “Signature”getLargestDateTimeDurationUnit(units: (keyof DurationLike | DateTimeUnit)[]): keyof DurationLike | ""Return the largest DateTimeDurationUnit from the provided array.
- Returns the largest unit based on Temporal’s unit order: years > months > weeks > days > hours > minutes > seconds > milliseconds > microseconds > nanoseconds.
- Each unit may be singular or plural (
"day"or"days"), as Temporal accepts; the result is the plural name. - Returns "" when
unitsis not an array, is empty, or holds anything that is not a unit of this family. - Compatibility: before 1.16.0 an empty or invalid
unitsreturned a default unit ("seconds").
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
units | (keyof DurationLike | DateTimeUnit)[] | array of DateTimeDurationUnits (singular or plural names) to evaluate |
Returns
Section titled “Returns”the largest DateTimeDurationUnit found in the array, or "" on invalid input
Related types
Section titled “Related types”Examples
Section titled “Examples”import { getLargestDateTimeDurationUnit } from "@northguild/gmt/plain/calculate";
getLargestDateTimeDurationUnit(["hours", "minutes", "seconds"]) // "hours"