Guides
These guides are organized by task, not by namespace. Each one ports the runnable
patterns from the gmt README and skill docs into a single page, then links to the
reference for the full signature of every function mentioned.
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, validation, calendar systems |
| Zoned Date Operations | Timezone-aware arithmetic, boundaries, DST control |
| Conversion | Between plain/zoned/unix/UTC and calendar systems |
| Intervals | Range math — containment, overlap, set operations, splitting |
| Integration | Cache keys, routers, tables, lint config |
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.