ForHosting KIT · 日付・時間

2日付間の週末日数

Q: 両端の日付は含まれますか？

はい。 早い日付から遅い日付まで（両端含む）の各暦日を対象にします。

Q: 祝日を除きますか？金曜〜土曜週末ですか？

いいえ。 先発グレゴリオ暦上の土曜と日曜のみを数えます。祝日付き営業日や独自週末定義は別ツール・別ページです。

2024年1月の週末は8日で、土曜日が4日、日曜日が4日です。2つの日付を入力すれば、両端を含めた期間の土日を同じように数えられ、勤務表や残業の決まり、休暇の計算に役立ちます。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

開始: 2024-01-01
終了: 2024-01-31

結果

開始JDN: 2,460,311
終了JDN: 2,460,341
開始曜日: Monday
終了曜日: Wednesday

2つの暦日の間に週末が何日あるかを知ることは、人員計画、残業規定、旅行予約、イベント物流、休暇計算において実務上のニーズです。週末日数カウンターを探す方は、手作業で絞り込む生の日数差ではなく、土曜と日曜を別々に、または合計で数えたいと考えています。本ツールは年-月-日の厳密なISO日付を2つ受け取り、うるう年の2月を含むグレゴリオ暦上で各日が実在するかを検証し、純整数式で天文ユリウス通日に変換したうえで、早い日付から遅い日付まで（両端含む）の各暦日に土曜と日曜が何日該当するかを報告します。入力の順序は週末合計を変えません。同じ組であれば早い日を先にしても後にしても土曜・日曜の件数は同一であり、符号付きの日方向は時系列パイプライン向けに残ります。平年の2月29日のような不可能な基準は黙って繰り越さず、明確な検証エラーで失敗します。

日付範囲内で土曜と日曜を数える方法

国際ISO形式（ハイフン区切り・固定幅）で年・月・日を書いた2つの暦日文字列から始め、どのクライアントも同じ6整数で合意できるようにします。各文字列について、年が実用的なグレゴリオ範囲（1年から9999年）にあり、月が1〜12であり、グレゴリオうるう規則の下でその月に日が存在することを確認します。

うるう年は4で割り切れる年ですが、世紀年は400でも割り切れる場合に限ります。これにより2024年や2000年の2月29日は合法、2023年や1900年は非法になります。両方の三つ組が有効なら、日付ファミリで用いるFliegelとVan Flandernの整数式で各暦日を天文ユリウス通日に変換します。

小さい通日から大きい通日までの包括区間を取るため、順序は件数を変えません。曜日は「曜日 = ユリウス通日 + 1 を7で割った余り」で、日曜を0・土曜を6とし、Unixエポックの暦曜日と一致します。区間内の完全な週はそれぞれ土曜1・日曜1を寄与し、最大6日の余りは開始曜日から走査するため、多年の長い範囲も定数時間です。

実務で週末日数カウンターが使われる場面

運用担当は2つのISO日付で定義したスケジュール窓から店舗・病院・コールセンターの週末カバー人数を見積もります。人事と給与は完全なカレンダーライブラリやブラウザ時計に頼らず、週末プレミアム時間や休息日権利を計算します。イベント企画と旅行デスクは滞在や祭りの窓内の週末泊数を料金帯と人員のために数えます。

データエンジニアは設定に保存した2本のISO文字列から、週末露出・キャンペーン休息日・オンコール負荷の派生列を具体化します。週末と祝日を除く営業日数、週全体と端数日、単一基準への日加算、年内通日だけが後で必要なら、本ページを過負荷にせず別の検索意図とランディングとして扱ってください。

活用例

人員配置と週末カバー

シフト窓内の土曜・日曜を数え、完全なカレンダーライブラリなしで週末シフト、オンコール、プレミアム給を規模設計します。

休暇と休息日の権利

2つのISO休暇日の間の週末日数を、ホストのタイムゾーンを無視する方針・旅行日・人事設定のために導出します。

イベント・滞在・キャンペーン

2本のISO暦文字列で定義した祭り・ホテル・マーケティング期間の週末泊数や週末露出を測ります。

よくある質問

両端の日付は含まれますか？

はい。早い日付から遅い日付まで（両端含む）の各暦日を対象にします。

祝日を除きますか？金曜〜土曜週末ですか？

いいえ。先発グレゴリオ暦上の土曜と日曜のみを数えます。祝日付き営業日や独自週末定義は別ツール・別ページです。

2024年1月の週末は何日ありますか？

31日間のうち、土曜日が4日、日曜日が4日で、合計8日です。最初の日付に2024-01-01、2つ目に2024-01-31を入力すると、土日別の数が表示されます。

日付を入れる順番で結果は変わりますか？

変わりません。早い日付と遅い日付のどちらを先に入力しても、土曜日と日曜日の数は同じです。変わるのは、前向きか後ろ向きかという向きの表示だけです。

存在しない日付を入力するとどうなりますか？

その日付は受け付けず、勝手に別の日付へずらすこともしません。たとえば2024年2月29日は有効ですが、うるう年でない2023年2月29日は誤りとして知らせます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/weekend-count

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

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/date/weekend-count \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2024-01-01","end":"2024-01-31"}'

const res = await fetch("https://api.kit.forhosting.com/date/weekend-count", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start": "2024-01-01",
    "end": "2024-01-31"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/weekend-count",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start": "2024-01-01",
    "end": "2024-01-31"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/weekend-count", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"start":"2024-01-01","end":"2024-01-31"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"start":"2024-01-01","end":"2024-01-31"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weekend-count", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "start": "2024-01-01",
  "end": "2024-01-31"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.weekend_count",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

料金

1リクエストあたり$0.002

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

エラー

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

技術的な注記

送信内容と返却内容

古典的な検証例は、2024年1月全体で土曜4・日曜4（週末8日）、同じ土曜1日の範囲で saturdays が1、月曜〜金曜の勤務週で週末0日です。必須文字列フィールド start と end を送ります。それぞれ 2024-01-01 や 2024-01-31 のような厳密なISO暦日です。欠落フィールド、非文字列、4-2-2桁パターンに合わない文字列、パターンは合うが実在しない日付はすべて invalid_input で失敗し課金されません。成功時は正規化済みの開始・終了ISO文字列、各側のユリウス通日、両端の英語曜日名、end − start の signed_days、閉区間の暦日数 total_days_inclusive、整数の saturdays と sundays、その和 weekend_days、forward / backward / same の direction、JDN経路を示す短い formula を返します。成功したAPI呼び出しの料金は公開ベース $0.002 毎件で、検証失敗は前払い残高を消費しません。

実務で週末日数カウンターが使われる場面

本能力は純 parse エンジンのため、API料金は成功1件あたり公開ベース $0.002 で、検証失敗は残高を消費しません。

技術的な質問

入力順で週末件数は変わりますか？

いいえ。saturdays・sundays・weekend_days は絶対包括範囲を使います。signed_days と direction は時系列パイプライン向けに end − start を反映します。

日付の一方が無効な場合は？

リクエストは invalid_input で失敗します。例：2023-02-29、2024-04-31、形式不正、フィールド欠落。無効入力は課金されません。

料金はいくらですか？

ブラウザツールは無料でローカル実行です。APIは成功1件あたり $0.002 のKIT前払い残高を使い、無効入力は課金されません。

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

2日付間の週末日数

無料で実行

計算例

日付範囲内で土曜と日曜を数える方法

実務で週末日数カウンターが使われる場面

活用例

人員配置と週末カバー

休暇と休息日の権利

イベント・滞在・キャンペーン

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

エラー

技術的な注記

送信内容と返却内容

実務で週末日数カウンターが使われる場面

技術的な質問

ありがとう