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