intervalDifferenceUnix
Signature
Section titled “Signature”intervalDifferenceUnix(aStart: string | number, aEnd: string | number, bStart: string | number, bEnd: string | number): { start: number; end: number; }[]import { intervalDifferenceUnix } from "@northguild/gmt/unix/interval";Return the portion(s) of interval A not covered by interval B.
- Compares numeric Unix epoch values directly.
- Returns
[]when B fully covers A. - Returns
[{ start, end }]when B overlaps one edge of A (or equals A). - Returns
[{ start, end }, { start, end }]when B is fully inside A with gaps on both sides. - Returns
[]if either interval is invalid (start > end). - Returns
[]on invalid input (non-numeric types, non-finite values).
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
aStart |
string | number |
Unix epoch value (seconds or milliseconds) — first interval start |
aEnd |
string | number |
Unix epoch value (seconds or milliseconds) — first interval end |
bStart |
string | number |
Unix epoch value (seconds or milliseconds) — second interval start |
bEnd |
string | number |
Unix epoch value (seconds or milliseconds) — second interval end |
Returns
Section titled “Returns”array of { start, end } records representing A minus B, or [] on invalid input
Examples
Section titled “Examples”intervalDifferenceUnix(0, 1700000000, 1500000000, 1600000000) // [{ start: 0, end: 1499999999 }]intervalDifferenceUnix(0, 1700000000, 0, 1700000000) // []intervalDifferenceUnix(NaN, 1700000000, 1500000000, 1600000000) // []