Which countries are supported by the converter?

The skill includes comprehensive records for China, Japan, Korea, and Vietnam, including various regional era names.

What time period does this skill cover?

It supports historical dates from approximately 220 BCE up to 1945 CE, covering major dynasties and era changes.

Can it handle leap months in the lunisolar calendar?

Yes, it fully supports leap months (閏) and uses traditional notation for specific cases like '元年' for the first year of an era.

How does it resolve identical era names used in different dynasties?

When era names are ambiguous, the tool returns all possible matches, which you can then filter by country or dynasty name.

Does it require an internet connection?

No, it runs entirely locally using a SQLite database after an initial setup script is executed to download the data.

CJK Historical Calendar Converter

Name: CJK Historical Calendar Converter
Author: kltng

bykltng

•

Data Science & ML

Converts historical East Asian lunisolar dates and era names into Gregorian and Julian calendar dates using a local database.

The cjk-calendar skill is a specialized tool for humanities researchers and developers working with historical East Asian records. It facilitates precise conversions between Chinese, Japanese, Korean, and Vietnamese lunisolar calendars and the Western calendar system (Gregorian/Julian) covering over two millennia of history. By leveraging a comprehensive SQLite database of 1,637 eras and over 131,000 lunar month records, it handles complex tasks like era name (年號) lookups, sexagenary cycle (干支) calculations, and Julian Day Number mapping, all while functioning entirely offline after initial setup.

Key Features

01Offline-first architecture using a local SQLite database for high performance

02Bidirectional conversion between CJK lunisolar and Gregorian/Julian dates

03Support for ambiguous era names with filtering by country or dynasty

04Automated calculation of sexagenary cycles (Heavenly Stems and Earthly Branches)

051 GitHub stars

06Extensive era name database covering 1,637 historical eras across East Asia

Use Cases

01Validating sexagenary date cycles in genealogical or historical records

02Translating historical East Asian documents and manuscripts into precise Western dates

03Mapping dynastic era names like Kangxi or Tenpo to specific years for academic research

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kltng/humanities-skills cjk-calendar

For use in Claude.ai and ChatGPT

Key Features

01Offline-first architecture using a local SQLite database for high performance

02Bidirectional conversion between CJK lunisolar and Gregorian/Julian dates

03Support for ambiguous era names with filtering by country or dynasty

04Automated calculation of sexagenary cycles (Heavenly Stems and Earthly Branches)

051 GitHub stars

06Extensive era name database covering 1,637 historical eras across East Asia

Use Cases

01Validating sexagenary date cycles in genealogical or historical records

02Translating historical East Asian documents and manuscripts into precise Western dates

03Mapping dynastic era names like Kangxi or Tenpo to specific years for academic research