Skip to content

minUtc

minUtc(utcDateTimes: string[]): string | null

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.
ParameterTypeDescription
utcDateTimesstring[]Array of ISO datetime strings (e.g. “2024-03-10T12:00:00Z”)

The earliest UTC datetime string, or null on invalid input

import { minUtc } from "@northguild/gmt/utc/calculate";
minUtc(["2024-03-10T12:00:00Z", "2024-03-15T12:00:00Z", "2024-03-12T12:00:00Z"]) // "2024-03-10T12:00:00Z"
utcDateTimes
output 

utc/calculate/minUtc.ts