when-am-i / commit
Document Korea/Dangi/Juche in supported calendars; add a wishlist
README.md | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 55 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index f5a0a25..7b0c453 100644 --- a/README.md +++ b/README.md @@ -58,12 +58,13 @@ and show the Gregorian year for reference). - **Convertible:** Gregorian, Julian, Islamic (Umm al-Qura), Hebrew, Persian (Solar Hijri), Indian (Saka), Buddhist, Japanese (nengō, Meiji onward), Ethiopian, Maya Long Count, French Republican calendar (year only, from a - sourced table of each year's actual equinox-based start date). + sourced table of each year's actual equinox-based start date), Dangi + (Dangun era, South Korea), Juche (North Korea, 1997–2024). - **Descriptive-only:** the Chinese sexagenary cycle (the named 60-year - stem-branch / zodiac-animal year), the Japanese pre-1873 lunisolar calendar, - the Tzolk'in/Haab' Calendar Round, the Ottoman Rumi fiscal calendar, the - Māori maramataka, and observational lunar calendars such as the Algonquian - (Massachusett) reckoning. + stem-branch / zodiac-animal year), the Korean and Japanese pre-modern + lunisolar calendars, the Tzolk'in/Haab' Calendar Round, the Ottoman Rumi + fiscal calendar, the Māori maramataka, and observational lunar calendars such + as the Algonquian (Massachusett) reckoning. ## Tech Stack @@ -242,6 +243,55 @@ See `src/data/calendars/SCHEMA.md` (human-readable field docs) and fields, valid geometry, parseable dates). This runs automatically before every build and in CI, so a malformed file will fail the pipeline rather than deploy. +### Calendars we'd like to add + +Ranked by rough "years in use × area/population reached" — the systems that +would let the most human-years of history resolve to a real local answer. +Contributions for any of these (or anything else, sourced) are very welcome — +see [How to contribute](#how-to-contribute) above, and check +`src/utils/calendars.ts` for whether a system needs new converter work or can +ship as descriptive-only. + +1. **Vietnamese calendar** — a Chinese-derived lunisolar calendar (own + sexagenary-cycle and era-name conventions) used for ~1,000+ years across + Vietnam; still observed for Tết and traditional dates today. +2. **Tibetan calendar (Bod rtsis)** — a lunisolar calendar in continuous use + across the Tibetan Plateau for over a thousand years, with its own 60-year + cycle and year names. +3. **Mongolian calendar** — the Mongol Empire and successor states' lunisolar + calendar (related to but distinct from the Chinese and Tibetan systems), + spanning a vast historical territory. +4. **Aztec/Mexica calendar (Xiuhpohualli + Tonalpohualli)** — Mesoamerica's + other major calendar system alongside the Maya (already covered): a 365-day + solar count and a 260-day ritual count, used across central Mexico for + centuries before and during the Aztec Empire. +5. **Coptic calendar** — Egypt's calendar since antiquity (descended from the + ancient Egyptian civil calendar), still used liturgically by the Coptic + Orthodox Church; distinct from but related to the Ethiopian calendar already + supported. (Note: the Temporal `coptic` calendar id is broken in our + polyfill version, same class of bug as `chinese`/`ethiopic` — would likely + need a hand-rolled converter like Ethiopian's.) +6. **Ancient Egyptian civil calendar** — a 365-day calendar used for roughly + three millennia along the Nile; descriptive-only (no continuous numbered + year survives in common use), but enormous time depth. +7. **Armenian calendar** — in continuous use since antiquity, with its own + epoch and a fixed 365-day year (no leap day), giving it a slow drift against + the Gregorian year worth surfacing. +8. **Coast Salish / Puget Sound calendar** — a sourced, people-specific lunar + reckoning for the Pacific Northwest, paralleling the Massachusett entry; the + place/people this skill's original brainstorm named as an example. +9. **Inca calendar** — a lunisolar/solar calendar used across the Inca Empire's + considerable territory in the Andes; mostly descriptive (reconstructions of + its exact rules are debated, so sourcing needs care). +10. **Balinese Pawukon and Saka calendars** — Bali's parallel 210-day ritual + cycle and a Saka-derived solar count, both still in everyday use. +11. **Bahá'í calendar** — a 19-month, 19-day solar calendar in worldwide use + since the mid-19th century; smaller area than the others here but a long + enough span and clean enough arithmetic to be a good convertible candidate. +12. **Sikh Nanakshahi calendar** — a solar calendar adopted by the SGPC in 2003 + for Sikh religious dates, with a clear epoch (Guru Nanak's birth year) — + likely a simple convertible offset like Dangi/Juche. + ## License [MIT](LICENSE) © Pavel Safronov