@burglekitt/gmt
Version:
Temporal-based date and time utilities with timezone support and polyfill integration
23 lines (22 loc) • 1.37 kB
TypeScript
/**
* Return true when two time intervals are exactly adjacent — one's end equals the other's start
* with zero gap and zero overlap.
*
* - Uses `Temporal.PlainTime.compare` for comparison.
* - Returns `true` when `aEnd + 1 nanosecond === bStart` or `bEnd + 1 nanosecond === aStart`.
* - Returns `false` when intervals overlap, are disjoint with a gap, or are invalid.
* - Returns `false` on invalid input (wrong type, malformed strings).
*
* @param aStart ISO 8601 time string for the first interval start
* @param aEnd ISO 8601 time string for the first interval end
* @param bStart ISO 8601 time string for the second interval start
* @param bEnd ISO 8601 time string for the second interval end
* @returns true if intervals are exactly adjacent, or false on invalid input
*
* @example intervalAbutsTime("09:00:00", "12:00:00", "12:00:00.000000001", "17:00:00") // true
* @example intervalAbutsTime("12:00:00", "17:00:00", "09:00:00", "12:00:00") // true
* @example intervalAbutsTime("09:00:00", "12:00:00", "12:00:01", "17:00:00") // false (gap)
* @example intervalAbutsTime("09:00:00", "13:00:00", "12:00:00", "17:00:00") // false (overlap)
* @example intervalAbutsTime("invalid", "12:00:00", "12:00:00", "17:00:00") // false
*/
export declare function intervalAbutsTime(aStart: string, aEnd: string, bStart: string, bEnd: string): boolean;