우주항공청에서 발표한 월력요항1을 csv
, json
, ics
형식으로 가공한 자료입니다. 기념일은 이곳에서 확인합니다.
- 애플 캘린더 등 - 대체 공휴일 일정 미제공
- 구글 캘린더 등 - 잘못된 공휴일 정보 제공
- 공공 데이터 포털 - XML만 제공, API 키 강제2
- 캘린더 구독 - 구글3, 애플4 캘린더 등 지원
- 텍스트 파일 - 웹 호스팅 제공, 다운로드 지원
- 자바스크립트 패키지 -
ESM
및CJS
지원
- 명칭은 공휴일에 관한 법률을 따릅니다. (기독탄신일 등)
- 공휴일이 아닌 국경일은 포함하지 않습니다. (제헌절 등)
- 지방 공휴일은 포함하지 않습니다. (4·3희생자추념일 등)
- 제공되는
csv
파일은 Google 캘린더 형식을 따릅니다. - 제공되는
ics
파일은 iCalendar 표준을 따릅니다.
https://holidays.hyunbin.page/basic.ics
주소로 새로운 캘린더를 구독합니다.
Warning
위 주소를 직접 공유하는 것을 금합니다. holidays.hyunbin.page를 공유합니다.
Note
Google Calendar에 변경사항이 표시되려면 최대 12시간이 걸릴 수 있습니다.
Important
2024년 9월 4일 자로 JSON 파일 형식이 변경되었습니다.
- "2025-05-05": "어린이날",
+ "2025-05-05": ["어린이날", "부처님 오신 날"],
생성된 모든 텍스트 파일은 public 디렉터리에 위치합니다.
./public
├── basic.ics # 모든 연도 (2022년~)
├── basic.json # 모든 연도 (2022년~)
├── 2022.csv # 특정 연도
├── 2022.ics # 특정 연도
├── 2022.json # 특정 연도
├── 2023.csv
├── 2023.ics
├── 2023.json
├── (하략)
위 파일들은 holidays.hyunbin.page에 게시되어 있습니다.
# (예시) 다음 파일은
./public/basic.json
# 다음 URL에서 확인할 수 있습니다.
https://holidays.hyunbin.page/basic.json
Footnotes
-
월력요항은 달력 제작의 기준이 되는 자료입니다. 천문법과 천문법 시행령에 따라 작성되어 관보에 게재됩니다. ↩
-
회원가입, 본인인증, API 활용 신청을 해야만 사용할 수 있습니다. 비밀 키가 사용되므로 클라이언트 코드에서 사용할 수 없습니다. ↩
-
다른 사람의 Google Calendar 구독하기 문서를 참고합니다. (링크를 사용하여 공개 캘린더 추가하기) ↩
-
iCloud 캘린더 구독 사용하기 문서를 참고합니다. ↩