Skip to content

Core Date Operations

Everything you do with plain dates and datetimes in GMT.

  • Getting the Current Date and Time — read “now” as ISO strings in plain, zoned, UTC, and Unix shapes.
  • Plain Arithmetic — add, subtract, and diff dates and datetimes with overflow control and rounding.
  • Durations — parse, validate, combine, rebalance, total and format ISO 8601 duration strings, and write one from a unit object.
  • Comparisons — order, equality, weekends, business days, and now-relative predicates.
  • Formatting — locale-aware display, relative labels, calendar-day labels, and fixed machine formats.
  • Relative Time — human-friendly relative strings such as “yesterday” and “in 2 hours”, for plain, zoned, Unix and UTC values.
  • Parsing — extract components from ISO strings and decode interchange grammars.
  • Validation — validate date/time strings, timezone identifiers, intervals, and ranges.
  • Calendar Systems — express dates in non-Gregorian calendars with native arithmetic.
  • Business Calendars and Roll Conventions — weekends, holidays, business-day counting, roll conventions and merged calendars.
  • Operating Hours and Open-Time SLAs — is it open, how many open hours have passed, and when an open-hours SLA falls due.
  • Nanosecond Precision — bigint nanosecond instants, wire format, truncation for storage and zoned strings with sub-minute offsets.
  • Spans — exact elapsed time as a number, and wall-clock spans.