@burglekitt/gmt
Version:
Temporal-based date and time utilities with timezone support and polyfill integration
17 lines (16 loc) • 891 B
TypeScript
import type { TimeDurationUnit } from "../../types/index.js";
/**
* 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.
*
* @param units array of TimeDurationUnits to evaluate
* @returns the largest TimeDurationUnit found in the array, or "seconds" if none are valid
*
* @example getLargestTimeDurationUnit(["minutes", "seconds"]) // "minutes"
* @example getLargestTimeDurationUnit(["seconds", "milliseconds"]) // "seconds"
* @example getLargestTimeDurationUnit(["milliseconds", "microseconds"]) // "milliseconds"
* @example getLargestTimeDurationUnit([]) // "seconds"
*/
export declare function getLargestTimeDurationUnit(units: TimeDurationUnit[]): TimeDurationUnit;