공급자 후보 목록
모든 수치는 공급사 자체 페이지에서 가져왔으며 2026년 11월 3일에 확인했습니다. 공휴일에 누구에게 얼마를 지급하는지는 노동법과 계약으로 정해지며 어떤 API도 답해 주지 않습니다. Narwhal API는 Nusantara Ventures, LLC가 소유하고 운영합니다.
연방준비제도의 Federal Reserve Financial Services
연방준비은행이 문을 닫는 날을 피해 미국 직접 입금 급여일을 옮기는 용도에 알맞습니다.
옵션 비교
가장 적합한 서비스를 고른다고 해서 모든 서비스의 기능이 같다는 뜻은 아닙니다. 근거와 제한 사항을 함께 확인하세요.
| 공급자 | 최적 대상 | 확인한 근거 | 중요 제한 사항 |
|---|---|---|---|
| Narwhal API | 대상 37개국의 급여 계산에서 환율, 경제 지표, MCP도 같은 키로 쓰고 싶을 때. | 정부 공식 출처를 사용합니다. 연도별, 날짜별, 다음 공휴일 조회를 지원하며 범위, 현지 이름, 하위 지역 코드가 포함됩니다. 모든 계정에 월 $10 무료 크레딧이 제공되고 상업용 앱 사용도 포함됩니다. | 대형 공급사에 비해 국가 수가 훨씬 적습니다. 확인한 응답에는 대체일 필드가 없으며 영업일은 직접 코드로 계산해야 합니다. |
| Calendarific | 매우 넓은 국가 목록에 지역별 세부 정보와 공휴일 유형을 갖춘 저렴한 월 단위 시작 플랜입니다. | 230개국 이상, 3,300개 이상의 지역을 지원하며 ISO 3166-2 위치 필터를 모든 플랜에서 쓸 수 있습니다. Starter는 월 $12 또는 연 $100에 10,000회 호출입니다. | 대체일 필드나 영업일 도우미는 문서에 없습니다. Free는 500회 호출이며 출처 표기가 필요하고, Free와 Starter의 데이터는 분기마다 갱신됩니다. |
| HolidayAPI | 대체일, 영업일 계산, 결과를 보관할 권리가 필요한 다국가 급여 계산에 알맞습니다. | 250개국, 대체일, /workday 및 /workdays 엔드포인트, 1년부터 2050년 이후까지의 연도를 지원합니다. Countries는 연 $249에 월 1,000,000 요청이며 상업적 이용과 오프라인 저장이 가능합니다. | 결제는 연 단위뿐입니다. 지역 공휴일은 연 $399의 States & Provinces 플랜이 필요하며 무료 플랜의 요청 한도는 공개되어 있지 않습니다. |
| Nager.Date | 키가 필요 없고 요청 한도도 명시되지 않은 무료 호스팅 API로 충분한 프로토타입과 내부 도구에 알맞습니다. | MIT 코드이며 사용 가능 국가 엔드포인트에 204개국이 있고, Bank를 포함한 6가지 공휴일 유형과 1단계 지역을 지원합니다. 저희 테스트에서는 2025년부터 2031년까지 반환됐습니다. | 약관은 상업적 이용 시 적극적인 후원을 요구하지만 금액은 명시하지 않습니다. 이드 날짜는 빠져 있고 일부 날짜는 대략적이거나 잠정적이라고 표시됩니다. |
| Abstract API | 이미 다른 Abstract API를 쓰고 있으며 지역별 항목이 있는 공휴일 엔드포인트 하나를 원하는 팀에 알맞습니다. | 190개국 이상, 3,500개 이상의 지역을 지원하며 연도는 서기 1년부터 2050년 이후까지입니다. Free는 1,000 요청에 초당 1회이고, Standard는 연 결제 기준 월 $99입니다. | 상업적 조건은 명시되지 않았습니다. 데이터 검증 주기가 한 곳에서는 매주, 다른 곳에서는 매월로 적혀 있고, 문서는 러시아를 RE, 바하마를 BH로 표기합니다. |
| date-holidays | 쿼터도 네트워크 호출도 없이 공휴일 규칙을 프로세스 안에 두고 싶은 Node.js 급여 엔진에 알맞습니다. | 207개국, ISO 3166-2 지역, 5가지 공휴일 유형, 대체일 플래그, isHoliday(date)를 제공합니다. 3.38.0 버전은 2026년 10월 24일에 게시됐습니다. | 업데이트는 직접 배포해야 합니다. 데이터는 ShareAlike 조건의 CC BY-SA 3.0이고 npm 메타데이터에는 다른 라이선스 문자열이 적혀 있으므로, 파생 데이터를 저장하기 전에 약관을 확인하세요. |
| 연방준비제도의 Federal Reserve Financial Services | 연방준비은행이 문을 닫는 날을 피해 미국 직접 입금 급여일을 옮기는 용도에 알맞습니다. | 2026년부터 2030년까지의 FedCash 일정과 처리 종료 및 재개 시간이 담긴 FedACH 표가 있습니다. 토요일이 공휴일이면 그 앞 금요일에는 연방준비은행이 문을 엽니다. | API가 아니라 웹 페이지이며 미국 달러 결제 시스템만 다룹니다. 날짜는 직접 만든 표에 옮겨 적어야 합니다. |
요구에 따라 선택
공휴일이 주말과 겹칠 때
대체일을 문서로 제공하는 출처는 두 곳뿐입니다. HolidayAPI는 공휴일이 주말과 겹치면 원래 날짜와 다른 observed 날짜를 반환합니다. date-holidays는 대신 쉬는 날에 substitute 플래그를 붙입니다. Nager.Date, Calendarific, Abstract는 이런 필드를 문서화하지 않았고 우리가 확인한 Narwhal 응답에도 없습니다. 직원에게 앞선 금요일에 지급할지 뒤의 월요일에 지급할지는 회사 정책이므로, 그 규칙은 공휴일 목록 옆의 표에 두세요.
지역 공휴일
Calendarific은 모든 플랜에서 us-ny나 de-by 같은 ISO 3166-2 코드를 받습니다. HolidayAPI에서 같은 기능을 쓰려면 연 $399의 States & Provinces 플랜이 필요합니다. Nager.Date는 1단계까지만 지원해서 DE-BW, DE-BY, DE-ST에 Epiphany를 보여 주지만 주보다 세밀한 단위는 없습니다. date-holidays는 ISO 3166-2를 따릅니다. Narwhal 항목에는 하위 지역 코드가 있지만, 지역에 의존하기 전에 각 국가의 coverage 필드를 확인하세요.
은행 휴일, 공휴일, 기념일
급여는 보통 공휴일에 지급하고 기념일은 무시하므로 type 필드가 중요합니다. Nager.Date에는 Bank, School, Optional을 포함해 6가지 유형이 있습니다. date-holidays는 5가지입니다. Calendarific은 4가지 카테고리이며 type 필터를 모든 플랜에서 쓸 수 있습니다. HolidayAPI는 public을 true 또는 false로 지정합니다. Abstract는 자유 텍스트를 씁니다. Narwhal은 각 항목에 federal government나 national public 같은 범위를 표시합니다.
몇 년 앞까지 조회되는가
휴가 발생과 근무 일정 계획에는 다음 해 달력을 일찍 받아야 합니다. HolidayAPI와 Abstract는 둘 다 2050년과 그 이후까지 지원합니다. 저희가 Nager.Date를 테스트했을 때 2025년부터 2031년까지 반환됐고 그 범위 밖에서는 오류가 났습니다. Calendarific은 과거와 미래 연도를 지원한다고만 하고 숫자는 밝히지 않습니다. date-holidays는 규칙으로 계산하므로 고정된 범위가 없습니다. Narwhal은 연도를 경로로 받으니, 국가마다 필요한 연도를 먼저 테스트하세요.
결과 저장
유료 HolidayAPI 플랜은 구독하는 동안 오프라인 저장을 허용하고, Free는 24시간으로 제한됩니다. Nager.Date의 약관은 자체 공휴일 포털 운영을 금지하고 상업적 이용자에게 후원을 요청합니다. Calendarific은 제한을 명시하지 않으며 Free에서는 출처 표기가 필요합니다. date-holidays 데이터는 CC BY-SA 3.0입니다. Abstract는 아무 언급이 없습니다. Narwhal은 모든 계정에 상업용 앱 사용을 포함합니다. 캐시하기 전에 저장에 관해 요금 및 약관 페이지를 읽어 보세요.
크레딧이나 쿼터가 소진되었을 때
Narwhal은 402 insufficient_credits를 반환하고, 초과 요금을 부과하지 않으며, 오류는 집계하지 않습니다. 무료 크레딧은 매월 1일에 다시 채워집니다. Calendarific은 오류를 포함한 모든 요청을 집계하고 429 rate_limit_exceeded로 응답합니다. Abstract Free는 크레딧이 소진되면 422를 반환합니다. HolidayAPI 유료 플랜은 매월 1일 00:00 UTC에 초기화됩니다. Narwhal의 모든 국가에 대해 국가별 1년치를 한 번 가져오면 37회 호출로 약 $0.07입니다.
1,000회 호출당 비용
플랜 가격을 포함된 호출 수로 나눈 뒤 1,000을 곱합니다. Narwhal Calendars는 호출당 과금으로 1,000회에 $2이므로 나눌 플랜이 없습니다. Calendarific Starter는 $12 / 10,000 = 월 결제 시 $1.20, 연 $100 플랜이면 약 $0.83입니다. HolidayAPI Countries는 $249 / 12개월 / 1,000,000으로 약 $0.02입니다. Abstract Standard는 표기된 대로 월 $99에 연간 60,000 요청이면 $1,188 / 60,000 = $19.80입니다. 이 단위는 확인이 필요합니다.
휴일 여부 확인 및 영업일 도우미
HolidayAPI에는 시작일로부터 N 영업일 뒤의 날짜를 반환하는 /workday와 두 날짜 사이의 영업일 수를 세는 /workdays가 있습니다. Nager.Date에는 다음 공휴일 호출과 오늘이 공휴일인지 확인하는 호출이 있습니다. date-holidays에는 isHoliday(date)가 있습니다. Calendarific과 Abstract에는 없습니다. Narwhal에는 날짜 조회와 다음 공휴일 호출이 있고 영업일은 직접 코드로 계산하며, 결제 how-to에 그 방법이 나와 있습니다. 또한 여기서 MCP를 확인한 곳은 Narwhal뿐이며, 키 하나로 80개 도구를 쓸 수 있습니다.
이슬람력 공휴일과 이동 공휴일
이드 날짜는 달 관측에 달려 있습니다. Nager.Date는 Eid al-Fitr와 Eid al-Adha를 프로젝트에서 제외하고, 히즈라력 기반 날짜는 대략적인 날짜로 표시하므로 하루나 이틀 달라질 수 있습니다. 해당 국가의 직원에게는 정부 발표를 따르는 출처를 쓰세요. Narwhal은 정부 공식 출처를 읽으며 MCP 도구에는 히즈라력 날짜 변환이 있습니다. 직원에게 날짜를 약속하기 전에 급여를 지급하는 국가마다 확인하세요.
급여일과 은행 휴무
공휴일 목록만으로는 은행이 언제 파일을 처리하는지 알 수 없습니다. 미국 직접 입금의 경우 연방준비제도가 처리 종료 및 재개 시간이 담긴 FedACH 표를 공개합니다. 토요일이 공휴일이면 연방준비은행은 앞선 금요일에 문을 열고, 일요일이 공휴일이면 다음 월요일에 닫습니다. 이 표를 공휴일 API 옆의 두 번째 입력으로 다루고, 급여일에서 거꾸로 계산하세요.
각 제공업체의 상세 비교 페이지에는 비교에 사용한 공식 문서, 근거가 뒷받침하는 범위, 검토 날짜가 나와 있습니다. 검토됨: