korean-lunar-calendar
Convert the Korean lunar calendar to/from the Gregorian solar calendar (KARI standard).
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained, has zero known vulnerabilities, imposes no dependency burden, and solves a specific problem (Korean lunar–solar conversion) with a well-defined, validated API. Install it if you need to work with Korean lunar dates; skip it if you only need Gregorian calendars.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Supported date range: lunar 1000-01-01 to 2050-11-18, solar 1000-02-13 to 2050-12-31; dates outside this range will cause setters to return False.
- Low friction: pure Python with no runtime dependencies, distributed as a wheel, and actively maintained with a recent release.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution in both open and proprietary projects.
last release 2026-06-15 (60 days) · last repo commit 2026-06-15 · 24 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 6,701,951 downloads/mo, #1,869 on PyPI
Alternatives
Verify before relying
pip install korean_lunar_calendar
from korean_lunar_calendar import KoreanLunarCalendar
calendar = KoreanLunarCalendar()
if calendar.setSolarDate(2017, 6, 24):
print(calendar.LunarIsoFormat()) # 2017-05-01 Intercalation- Whether the KARI conversion tables are updated annually or on a fixed schedule.
- Performance characteristics for bulk conversions or real-time calendar applications.
What it is and what it does
korean_lunar_calendar is a stateful date converter that transforms dates between the Korean lunar calendar (음력) and the Gregorian solar calendar (양력). It bundles the conversion table offline, requires no network calls, and follows the KARI (Korea Astronomy and Space Science Institute) standard—the same astronomical basis as the Chinese lunar calendar, but using Korean-specific intercalation rules. The library handles leap months (윤달), the 1582 Gregorian reform gap, and provides output in both Korean and Chinese sexagenary cycle notation.
You instantiate a KoreanLunarCalendar object, call setSolarDate() or setLunarDate() to set a date (both return a bool to indicate success), and then read the result back in the other calendar via LunarIsoFormat(), SolarIsoFormat(), getGapJaString(), or getChineseGapJaString(). Input validation is strict: out-of-range dates, non-integers, and impossible leap months are rejected. The library has no third-party dependencies and requires Python 3.6 or later.
Use it for
- Convert Korean holidays and traditional dates (e.g., Lunar New Year) to Gregorian dates for scheduling and calendar applications.
- Display sexagenary cycle strings (GapJa) in Korean or Chinese for cultural or astrological contexts.
- Validate lunar dates in user input and reject impossible or out-of-range dates before processing.
- Build calendar or genealogy tools that work with both lunar and solar date systems.
- Integrate lunar calendar support into event management or historical record systems.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is actively maintained, has zero known vulnerabilities, imposes no dependency burden, and solves a specific problem (Korean lunar–solar conversion) with a well-defined, validated API. Install it if you need to work with Korean lunar dates; skip it if you only need Gregorian calendars.
Install
korean-lunar-calendar on PyPI
Before you install
Low friction: pure Python with no runtime dependencies, distributed as a wheel, and actively maintained with a recent release.
Supported date range: lunar 1000-01-01 to 2050-11-18, solar 1000-02-13 to 2050-12-31; dates outside this range will cause setters to return False.
License in practice
MIT license permits unrestricted use, modification, and distribution in both open and proprietary projects.
Quickstart
pip install korean_lunar_calendar
from korean_lunar_calendar import KoreanLunarCalendar
calendar = KoreanLunarCalendar()
if calendar.setSolarDate(2017, 6, 24):
print(calendar.LunarIsoFormat()) # 2017-05-01 IntercalationVerify before relying
- Whether the KARI conversion tables are updated annually or on a fixed schedule.
- Performance characteristics for bulk conversions or real-time calendar applications.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.6 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 60 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 6,701,951 / month, #1,869 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersOperating System :: OS IndependentProgramming Language :: Python :: 3Topic :: Software Development :: Libraries |
Evidence: korean_lunar_calendar-0.4.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “korean lunar calendar conversion”
- korean-lunar-calendarConverts dates between the Korean lunar calendar and Gregorian solar…
- LunarCalendarConverts between lunar and solar calendar dates, and provides access…
- zhdateConverts between Chinese lunar calendar dates and Gregorian datetime…
Give your agent the search over MCP, or paste the wish link into any chat.
More Libraries packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Provides parsing, arithmetic, and recurrence rule computation for dates and times, with timezone support and iCalendar RFC compliance.
Install it if you need to parse flexible date strings, compute relative dates, handle timezones, or work with recurrence rules—it's the de facto choice for these tasks.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
See also lunardate · LunarCalendar · sxtwl · zhdate · lunar_python · pyCalverter · bangla · convertdate · ummalqura · ntplib