mergeIntervalsDateTime

Signature

mergeIntervalsDateTime(intervals: { start: string; end: string; }[]): { start: string; end: string; }[]

Collapse a list of datetime intervals into the minimum set of non-overlapping intervals.

• List-form generalization of intervalUnionDateTime, which is pairwise only.
• Half-open: an interval holds every t with start <= t < end. Overlapping intervals and touching intervals (aEnd === bStart) join into one run; any gap, even one unit, keeps them apart (CORE-6’s mergeIntervals).
• An empty interval (start === end) holds nothing: it is absorbed by a run it touches or lies in, and dropped otherwise, so every returned interval is non-empty.
• Order of the input list does not matter; the result is sorted by start.
• Returns [] for an empty list.
• Returns [] when intervals is not an array, when any element is not a { start, end } record of valid ISO PlainDateTime strings, or when any element has start > end.

Parameters

Parameter	Type	Description
intervals	{ start: string; end: string; }[]	array of { start, end } records

Returns

the minimum set of non-overlapping { start, end } records, sorted by start, or [] on invalid input

Members of each item

Member	Type	Description
start	string	The date-time the interval begins at, as an ISO 8601 date-time string with no offset or time zone.
end	string	The first date-time after the interval, in the same format as start. It is exclusive: the interval holds everything from start up to but not including this value. It is always later than start.

Examples

import { mergeIntervalsDateTime } from "@northguild/gmt/plain/interval";

mergeIntervalsDateTime([{ start: "2024-01-01T00:00:00", end: "2024-01-10T00:00:00" }, { start: "2024-01-10T00:00:00", end: "2024-01-15T00:00:00" }]) // [{ start: "2024-01-01T00:00:00", end: "2024-01-15T00:00:00" }] (touching)

intervals

×

×

+ add

output

 

Source

plain/interval/mergeIntervalsDateTime.ts