Examples Tour

Start With The Right Boundary Problem

These example pages are organized as a guided tour. Start with the operational-day primitive. Then branch into DST failure modes, shifting per-date boundaries, or specialized scenarios.

Operational Day Demo DST Critical Cases API Snippets

Recommended First Stop

Operational Day Demo

Start here if your real problem is “our business day does not start at midnight.” This page covers stable window resolution, grouping, and deriving a bucket date from window.start.

Open Operational Day Demo

Critical Cases

DST Critical Cases

Go here when you need to reason about spring-forward gaps, fall-back ambiguity, and elapsed-versus-wall-clock duration drift.

Open DST Critical Cases

Start Here If...

Midnight breaks your reporting

Use the operational-day demo first.

Operational Day Demo

DST is causing crashes or bad payroll math

Use the DST page first.

DST Critical Cases

Your boundary changes by date

Use the shifting-day demo.

Shifting Day Demo

You only need helper-level examples

Use the API snippets page.

API Snippets

You need duration semantics in isolation

Use the duration scenarios page.

Duration Scenarios

You need a dataset-backed non-midnight calendar

Use the Hijri Maghrib proof of concept.

Hijri Maghrib Boundary POC

Suggested Tour Order

Operational Day Demo: learn the main boundary-window primitive.
DST Critical Cases: understand the high-risk clock-change failures.
Shifting Day Demo: see a boundary that changes by date.
Duration Scenarios: isolate elapsed-versus-wall-clock end semantics.
API Snippets: review the smaller helper entry points.
Hijri Maghrib Boundary POC: explore a dataset-backed, non-midnight calendar rule.