@burglekitt/gmt/dist/unix/compare/areUnixEqual.js

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

import { Temporal } from "@js-temporal/polyfill";
import { isValidAmount } from "../../internal/index.js";
/**
 * Return whether `value1` and `value2` represent the same instant.
 *
 * - Uses Temporal.Instant.compare to check equality.
 * - Returns false if either input is invalid.
 *
 * @param value1 first unix epoch value
 * @param value2 second unix epoch value
 * @param options epoch unit and options
 * @returns `true` if `value1` and `value2` are equal, otherwise `false`
 *
 * @example areUnixEqual(1706659200, 1706659200) // true
 * @example areUnixEqual(1706659200, 1704067200) // false
 * @example areUnixEqual(1706659200, 1706659200000, { epochUnit: "seconds" }) // true
 * @example areUnixEqual(1706659200, 1706659200000) // false
 * @example areUnixEqual(-86400000, 0) // false (1969-12-31 is not equal to 1970-01-01)
 */
export function areUnixEqual(value1, value2, options) {
    const epochUnit = options?.epochUnit ?? "milliseconds";
    if (!isValidAmount(value1) || !isValidAmount(value2)) {
        return false;
    }
    try {
        const instant1 = Temporal.Instant.fromEpochMilliseconds(epochUnit === "seconds" ? value1 * 1000 : value1);
        const instant2 = Temporal.Instant.fromEpochMilliseconds(epochUnit === "seconds" ? value2 * 1000 : value2);
        return Temporal.Instant.compare(instant1, instant2) === 0;
    }
    catch {
        return false;
    }
}