getLargestTimeDurationUnit
Signature
Section titled “Signature”getLargestTimeDurationUnit(units: TimeDurationUnit[]): TimeDurationUnitimport { getLargestTimeDurationUnit } from "@northguild/gmt/plain/calculate";Return the largest TimeDurationUnit from the provided array.
- Returns the largest unit based on Temporal’s unit order: hours > minutes > seconds > milliseconds > microseconds > nanoseconds.
- Defaults to “seconds” if no valid unit is found in the array.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
units |
TimeDurationUnit[] |
array of TimeDurationUnits to evaluate |
Returns
Section titled “Returns”the largest TimeDurationUnit found in the array, or “seconds” if none are valid
Related types
Section titled “Related types”Examples
Section titled “Examples”getLargestTimeDurationUnit(["minutes", "seconds"]) // "minutes"getLargestTimeDurationUnit(["seconds", "milliseconds"]) // "seconds"getLargestTimeDurationUnit(["milliseconds", "microseconds"]) // "milliseconds"getLargestTimeDurationUnit([]) // "seconds"