Factory docs, home
Page navigation

Status: In progress: internal shared foundation; current evidence. No public adoption is claimed.

A date or ISO week must mean the same thing wherever a module consumes it. The internal Calendar foundation supplies that arithmetic once; each caller retains its own refusal policy and bounds.

Civil-day arithmetic is deterministic. Zone conversion depends on host ICU data. The library chooses the earlier instant for a repeated local time and advances a nonexistent time by the gap; callers must qualify those rules for their domain. This library does not decide when work may run or what it may cost.

Source ownership sits with Calendar rather than Owner policy because several independent consumers use it. This declares the existing shared responsibility; it does not offer a newly adopted public API. Read the reference for functions and limits.

Honest limits:

  • Host ICU data determines zone conversion; callers qualify the supported zones and fixed fold/gap rules.
  • This internal foundation has no public package entry, storage, clock read, scheduling or authority.

Source: docs/guide/calendar.md