DeadlineDays가 작성·관리합니다2026년 7월 29일 검토
공휴일 API와 공식 달력 검증: 실제 확인된 범위
API 요청 성공은 완전한 영업일 달력의 증거가 아닙니다. 이 보고서는 Round 2 출처 원장의 국가·연도별 판단을 그대로 공개하고 다섯 조합만 검증 스냅샷이 된 이유를 설명합니다.
- 게시일
- 검토일
- 출처 확인일
이 가이드의 원본 검증 자료
출처 검증 데이터셋
| 국가·연도 | 결과 | 대조 범위 | 스냅샷 판단과 한계 |
|---|---|---|---|
| US 2026 | 검증됨 | 연방 관측 휴무일 11개 | 번들 포함, 지역 API 행 제외 |
| US 2027 | 검증됨 | 연방 관측 휴무일 11개 | 번들 포함, 지역 API 행 제외 |
| GB 2026 | 검증됨 | 잉글랜드·웨일스, 스코틀랜드, 북아일랜드 | 번들 포함, 고용주 휴가 권리 제외 |
| SG 2026 | 검증됨 | 일요일을 휴일로 보는 일반 휴무 패턴의 대체일 포함 | 번들 포함, 다른 휴무 패턴 제외 |
| SG 2027 | 검증됨 | 일요일을 휴일로 보는 일반 휴무 패턴의 대체일 포함 | 번들 포함, 다른 휴무 패턴 제외 |
| GB 2027 | 미검증 | 세 지역 모두 | 스냅샷 없음, 스코틀랜드 API는 1월 2일, GOV.UK는 1월 4일 대체일 |
| KR 2026 | 미검증 | API 집합과 공식 월력 기준 발표 | 스냅샷 없음, 범위와 이후 변경 차이 |
| JP 2026 | 미검증 | 공식 국가 공휴일 전체 목록 | 스냅샷 없음, 날짜 누락과 명칭 불일치 |
| DE 2026 | 범위 불완전 | 국가 공통 행과 베를린 표본 | 스냅샷 없음, 나머지 15개 주 미대조 |
| AU 2026 | 범위 불완전 | 뉴사우스웨일스 표본 | 스냅샷 없음, 실제 주말 날짜 누락과 다른 지역 미대조 |
| CA 2026 | 미검증 | CRA 마감 달력과 API 분류 | 스냅샷 없음, 출처 목적과 국가·지역 플래그 차이 |
검증됨은 명시한 범위에서 번들 날짜를 모두 대조했다는 뜻입니다. API가 고용·은행·학교·지역·조직 달력을 완전하게 제공한다는 뜻이 아닙니다.
- 1
- API 값
- 2
- 공식 기준
- 3
- 날짜와 범위 비교
- 4
- 지원됨, 미검증 또는 미지원
바로 답하기: 다섯 조합만 스냅샷 경계를 통과했습니다
검증 번들 조합은 US 2026, US 2027, GB 2026, SG 2026, SG 2027입니다. 각 조합은 원장에 적힌 범위에서만 검증됐습니다. GB 2027, KR 2026, JP 2026, DE 2026, AU 2026, CA 2026은 검증 스냅샷으로 올리지 않았습니다.
미검증이나 범위 불완전으로 표시된 API 행도 참고 가치는 있을 수 있습니다. 그러나 수동 대조가 끝난 번들 달력으로 표현할 수는 없습니다. 실시간 API 데이터에는 미검증 경고를 표시하고, 신뢰할 수 없는 경우 미지원 또는 사용 불가 상태를 보여야 합니다.
대조 방법
2026년 7월 28일 Asia/Seoul 기준으로 각 Nager.Date 응답을 수집하고 HTTP 상태, 원문 문자 길이, UTF-8 SHA-256을 기록했습니다. 국가 공통 행과 하위 지역 행을 분리한 뒤 원장에 적힌 최신 공식 1차 출처의 날짜와 범위를 대조했습니다.
원문 접근 기록의 요청은 모두 HTTP 200이었습니다. 전송 성공만으로 검증 여부를 정하지 않았습니다. 국가별 날짜 대조와 범위 판단이 스냅샷 포함 여부를 결정했습니다.
검증된 사례와 범위 경계
미국 데이터는 주 5일 근무 연방 직원의 2026년·2027년 관측 휴무일 11개와 일치하며 지역 API 행은 제외했습니다. 영국 2026년은 잉글랜드·웨일스, 스코틀랜드, 북아일랜드의 공식 날짜와 지역 배정이 일치합니다. 싱가포르 2026년·2027년은 노동부가 설명한 일요일 휴무 패턴의 월요일 대체 규칙을 적용한 휴무일 표현과 일치합니다.
어느 결과도 민간 부문의 완전한 달력을 증명하지 않습니다. 주·지방·은행·학교·고용주·휴가 권리·다른 휴무 요일 규칙은 검증 범위 밖입니다.
스냅샷에서 제외한 이유
GB 2027은 스코틀랜드 대체일이 직접 불일치합니다. 일본 API는 공식 2026년 날짜 두 개를 누락하고 5월 6일 대체휴일 명칭도 다르게 표시합니다. 대한민국 API 범위는 이전 월력 기준 공식 발표와 다르고 이후 변경도 대조를 복잡하게 합니다. 캐나다는 API의 휴일 분류와 목적이 다른 CRA 마감 달력을 비교한 결과입니다.
독일과 호주는 일부 표본만 대조했습니다. 베를린과 뉴사우스웨일스는 확인했지만 나머지 관할을 모두 확인하지 않았으므로 국가 스냅샷을 주장할 수 없습니다.
실패, 빈 데이터, 미지원 처리
HTTP 실패, 차단된 요청, 잘못된 JSON, 형식이 맞지 않는 응답, 검증되지 않은 빈 배열은 성공한 공휴일 0개 결과가 되어서는 안 됩니다. 해석기는 검증 스냅샷, 최신 캐시, 실시간 API 순서로 확인하고 그 밖에는 미지원 또는 사용 불가 상태를 반환합니다.
인도는 현재 해석기에서 명시적으로 미지원입니다. 과거 빈 응답을 해당 연도의 공휴일이 없다는 증거로 해석하지 않습니다. 관련 국가·주·은행·조직의 공식 달력을 직접 확인해야 합니다.
미검증 실시간 결과를 사용하는 방법
실시간 행은 후보 목록으로 취급하세요. 관할과 운영 범위를 정하고 모든 날짜를 최신 공식 출처와 대조합니다. 실제일과 관측일을 분리하고 의무가 인정하는 은행·학교·고용주·운송사·조직 휴무를 추가합니다. 대조일과 불일치를 기록하세요.
목록이 그럴듯하거나 API가 HTTP 200을 반환했다는 이유로 미검증 표시를 바꾸면 안 됩니다. 검증은 주장하는 범위 전체를 대조해야 성립합니다.
정정 경로와 재현성
정정 제보에는 국가, 연도, 선택 범위, API URL, 영향받은 행, 공식 URL, 접근일, 예상 날짜나 분류, 실제 불일치를 포함하세요. 민감하지 않은 내용은 [email protected] 으로 보낼 수 있습니다.
원장의 응답 길이와 해시는 2026년 7월 28일에 수집한 원문을 식별합니다. 이후 응답은 이전 자료와 다른 버전으로 비교할 수 있습니다. 검토일과 출처 확인일은 실제 대조 작업을 다시 했을 때만 바꿉니다.
알려진 한계
이 원장은 특정 날짜의 대조 기록이며 API, 국가, 연도를 영구 인증하지 않습니다. 임시공휴일, 이후 법령 변경, 지역 결정, 고용주 정책, 은행 일정, 학교 달력, 제공자 운영은 대조 이후 바뀔 수 있습니다.
검증으로 표시된 조합과 범위만 번들에 포함합니다. 다른 연도, 다른 지역, 다른 휴무 요일 패턴, 표본 지역을 근거로 한 국가 전체 검증을 추론하지 마세요.
공식 출처
외부 공식 출처는 이 글의 검토일 이후 변경될 수 있습니다. 실제 적용 전 최신 내용을 확인하세요.
- 미국 인사관리처 - 연방 공휴일U.S. Office of Personnel Management
- GOV.UK - 은행 휴일GOV.UK
- 한국천문연구원 - 2026년 월력요항 발표한국천문연구원
- 일본 내각부 - 국민의 축일일본 내각부
- 베를린 공식 포털 - 2026년 공휴일베를린 주
- 싱가포르 노동부 - 공휴일싱가포르 노동부
- 호주 공정근로 옴부즈맨 - 2026년 공휴일Australian Fair Work Ombudsman
- 캐나다 국세청 - 공휴일Canada Revenue Agency
관련 계산기
가이드에서 확인한 조건과 적용 범위를 기록한 뒤 관련 계산기로 날짜 산술을 재현하세요.
이 가이드는 일반적인 일정 계획 정보이며 법률·세무·재무·고용 자문이 아닙니다. 구속력 있는 날짜는 공식 자료와 계약·정책 담당자에게 확인하세요.