ForHosting KIT · 開発者向けツール

月末までの残り営業日を土日・祝日を除いて計算

月内の残り営業日計算ツールは、明示されたISO日付から同じ月の最終暦日まで、月曜日から金曜日の日数を数えます。開始日が平日であればその日も含み、土曜日、日曜日、任意で指定された祝日は除外します。計算にはUTC上の純粋なグレゴリオ暦の整数演算だけを使用し、現在時刻を参照しないため、同じ入力からは常に同じ結果が得られます。応答では暦日数、週末の日数、除外した祝日数も分けて示すため、最終的な合計を簡単に確認できます。

● Beta無料・ブラウザ内で実行
ご利用方法 ウェブAPIメールTelegramアプリ 近日

集計を開始する日付をご指定ください

2026-07-20のように、厳密なYYYY-MM-DD形式で暦日を明示してください。この日付によって、最初に営業日となり得る日と、集計区間を閉じる月末日の両方が決まります。計算は開始日を含みますので、月曜日から始まる場合はその日を直ちに1日として数えられますが、土曜日から始まる場合は数えられません。今日の日付、サーバーのタイムゾーン、ブラウザーのロケールを暗黙に参照することはありません。そのため、再現可能なレポート、スケジュール済み処理、テスト、後日再計算する可能性がある記録に適しています。応答には正規化された開始日、月末日、確認した暦日数が含まれ、区間が開始日を含むことも示されます。明日から集計したい場合は、差し引きや暗黙の慣例に頼らず、明日のISO日付を明示して送信してください。存在しないうるう日や、月と日が2桁でない値などの無効な日付は、別の日付へ自動修正せずに拒否します。0001から9999までの年をグレゴリオ暦のうるう年規則で処理します。

週末と祝日を重複せずに除外します

指定日から月末までの各日付は、必ず1回だけ分類されます。土曜日と日曜日は週末の合計に入ります。任意の祝日配列に含まれる月曜日から金曜日の日付は、祝日の合計に入ります。それ以外の平日は営業日の合計に入ります。選択した区間外の祝日も有効な入力ですが、結果には影響しません。そのため、年次または地域別の祝日一覧をリクエストごとに切り詰めず、そのまま再利用できます。週末に当たる祝日によって結果が二重に減ることはなく、同じ祝日を複数回指定しても1回の除外として扱います。ただし、不正な設定を早期に検出できるよう、各祝日は実在する厳密なISO日付でなければなりません。祝日の規則は法域、雇用者、年によって異なるため、APIが国コードから祝日を推測することはありません。日付を明示することで、結果の透明性と決定性を保ちます。本ツールは月曜日から金曜日までの一般的な勤務週を想定しており、地域固有の予定に合わせて金曜日や日曜日を週末として読み替えたり、半日勤務の規則を適用したりはしません。

結果を確認して自動処理にご利用ください

主な回答にはworkdays_remainingをご利用ください。補助フィールドにより計算を検算できます。calendar_daysはweekend_days、holiday_days、workdays_remainingの合計と一致します。month_endは正確な境界を示すため、2月やうるう年で特に便利です。holiday_daysには、実際に合計を変えた平日の祝日だけが記録されます。この構造は、給与締め、配送計画、月次キャパシティーダッシュボード、サービスレベル予測、個人の期限計算などに適しています。自動連携では、将来の確認担当者が同じ数値を再現できるよう、入力日付と祝日一覧を応答と一緒に保存してください。API経由のエンドポイント料金は1リクエストあたり$0.002で、指定した祝日の数にかかわらず、各リクエストを1回の計算として扱います。処理はローカルな暦演算であり、ネットワークリクエストを行わず、リアルタイムの祝日サービスも参照しません。会社の暦に休業期間がある場合は、影響する各平日を祝日として明示してください。任意の2日間の営業日数や日付への期間加算が必要な場合は、区間集計または営業日加算の機能をご利用ください。

月次の人員稼働力

固定した報告日と会社の休業日一覧から、計画対象月に残っている平日の稼働力を見積もれます。

請求と給与の締め処理

週末と既知の社内祝日を除き、月末までに利用できる処理日数を数えられます。

再現可能な期限レポート

明示した日付と祝日一覧を保存し、月末までの残日数を後から同じ結果で再計算できます。

開始日も含まれますか?

はい。月曜日から金曜日に当たり、祝日として指定されていなければ数えます。

今日の日付を使用しますか?

いいえ。日付を明示していただく必要があり、システム時刻は一切参照しません。

祝日が週末に当たる場合はどうなりますか?

週末の日としてのみ数えるため、営業日の合計を二重に減らすことはありません。

別の月の祝日も指定できますか?

はい。対象区間外にある有効な祝日は無視され、結果には影響しません。

どの勤務週を使用しますか?

月曜日から金曜日を営業日、土曜日と日曜日を週末として扱います。

APIでの計算料金はいくらですか?

APIリクエスト1件につき$0.002です。ブラウザーではAPI料金なしで実行できます。

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

POSThttps://api.kit.forhosting.com/date/workdays-remaining-month

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

curl -X POST https://api.kit.forhosting.com/date/workdays-remaining-month \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-20"}'
{
  "date": "2026-07-20"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.workdays_remaining_month",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

HTTPコード意味
401unauthorizedAPIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
402insufficient_balance残高が不足しています。チャージ後に再度お試しください。
404unknown_type指定されたタスクタイプは存在しません。タイプ名を確認してください。
429rate_limitedリクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →