mergeIntervalsTime

Signature

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

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

• List-form generalization of intervalUnionTime, 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 PlainTime 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 clock time the interval begins at, as an ISO 8601 time string with no date, offset or time zone.
end	string	The first clock 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 { mergeIntervalsTime } from "@northguild/gmt/plain/interval";

mergeIntervalsTime([{ start: "09:00:00", end: "12:00:00" }, { start: "12:00:00", end: "15:00:00" }]) // [{ start: "09:00:00", end: "15:00:00" }] (touching)

intervals

×

×

+ add

output

 

Source

plain/interval/mergeIntervalsTime.ts