UNPKG

@burglekitt/gmt

Version:

Temporal-based date and time utilities with timezone support and polyfill integration

17 lines (16 loc) 929 B
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;