calendar-patterns

What problem does it solve?

Catalogs and advises on calendar pattern implementations to standardize timekeeping logic across calendars and timekeeping systems within the Library of Time.

Core Features & Use Cases

• Catalogs six reusable calendar design patterns (Anchor-epoch + day count, Equinox/solstice-anchored year, Shifted day-boundary / weekday logic, Timezone-localized Gregorian derivatives, JDN-based conversions, Cycle-based / exotic year models).
• Provides concrete examples and guidance on when to apply each pattern, with patterns mapped to real-world calendars (e.g., Coptic, Baháʼí, Solar Hijri, French Republican, Darian, Pawukon, etc.).
• Outlines core ingredients and implementation considerations for selecting and combining patterns, aiding design decisions and risk assessment.

Quick Start

Review your calendar design and map it to one of the six patterns, then implement the chosen pattern in your algorithm.