@burglekitt/gmt
Version:
Temporal-based date and time utilities with timezone support and polyfill integration
16 lines (15 loc) • 786 B
TypeScript
/**
* Return the earliest (minimum) of the given ZonedDateTime values.
*
* - Returns null if the array is empty or contains no valid dates.
* - Validation is performed on each item in the array.
*
* @param zonedDateTimes Array of ISO ZonedDateTime strings
* @returns The earliest zoned datetime string, or null on invalid input
*
* @example minZoned(["2024-03-10T12:00:00[America/New_York]", "2024-03-15T12:00:00[America/New_York]"]) // "2024-03-10T12:00:00-05:00[America/New_York]"
* @example minZoned(["invalid", "2024-03-15T12:00:00[America/New_York]"]) // "2024-03-15T12:00:00-04:00[America/New_York]"
* @example minZoned(["invalid", "also invalid"]) // null
* @example minZoned([]) // null
*/
export declare function minZoned(zonedDateTimes: string[]): string | null;