isValidUtcInterval

Signature

isValidUtcInterval(start: string, end: string): boolean

import { isValidUtcInterval } from "@northguild/gmt/utc/interval";

Return true if start and end form a valid UTC interval — both parseable as

• ISO UTC datetime strings and the instant at start is <= the instant at end.
• Both inputs must be ISO 8601 UTC datetime strings (e.g. "2024-01-01T10:00:00Z").
• Equal start === end is valid.
• Leap-second strings return false.
• Invalid input or malformed strings return false.

Parameters

Parameter	Type	Description
start	string	ISO 8601 UTC datetime string (interval start)
end	string	ISO 8601 UTC datetime string (interval end)

Returns

true if start and end form a valid UTC interval, or false on invalid input

Examples

isValidUtcInterval("2024-01-01T10:00:00Z", "2024-12-31T23:59:59Z") // true
isValidUtcInterval("2024-01-01T10:00:00Z", "2024-01-01T10:00:00Z") // true
isValidUtcInterval("2024-12-31T23:59:59Z", "2024-01-01T10:00:00Z") // false
isValidUtcInterval("invalid", "2024-12-31T23:59:59Z") // false

Source

utc/interval/validate/isValidUtcInterval.ts