minUtc
Signature
Section titled “Signature”minUtc(utcDateTimes: string[]): stringimport { minUtc } from "@northguild/gmt/utc/calculate";Return the earliest (minimum) of the given UTC datetime values.
- Filters invalid values before finding minimum using Temporal.Instant.compare.
- Returns null if array is empty or has no valid values.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
utcDateTimes |
string[] |
Array of ISO datetime strings (e.g. “2024-03-10T12:00:00Z”) |
Returns
Section titled “Returns”The earliest UTC datetime string, or null on invalid input
Examples
Section titled “Examples”minUtc(["2024-03-10T12:00:00Z", "2024-03-15T12:00:00Z", "2024-03-12T12:00:00Z"]) // "2024-03-10T12:00:00Z"minUtc(["invalid", "2024-03-15T12:00:00Z"]) // "2024-03-15T12:00:00Z"minUtc(["invalid", "also invalid"]) // nullminUtc([]) // null