Skip to content

isBeforeUtc

isBeforeUtc(value1: string, value2: string): boolean
import { isBeforeUtc } from "@northguild/gmt/utc/compare";

Return whether value1 represents an instant strictly before value2.

  • Uses Temporal.Instant.compare to compare instants.
  • Returns false if either input is invalid.
Parameter Type Description
value1 string first UTC datetime string
value2 string second UTC datetime string

true if value1 is before value2, otherwise false

isBeforeUtc("2024-03-17T14:30:45Z", "2024-03-17T15:30:45Z") // true
isBeforeUtc("2024-03-17T14:30:45Z", "2024-03-17T14:30:45Z") // false
isBeforeUtc("2024-03-17T14:30:45Z", "invalid") // false

utc/compare/isBeforeUtc.ts