Skip to content

Changelog 1.9

  • The core functions, which every industry uses.

Release notes of @northguild/gmt 1.9.0, newest first, built from packages/gmt/CHANGELOG.md. Back to Changelog.

The @burglekitt organization logo

In memoriam: @burglekitt. These releases were published under the retired @burglekitt npm scope. The package continues as @northguild/gmt from 1.14.2; install @northguild/gmt.

Released 2026-08-15

  • b41168c: Add intervalContainsDate, intervalContainsTime, intervalContainsDateTime (plain), intervalContainsUtc (utc), intervalContainsUnix (unix), and intervalContainsZoned (zoned) — interval containment checks. Each supports two modes via an optional fourth argument:

    • 3-arg: intervalContains(start, end, point) — true when start <= point <= end
    • 4-arg: intervalContains(start, end, innerStart, innerEnd) — true when the inner interval is fully contained within the outer interval
  • 17b6a6b: Add intervalIntersectionDate, intervalIntersectionTime, intervalIntersectionDateTime (plain), intervalIntersectionUtc (utc), intervalIntersectionUnix (unix), and intervalIntersectionZoned (zoned) — interval intersection. Each accepts two intervals and returns the overlapping span, or null when they do not overlap:

    • Adjacent intervals (e.g. aEnd === bStart) share one instant and DO overlap, returning a single-point span.
    • Returns null when intervals are disjoint with a gap, or when either interval is invalid (start > end).
    • Returns null on malformed input (never throws).
    • Return shape: { start: string; end: string } | null (or { start: number; end: number } | null for Unix).
  • d798fcb: Add intervalsOverlapDate, intervalsOverlapTime, intervalsOverlapDateTime (plain), intervalsOverlapUtc (utc), intervalsOverlapUnix (unix), and intervalsOverlapZoned (zoned) — interval overlap detection. Each accepts two intervals and returns true when they share at least one instant:

    • Adjacent intervals (e.g. aEnd === bStart) are treated as overlapping because they share the boundary instant.
    • Returns false when intervals are disjoint with a gap, or when either interval is invalid (start > end).
    • Returns false on malformed input (never throws).
  • d859fd4: Adds intervalUnionDate, intervalUnionTime, intervalUnionDateTime (plain), intervalUnionUtc (utc), intervalUnionUnix (unix), and intervalUnionZoned (zoned) — merge two intervals into their combined span when they overlap or are directly adjacent.

    • Overlapping or adjacent intervals return { start, end } with the merged span. Adjacent intervals (e.g. aEnd === bStart) share one instant and ARE merged.
    • Returns null when intervals are disjoint with a gap, when either interval is invalid (start > end), or on malformed input (never throws).
    • Return shape: { start: string; end: string } | null for plain/utc/zoned; { start: number; end: number } | null for Unix.
  • e6439de: Add interval and range validators across plain, utc, unix, and zoned namespaces.

    • isValidDateInterval, isValidTimeInterval, isValidDateTimeInterval (plain) — positional (start, end) args returning true when both parse and start <= end.
    • isValidUtcInterval, isValidUnixInterval, isValidZonedInterval (utc, unix, zoned) — same pattern, comparing by instant for utc/zoned.
    • isValidDateTimeRange, isValidTimeRange (plain), isValidUtcRange, isValidUnixRange, isValidZonedRange (utc, unix, zoned) — object-param { value1, value2 } shape matching the existing isValidDateRange convention.

    All functions return false on invalid input (never throw).

  • ec0a337: Add splitIntervalByUnit* functions across plain, utc, unix, and zoned namespaces.

    • splitIntervalByUnitDate, splitIntervalByUnitTime, splitIntervalByUnitDateTime (plain) — split an interval into sub-intervals of amount × unit, returning an array of { start, end } records.
    • splitIntervalByUnitUtc, splitIntervalByUnitUnix, splitIntervalByUnitZoned (utc, unix, zoned) — same pattern adapted to each Temporal environment.

    All functions return [] on invalid input (never throw). The final sub-interval is trimmed so its end never exceeds the original end.

  • 87af6ea: Add interval set operations: intervalDifference, intervalXor, intervalAbuts, intervalEngulfs across plain, zoned, unix, and utc namespaces.

Last updated:

© 2026 NorthGuild · Licences

Code examples: MIT-0. Packages: MIT. Third-party data and components: their own licences, credited where they appear. Everything else: © 2026 NorthGuild, all rights reserved.