# holidayskr (한국 공휴일 계산)

> 음력·대체공휴일 계산 패키지. 음력과 대체공휴일까지 계산하는 파이썬 공휴일 패키지입니다. 매년 바뀌는 날짜를 코드로 처리합니다.

- 페이지: https://dreamboat.kr/discover/holidayskr
- 공식 사이트: https://github.com/6mini/holidayskr
- 분야: 개발도구, 공공
- 쓰는 환경: 라이브러리
- 상태: 운영 중
- 등재: 2026-08-13 · 마지막 갱신: 2026-10-23


## 소개

holidayskr은 대한민국 공휴일을 계산하는 파이썬 패키지입니다. 고정 공휴일뿐 아니라 **음력 기반 공휴일과 대체공휴일**까지 처리합니다. GitHub 29스타·MIT.

공휴일이 생각보다 어려운 이유:
설·추석·부처님오신날은 음력이라 매년 양력 날짜가 바뀝니다. 대체공휴일 규칙은 법이 개정되면서 계속 확장돼 왔습니다. 삼일절·광복절이 주말과 겹치면 대체휴일이 생기는 식입니다.

즉 **공휴일 목록을 하드코딩하면 매년 손봐야 합니다.** 계산으로 푸는 편이 맞습니다.

어디서 쓰이나:
- 영업일 기준 배송·정산일 계산
- 근태·급여 시스템
- 예약 서비스의 휴무 처리
- 데이터 분석에서 영업일 필터

한국 공공데이터·주소·지도 오픈소스:
- 대한민국 행정구역 지도: 시도·시군구·읍면동 경계 데이터
- 포스트코디파이(postcodify): 도로명주소·우편번호 검색 API
- 공공데이터 분석(OpenDataWrangling): 실제 데이터로 분석 실습
- QGIS 한국 지도 플러그인: 카카오·네이버·VWorld 배경지도
- holidayskr: 음력·대체공휴일까지 계산하는 공휴일 패키지

공공데이터포털은 데이터를 열어두지만 형식이 제각각이고 문서가 불친절합니다. 그 사이를 개인 개발자들이 래퍼·정제 데이터·플러그인으로 메우고 있습니다.

급여·정산처럼 틀리면 안 되는 계산에 쓸 때는 **매년 공식 공휴일 공고와 대조**하는 절차가 필요합니다.

타겟 사용자:
- 영업일 계산이 필요한 서비스 개발자
- 예약·배송·정산 로직을 짜는 백엔드 개발자
- 근태·인사 시스템을 만드는 사람
- 시계열 데이터에서 휴일 효과를 다루는 분석가

## 인용

이 소개는 Dreamboat(드림보트)이 공식 사이트를 직접 확인해 작성했습니다.
출처(https://dreamboat.kr/discover/holidayskr)를 명시하면 인용 가능합니다. 서비스 자체의 권리는 각 제작자에게 있습니다.
전체 목록: https://dreamboat.kr/llms.txt · 전문: https://dreamboat.kr/llms-full.txt