Guides
These guides are organized by task, not by namespace. Each one gathers the runnable patterns for a task into a single page, then links to the reference page of every function mentioned for its full signature. The agent skills teach the same patterns to coding agents.
How the guides are organized
Section titled “How the guides are organized”| Group | What it covers |
|---|---|
| Concepts | Plain vs zoned, DST disambiguation |
| Core Date Operations | Getting the current time, arithmetic, comparison, durations, parsing, formatting, relative time, validation, calendar systems, business calendars, operating hours, nanosecond precision, spans |
| Zoned Date Operations | Timezone-aware arithmetic, boundaries, DST control, zone-aware buckets, offset-preserving instants |
| Conversion | Between plain/zoned/unix/UTC and calendar systems, and foreign epochs (NTP, FILETIME, Excel, PostgreSQL) |
| Intervals | Range math — containment, overlap, set operations, splitting |
| Integration | Cache keys, routers, tables, lint config |
| Industries | The industry layers on top of the core — transport legs and dwell, cut-offs, multi-leg scheduling, punctuality and timestamp classes, free time and demurrage, billing deadlines, bill of lading dates and multimodal ETAs, EDI timestamps — with real-world scenarios |
Reading order
Section titled “Reading order”If you’re new to the library, read these three first — in this order:
- Plain vs Zoned — the two families of types and why they never mix.
- DST Disambiguation — why wall-clock time breaks twice a year and how GMT controls it.
- Zoned Operations — scheduling across timezones, the task that needs both.
After that, jump to whichever group matches the task at hand.