사용법
드롭다운에서 **국가**(약 250개 항목 — 주권 국가, 종속 영토, 홍콩이나 푸에르토리코 같은 일부 준국가 지역)와 **연도**(1900~2100 지원, 현재에서 ±20년을 크게 벗어나면 정확도 저하)를 선택합니다. 페이지는 12개월 격자를 렌더링하고 각 공휴일을 실제 날짜에 표시하며 페이지 로케일에 따라 현지화된 공휴일 이름(Christmas / クリスマス / 크리스마스)으로 라벨링합니다. 표시된 날짜에 호버하거나 탭하면 추가 메타데이터가 나타납니다. 고정 날짜인지 이동 날짜인지, 은행이 휴무인지, 관찰 시프트 규칙(예: 일부 관할 구역에서 토요일 공휴일이 앞 금요일로 이동) 등.
내부적으로 본 도구는 **date-holidays** npm 라이브러리(MIT 라이선스, 축소 ~200 KB)를 사용해 정부 공식 출처, 종교 당국(이슬람·힌두·유대력 공휴일용), 크라우드소싱된 지역 지식에서 공휴일 규칙을 컴파일합니다. 라이브러리는 카탈로그의 나머지를 작게 유지하기 위해 온디맨드로 동적 로드됩니다. 정확도는 안정적인 공휴일 목록을 가진 OECD 국가에서 높고 공휴일이 매년 공포되는 관할 구역(예: 사우디아라비아의 하지 관련 공휴일, 일부 아프리카의 대체 휴일)에서는 더 낮습니다. 데이터셋은 주기적으로 갱신되지만 **비즈니스 크리티컬한 날짜는 해당 국가의 공식 정부 출처와 항상 검증**하세요. 한국은 **공공기관 공식 안내(행정안전부)**, 일본은 **内閣府 祝日カレンダー**, 미국은 **OPM Federal Holidays**입니다.
예제
한국 설날 — 3일 연휴
입력
country: Korea (KR)
year: 2026
출력
Major Korean holidays in 2026:
Jan 1 New Year's Day (Thu)
Feb 16 설날 연휴 — Day before Seollal (Mon, lunar 12/30)
Feb 17 설날 (Lunar New Year) (Tue, lunar 1/1)
Feb 18 설날 연휴 — Day after Seollal (Wed, lunar 1/2)
Mar 1 3·1절 (Independence Movement Day) (Sun, substitute Mon)
May 5 어린이날 (Children's Day) (Tue)
May 24 부처님오신날 (Buddha's Birthday) (Sun, substitute Mon, lunar 4/8)
...
Sep 24-26 추석 연휴 (Chuseok) (Thu–Sat)
한국의 설날과 추석은 3일 연휴입니다. 전날·당일·다음날. 둘 다 음력이며 **그레고리력 날짜가 매년 이동**하여 설날은 1월 하순에서 2월 하순까지, 추석은 9월 중순에서 10월 중순까지 들어갈 수 있습니다. **대체공휴일** 규칙은 2014년에 도입되어 2021년에 확대되었으며, 설날·추석·3·1절·광복절·개천절·한글날·어린이날이 일요일이나 다른 공휴일과 겹치면 다음 비공휴일 평일이 유급 대체일이 됩니다. 2026년 달력에는 몇 번의 대체 월요일이 표시됩니다. 토요일에 떨어지는 공휴일은 2023년에 설날과 추석에만 대체 규칙에 *추가*되었습니다. 대부분의 일반 토요일은 여전히 대체되지 않습니다.
일본 골든위크 — 5월 초 연휴
입력
country: Japan (JP)
year: 2026
출력
Golden Week 2026:
Apr 29 昭和の日 (Wed)
May 1 (regular workday) (Fri)
May 3 憲法記念日 (Sun, substitute May 6)
May 4 みどりの日 (Mon)
May 5 こどもの日 (Tue)
May 6 substitute for May 3 (Wed)
─
Total: Apr 29 (Wed), May 3-6 (Sun-Wed) — with weekend, up to 6-day stretch
taking May 1 off makes it a full 8-day vacation골든위크(ゴールデンウィーク)는 일본의 가장 긴 비공식 공휴일 연휴로, 4월 말부터 5월 초까지 압축된 **4개의 공식 공휴일**(昭和の日·憲法記念日·みどりの日·こどもの日)로 형성됩니다. 주말과, 5월 1일과 5월 2일이 평일이어도 유급 휴가를 쓰는 보편적인 일본 관습이 결합하면 대부분의 직원은 7~10일 연속 휴가를 얻습니다. 경제적 영향은 큽니다. 도쿄 오피스 가동률은 GW 중 ~30%로 떨어지고 **신칸센과 국내선 항공편은 전후 몇 주 동안 95% 이상의 가동률**로 운영됩니다. **国民の祝日に関する法律(공휴일법)**에는 두 공휴일 사이에 끼인 비공휴일 평일이 "国民の休日"가 된다는 조항이 있습니다. 이것이 1985년에 5월 4일(원래 공휴일이 아니었음)이 みどりの日가 된 경위입니다. 振替休日 규칙은 일요일에 떨어지는 공휴일을 다음 비공휴일 월요일 이후로 이동시킵니다.
미국 연방 공휴일 — 포함되지 않는 것
입력
country: United States (US)
year: 2026
출력
US Federal Holidays 2026:
Jan 1 New Year's Day
Jan 19 MLK Jr Day (3rd Mon)
Feb 16 Presidents' Day (3rd Mon)
May 25 Memorial Day (last Mon)
Jun 19 Juneteenth
Jul 3 Independence Day (observed — Jul 4 falls Sat)
Sep 7 Labor Day (1st Mon)
Oct 12 Columbus Day (2nd Mon — many states call it Indigenous Peoples' Day)
Nov 11 Veterans Day
Nov 26 Thanksgiving (4th Thu)
Dec 25 Christmas Day
NOT included (commonly mistaken):
- Black Friday (post-Thanksgiving — NOT a federal holiday, but many companies treat as off)
- Christmas Eve / New Year's Eve (NOT federal, sometimes private)
- Good Friday / Easter Monday (NOT federal in US, unlike most of Europe)
미국에는 **연방 공휴일이 11일뿐**입니다. 대부분의 OECD 국가보다 적고, 한국(대체 포함 ~15), 일본(16), 또는 전형적인 유럽 국가(공식 10~14 + 사실상 몇 일)를 훨씬 밑돕니다. 연방 지위는 **연방 직원과 대부분의 은행이 휴무**한다는 의미이며, 민간 기업은 자체 공휴일 달력을 설정하고 자주 다릅니다. **추수감사절 다음 날**은 미국 기업의 ~85%가 공휴일로 취급하지만 연방은 아닙니다. **크리스마스 이브**와 **새해 전야**는 유급 휴가로 제공되기도 하지만 큰 차이가 있습니다. 주 단위 공휴일도 주 직원에게 중요합니다. 텍사스는 Lyndon B. Johnson Day(8/27), 하와이는 Kuhio Day(3/26)를 추가하는 등. 연준의 **은행 공휴일 목록**(수표 청산 시기 결정)은 연방 목록을 따르되 크리스마스가 토요일에 떨어지는 날에 대한 추가 규칙이 있습니다. 연방 관찰일은 금요일이지만 은행은 그 날 이미 처리합니다.
자주 묻는 질문
도구가 같은 국가에서 연도별로 다른 공휴일을 표시하는 이유는?
3가지 이유입니다. **첫째**, **이동 공휴일**: 많은 공휴일이 "월의 N번째 평일" 규칙을 사용해(미국 MLK 기념일 = 1월 셋째 월요일, 일본 体育の日 = 10월 둘째 월요일) 매년 다른 날짜에 떨어집니다. **둘째**, **음력·태음태양력 공휴일**: 한국의 설날, 중국의 春节, 베트남의 Tết, 유대인의 Rosh Hashanah, 이슬람의 Eid는 모두 비그레고리력을 따르며 서력 연도에 대해 표류합니다. **셋째**, **대체·이동된 공휴일**: 고정일 공휴일이 주말에 떨어지면 많은 국가가 평일로 이동시킵니다. 대체 규칙은 관할 구역마다 다릅니다. 한국의 대체공휴일은 2021~2023년에 확대되었고, 일본의 振替休日은 1973년 이후 안정적이며, 미국은 크리스마스가 토요일인 경우의 관찰 금요일을 제외하고는 연방 공휴일을 대체하지 않습니다. 같은 국가의 공휴일 목록도 수십 년에 걸쳐 진짜로 변합니다. 한국은 22년간 삭제되었던 한글날을 2013년에 공휴일로 되돌렸고, 일본은 2016년에 山の日를 추가했으며, 미국은 2021년에 Juneteenth를 추가했습니다.
부활절과 다른 기독교 달력 공휴일은 어떻게 계산되나요?
부활절은 **3월 21일 이후의 첫 교회 만월 후의 첫 일요일**로, **니케아 공의회(325년)**에서 공식 정의되었고 가우스가 1800년에 **그레고리력 부활절 계산 알고리즘**으로 계산적으로 공식화했습니다. "교회 만월"은 천문학적인 것이 아닌 표 근사이므로 부활절은 실제 만월에서 1~2일 차이가 날 수 있습니다. 서방 부활절(가톨릭·개신교)은 그레고리력 계산법을 사용해 3월 22일~4월 25일에 떨어지고, 동방 정교회 부활절(그리스·러시아·세르비아 정교)은 율리우스력 계산법을 사용해 그레고리력으로 4월 4일~5월 8일에 떨어집니다. 두 가지 모두 date-holidays에 인코딩되어 있습니다. 다른 기독교 공휴일은 부활절에서 파생됩니다. **성금요일** = 부활절 - 2일, **부활절 월요일** = 부활절 + 1일, **승천대축일** = 부활절 + 39일, **오순절** = 부활절 + 49일, **성령 강림 월요일** = 부활절 + 50일. 부활절 가족 전체가 매년 함께 떠다닙니다. 이것이 독일과 프랑스 고용주가 고정일이 아닌 "부활절 주"를 중심으로 일정을 짜는 이유입니다.
왜 일부 이슬람·힌두 공휴일은 근사 날짜로 표시되나요?
이슬람 공휴일은 **히즈리 음력**을 따르며 1년이 354~355일입니다. 그레고리력보다 약 11일 짧습니다. 각 이슬람 달의 시작은 **특정 지리적 지점에서 초승달의 실제 시각적 관측**에 의존합니다(전통적으로 메카, 다만 각 국가의 종교 당국이 현지 결정을 발표). 이는 Eid al-Fitr와 Eid al-Adha 날짜가 **같은 주 안에서도 국가별로 ±1일 이동할 수 있다**는 의미입니다. 사우디아라비아 최고법원은 하지 시작 ~24시간 전에 공식 날짜를 발표하며, date-holidays는 실제 선포에서 1일 차이가 날 수 있는 계산 근사를 사용합니다. 힌두 공휴일에도 비슷한 문제가 있습니다. **디왈리**, **홀리**, **크리슈나 잔마쉬타미**는 각각 비크라마력 또는 샤카력의 음양력을 따르며 월말 정의된 "티티" 일자가 역서 계산을 요구합니다. 아시아 불교 공휴일(한국의 부처님오신날·스리랑카의 베삭절)도 마찬가지로 현지 음력 계산으로 표류합니다. 이러한 경우 date-holidays 출력을 **±1일 이내의 추정치**로 사용하고 그것을 중심으로 예약하기 전에 현지 종교 당국의 발표에 대해 검증하세요.
공휴일 목록을 Google·Outlook 캘린더로 내보낼 수 있나요?
본 도구에서 직접은 아니지만 — 자체 호스팅 자동화에는 **date-holidays npm 패키지**를 통해 기반 데이터를 사용할 수 있으며, 대부분의 주요 캘린더 앱에는 이미 내장 공휴일 구독이 포함되어 있습니다. **Google 캘린더**: 설정 → "캘린더 추가" → "관심 있는 캘린더 둘러보기" → 국가별 공휴일 캘린더 선택(Google은 ~100개국의 공식 목록을 유지). **Outlook·Microsoft 365**: 파일 → 옵션 → 캘린더 → 국가 체크박스로 "공휴일 추가". **Apple 캘린더**: 캘린더 앱 → "캘린더" → "캘린더 추가"와 대부분 국가의 사전 제공된 공휴일 구독. 이러한 내장 구독은 제공자에 의해 자동 갱신되며 정부 피드(한국의 행정안전부·일본의 内閣府)에 연결되므로 일반적으로 서드파티 도구보다 권위가 있습니다. 이 둘러볼 수 있는 공휴일 캘린더 페이지는 *빠른 조회와 시각적 계획*에 사용하고, 내장 구독은 *일상 사용*에 사용하세요.
공휴일과 은행 휴일의 차이는?
대부분의 국가에서 목록은 동일하지만 일부 — 특히 **영국**과 일부 영연방 국가 — 에서는 "은행 휴일"이 1871년까지 거슬러 올라가는 전신을 포함한 1971년 은행 및 금융 거래법에 따라 선포되는 공휴일의 **법적으로 정의된 용어**입니다. 영국의 연 8개의 은행 휴일은 은행이 법적으로 휴무하는 날이고, "공휴일"은 같은 날짜에 더해 크리스마스처럼 전통적으로 관찰되는 날(법문에서는 은행 휴일이 *아니지만* 보편적으로 그렇게 취급됨)을 포함하는 더 느슨한 용어입니다. **금융 부문**에서 이 구별은 중요합니다. ACH·SEPA·청산소 결제는 특히 은행 휴일 달력에 의존하지만 학교 휴일과 정부 사무소 폐쇄는 다를 수 있습니다. **연준의 공휴일 일정**은 미국의 등가물입니다. 수표 청산과 전신 송금 결제 시기를 결정하며 연방 직원 공휴일과 겹치지만 동일하지 않습니다. 본 도구는 각 국가의 더 넓은 "공휴일" 세트를 표시합니다. ACH 마감 계획에는 은행의 공휴일 달력과 상호 참조하세요.
미래 날짜가 공휴일인지 프로그램으로 확인하려면?
서버 측이나 예약 작업 로직에는 **date-holidays** npm 패키지를 직접 사용하세요. `npm install date-holidays` 후 `const hd = new (require("date-holidays"))("KR"); hd.isHoliday(new Date("2026-02-17"))`은 공휴일 객체나 `false`를 반환합니다. 같은 패키지가 이 UI 도구를 구동합니다. Python에는: **`holidays`** 패키지(`pip install holidays`)가 등가물이며 유사한 국가 커버리지로 공유 영역 정부 데이터에서 가져옵니다. Go에는: **`github.com/rickar/cal`**. 데이터베이스 백엔드 쿼리에는 **PostgreSQL의 pg_calendar 확장** 또는 이러한 라이브러리 중 하나에서 야간 작업을 통해 소싱한 자체 공휴일 테이블을 유지하는 것이 표준 패턴입니다. 라이브러리 로드가 과도한 일회성 확인(예: Slack 봇 리마인더 내)에는 이 UI 도구의 공개 URL이 작동합니다. `/holiday-calendar?country=KR&year=2026`은 한 해를 한눈에 보여줍니다. 한 가지 고위험 날짜(법원 제출 기한·은행 전신 마감)에 대한 권위 있는 답변에는 항상 공식 정부 출처와 교차 확인하세요.
관련 개념
공휴일은 **노동법·종교 달력·국가 정체성**의 교차점에 위치합니다. 유급 공휴일의 현대적 개념은 산업 자본주의보다 어립니다. 대부분의 국가는 **1850년에서 1920년 사이**에 노동 운동의 보장된 휴식일 요구와 종교 축일이 비공식 관찰에서 법적 보호로 세속적으로 옮겨가는 데 응답해 공식 공휴일 목록을 성문화했습니다. 영국의 **1871년 은행 휴일법**은 가장 초기의 정식 입법 성문화 중 하나이며 지금도 사용되는 "은행 휴일" 용어의 출처입니다. 프랑스의 **fête de la Fédération(1880년, 현재 바스티유 데이)**, 독일의 **Tag der Deutschen Einheit(1990년 통일 후 추가)**, 한국의 **광복절(1949년 추가)**은 각각 공휴일 달력이 국가 건설의 도구로 기능한 순간을 표시합니다.
**공휴일 군집화에 관한 경제 문헌**은 3가지 견고한 패턴을 발견합니다. 첫째, **공휴일 군집은 GDP 변동성을 증가시키지만** 연간 총계는 증가시키지 않습니다. 일본 GW와 한국 추석은 비공휴일 주에서 군집으로 소비를 이동시키지만 연간 총계는 안정적입니다. 둘째, **월요일 이동 공휴일(4일 주말)은 고정일 공휴일보다 국내 관광을 1.5~2배 증가시킵니다**. 예측 가능한 3일 주말로 여행 계획이 더 쉽기 때문입니다. 이는 미국의 "1968년 통일 월요일 공휴일법"이 4개의 연방 공휴일을 월요일로 옮긴 실증적 정당화입니다. 셋째, **세속화된 경제의 종교 공휴일은 세속화 이전 문화적 견인력의 ~70%를 유지**합니다. 가족 모임 여행량 측면에서. 크리스마스와 부활절은 명목상 세속적인 서유럽에서도 여전히 가장 큰 단일 주 여행량을 견인합니다.
3가지 **달력 인접 개념**이 공휴일 데이터와 교차합니다. **영업일**(営業日)은 공휴일을 제외한 평일이며 법적 기한 카운트, 법원 일정, 결제 사이클(T+1 / T+2), 계약 이행 창에 사용됩니다. 자매 도구 **`business-days`**가 이를 계산합니다. **근로 시간 지침**(EU 2003/88/EC·한국 근로기준법·일본 노동기준법)은 유급 휴가를 포함한 최대 시간과 최소 휴식을 규제합니다. 자매 도구 **`leave-calculator`**가 연차 부여를 다룹니다. **전례·의례 달력** — 기독교 전례 년(대림절 → 크리스마스 → 공현절 → 사순절 → 부활절), 이슬람 히즈리 년(무하람 → 라마단 → 하지), 힌두 비크람 삼바트 년(차이트라 → 디왈리 → 홀리), 유대 년(티슈레이 → 로쉬 하샤나 → 욤 키푸르 → 유월절) — 각각 자체 내부 논리를 갖고 공휴일 달력은 부분적으로 그것을 노출합니다. "뭄바이에서 언제 회의를 잡을 수 있는가"의 완전한 시야에는 세속적인 인도 공휴일 목록과 현지 종교 축제 달력 둘 다 필요합니다.
