プロバイダーの候補
数値はすべてベンダー自身のページから取得し、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を使っていて、地域別エントリを持つ祝日エンドポイントを 1つにまとめたいチーム向けです。 | 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ではなくウェブページで、対象は米ドルの決済システムのみです。日付は自分のテーブルに写してください。 |
要件に応じて選ぶ
祝日が週末に重なる場合
振替日を文書化しているのは 2つの情報源だけです。HolidayAPIは祝日が週末に重なると、日付とは別の振替日を返します。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と、2つの日付の間の営業日数を数える /workdaysがあります。Nager.Dateには次の祝日の呼び出しと、今日が祝日かの確認があります。date-holidaysにはisHoliday(date)があります。CalendarificとAbstractにはありません。Narwhalには日付の検索と次の祝日の呼び出しがあり、営業日は自分のコードで数えます。決済のハウツーにその方法があります。また、ここでMCPを確認できたのはNarwhalだけで、1つのキーで 80のツールが使えます。
イスラム暦の祝日と移動祝日
イードの日付は月の観測に左右されます。Nager.DateはEid al-FitrとEid al-Adhaをプロジェクトから外し、ヒジュラ暦に基づく日付はおおよその日付として扱い、1 日か 2 日ずれることがあります。そうした国の従業員には、政府の発表に従う情報源を使ってください。Narwhalは政府の公式情報源を読み取り、MCP ツールにはヒジュラ暦の日付変換があります。従業員に日付を約束する前に、給与を払う国ごとに確認してください。
給与支払日と銀行の休業
祝日リストは、銀行があなたのファイルをいつ動かすかを教えてくれません。米国の口座振込については、連邦準備制度が処理終了時刻と再開時刻を載せた FedACHの表を公開しています。土曜日が祝日の場合、連邦準備銀行は前の金曜日は開いていて、日曜日が祝日の場合は翌月曜日に休みます。この表を祝日 APIとは別の 2つ目の入力として扱い、支払日から逆算してください。
各プロバイダーの詳細ページには、参照した公式ドキュメント、そこから確認できる範囲、確認日を記載しています。 確認済み: