🦀 ClawHub
Korean Holiday CLI
by @chloepark85
Korean public holidays, business-day calculator, and lunar↔solar converter (CLI). Check if a date is a Korean public holiday (including 대체공휴일), list holidays...
⚡ When to Use
💡 Examples
All commands are sub-commands of scripts/kr_holiday.py. Output is JSON (UTF-8, Korean preserved). Dates accept YYYY-MM-DD, YYYYMMDD, YYYY/MM/DD, or YYYY.MM.DD.
Check a date
python scripts/kr_holiday.py is-holiday 2026-05-05
→ {"date":"2026-05-05","weekday":"Tue","is_weekend":false,"is_holiday":true,"is_business_day":false,"names":["어린이날"]}
List holidays in a year (optionally filter by month)
python scripts/kr_holiday.py list --year 2026
python scripts/kr_holiday.py list --year 2026 --month 5
Next / previous business day
python scripts/kr_holiday.py next-business-day 2026-05-02 # skip Sat → 2026-05-04 (Mon)
python scripts/kr_holiday.py next-business-day 2026-05-02 --offset 3 # 3rd next business day
python scripts/kr_holiday.py prev-business-day 2026-05-06 --offset 2
Add a signed business-day offset
python scripts/kr_holiday.py add-business-days 2026-04-20 --days 10 # 2026-05-04
python scripts/kr_holiday.py add-business-days 2026-05-05 --days -3
Count business days in a range (inclusive)
python scripts/kr_holiday.py business-days --start 2026-05-01 --end 2026-05-31
→ {"start":"2026-05-01","end":"2026-05-31","calendar_days":31,"business_days":19}
Solar ↔ Korean lunar
python scripts/kr_holiday.py solar-to-lunar 2026-02-17
→ {"solar":"2026-02-17","lunar":"2026-01-01","is_leap_month":false,"gapja":"병오년 경인월 임술일"}
python scripts/kr_holiday.py lunar-to-solar 2026-08-15
python scripts/kr_holiday.py lunar-to-solar 2025-06-01 --leap # pass --leap for 윤달
Monthly calendar view
python scripts/kr_holiday.py month 2026 5 # human-readable, Sunday-first
python scripts/kr_holiday.py month 2026 5 --format json # weeks grid in JSON
TERMINAL
clawhub install kr-holiday-cli