@burglekitt/gmt/dist/plain/interval/intervalXorAllTime.d.ts

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

/**
 * Return the symmetric difference across a list of time intervals — the set of clock times
 * covered by an odd number of the input intervals.
 *
 * - List-form generalization of `intervalXorTime`, which is pairwise only.
 * - Implemented as a coverage sweep: each interval contributes a `+1` at its start and a `-1`
 *   one nanosecond after its end; the result is every maximal run where the running coverage
 *   count is odd. For two intervals this reduces to exactly `intervalXorTime`'s pairwise result.
 * - Order of the input list does not matter; the result is sorted by start.
 * - Returns `[]` for an empty list, and `[]` when every clock time is covered an even number of
 *   times (e.g. two identical intervals cancel out).
 * - Returns `[]` when `intervals` is not an array, when any element is not a
 *   `{ start, end }` record of valid ISO PlainTime strings, or when any element has
 *   `start > end`.
 *
 * @param intervals array of `{ start, end }` records
 * @returns array of `{ start, end }` records covered an odd number of times, or `[]` on invalid input
 *
 * @example intervalXorAllTime([{ start: "09:00:00", end: "12:00:00" }, { start: "11:00:00", end: "15:00:00" }]) // [{ start: "09:00:00", end: "10:59:59.999999999" }, { start: "12:00:00.000000001", end: "15:00:00" }]
 * @example intervalXorAllTime([]) // []
 */
export declare function intervalXorAllTime(intervals: Array<{
    start: string;
    end: string;
}>): Array<{
    start: string;
    end: string;
}>;