@burglekitt/gmt/dist/utc/compare/isBeforeUtc.js

Temporal-based date and time utilities with timezone support and polyfill integration

import { Temporal } from "@js-temporal/polyfill";
import { isValidUtc } from "../validate/index.js";
/**
 * Return whether `value1` represents an instant strictly before `value2`.
 *
 * - Uses Temporal.Instant.compare to compare instants.
 * - Returns false if either input is invalid.
 *
 * @param value1 first UTC datetime string
 * @param value2 second UTC datetime string
 * @returns `true` if `value1` is before `value2`, otherwise `false`
 *
 * @example isBeforeUtc("2024-03-17T14:30:45Z", "2024-03-17T15:30:45Z") // true
 * @example isBeforeUtc("2024-03-17T14:30:45Z", "2024-03-17T14:30:45Z") // false
 * @example isBeforeUtc("2024-03-17T14:30:45Z", "invalid") // false
 */
export function isBeforeUtc(value1, value2) {
    if (!isValidUtc(value1) || !isValidUtc(value2)) {
        return false;
    }
    try {
        const instant1 = Temporal.Instant.from(value1);
        const instant2 = Temporal.Instant.from(value2);
        return Temporal.Instant.compare(instant1, instant2) === -1;
    }
    catch {
        return false;
    }
}