Reference

Generate a full-year almanac

The package ships with a CLI that renders every day of a year across all seven calendar systems — for testing, research, or producing a printable almanac.

Print to the console

npm run almanac 2026

Export to a file

Redirect the output to a text file to build a year of synchronized reference data.

node bin/almanac.js 2026 > 2026_almanac.txt

What it is useful for

  • Regression testing: diff a new release against the previous year's output.
  • Research: compare UCP results with published almanacs and note discrepancies.
  • Production: generate printable almanacs or seed a database of festival dates.

Back to the docs

Return to quickstart