holidayskr (한국 공휴일 계산)

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

공휴일이 생각보다 어려운 이유

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

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

어디서 쓰이나

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

한국 공공데이터·주소·지도 오픈소스

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

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

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

이런 분께 맞아요

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