休暇カウントダウン
2026年7月25日から8月15日の出発までは残り21日、ちょうど3週間です。今日の日付と旅行の開始日を入れれば、時差に左右されない日数が分かります。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 開始
- 2026-07-25
- 休暇
- 2026-08-15
- 日数
- 21
- 週数
- 3
- 残りの日数
- 0
- 年
- 2,026
休暇カウントダウンは、一つの計画の問いに答えます。今日と旅が始まる朝のあいだに、暦の全日が何日残っているかです。この計算機は ISO の暦日を二つ受け取ります。今日の代わりとなる from と、休暇の開始日です。残り日数を返すので、休暇届、移動の予約、荷造りを当てずっぽうなしに進められます。エンジンはホスト時計を読まないため、同じ組はどのタイムゾーンでも自動試験でも常に同じ整数になります。すでに始まった旅へのカウントダウンはカウントダウンではないからです。同じ日の組は残りゼロ日、つまり休暇は今日始まります。
休暇カウントダウンが測るもの
人は出発の暦日をすでに知っていて、残りの全日数だけが欲しいとき、「休暇カウントダウン」「休みまで何日」「旅行まであと何日」と入力します。その検索は、名前のない任意の日付までの日数を聞くこととも、どちら向きにも符号つきの間隔を求めることとも、二つの時刻印のあいだの日・時・分・秒タイマーとも違います。このページは旅の開始を未来の地平として扱います。
残り日数は、休暇開始のグレゴリオ通し日番号から、今日とみなす基準日の通し日番号を引いたものです。閏日と世紀の規則は年をまたいでも一貫します。引き算が負なら、休暇は基準に対してすでに始まっており、能力はその組を拒みます。
引き算がゼロなら、休暇は今日始まり、残りはゼロです。時刻、タイムゾーン、空港の締切、営業日暦は範囲外です。単位は真夜中から真夜中の民事日です。
その安定性のおかげで、荷造りリスト、有給の届け、参照試験が、一晩でずれない一つの数を共有できます。
二つの ISO 日付の読み方と返るもの
各値は実在するグレゴリオ日でなければなりません。年は四桁、月は二桁、日は二桁で、二月二十九日は閏年にだけ許されます。年は一から九千九百九十九までの閉区間に限り、四桁 ISO 文字列がきちんと定義されるようにします。
from より前の休暇開始は、休暇日が過去であるというメッセージで失敗します。古典的な確認は、二千二十六ハイフン零七ハイフン二十五から八月中旬の出発二千二十六ハイフン零八ハイフン十五までが二十一日、二千二十四ハイフン零二ハイフン二十八から二千二十四ハイフン零三ハイフン零一までが閏日をまたいで二日、です。
休暇カウントダウンが実務の計画に現れる場面
家庭は、台所のホワイトボード、家族の会話、印刷した荷造りリストが、旅行者の電話が出発都市の西にあってもひっくり返らない一つの残り日数を必要とするときに、休暇カウントダウンを使います。人事とチームの責任者は、有給の開始日を固定の as-of 日に結び、金曜に書いた届けが月曜朝の継続的インテグレーションでも同じ整数を示すようにします。
サーバ時計を読むと、スナップショットと画面の写しが食い違います。教員は、表計算が黙って現地の真夜中を使うのを避け、二月二十九日をまたぐ旅を確かめさせるため、閏の二月と年越しの組を出します。応答のあと何も保存しません。
行事が休暇でないときは一般の指定日までの日数ツールと、どちら向きにも符号つき間隔が要るときは二日のあいだの日数ツールと、余り時間と分も要るときは時点あいだのカウントダウンと、問いが日数ではなく金銭のときは給与ごとの休暇資金ツールと組み合わせ、このページは「休暇カウントダウン」と「旅行まで何日か」という検索に残してください。
活用例
家族の荷造りと出発ボード
今日と休暇開始日を、タイムゾーンのずれなしに、ホワイトボード・会話・荷造りリスト用の一つの残り日数にします。
有給と欠勤の届け
固定の as-of 日に対して休みまでの決定的な日数を固定し、欠勤票と人事の確認がホスト時計に依存しないようにします。
よくある質問
休暇カウントダウンはどう計算しますか？
ISO 日付 YYYY-MM-DD を二つ送ってください。同じ日は 0 を返します。from より前の休暇開始は過去として拒否されます。
今日を自動で使わず、from 日付を送る必要があるのはなぜですか？
計算機はホスト時計を読まないため、どのタイムゾーンでも参照試験でも結果が同じになります。今日の代わりに from を使ってください。
閏日は残り日数を変えますか？
2024-02-28 から 2024-03-01 までは二日です。2023 年に同じ組で 2023-02-29 と書くと無効です。
休暇の日付がもう過ぎていたらどうなりますか？
マイナスの日数を出さずに、その組み合わせを受け付けません。すでに始まった旅行へのカウントダウンにはならないためです。2つの日付が同じなら0日で、休暇は今日から始まります。
残り日数は週でも分かりますか？
分かります。日数の合計に加えて、まるごとの週数と残りの日数も表示します。7月25日から8月15日までなら21日で、ちょうど3週間、端数は0日です。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/life/vacation-countdown \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"from":"2026-07-25","vacation":"2026-08-15"}'const res = await fetch("https://api.kit.forhosting.com/life/vacation-countdown", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"from": "2026-07-25",
"vacation": "2026-08-15"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/life/vacation-countdown",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"from": "2026-07-25",
"vacation": "2026-08-15"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/vacation-countdown", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"from":"2026-07-25","vacation":"2026-08-15"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"from":"2026-07-25","vacation":"2026-08-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/vacation-countdown", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"from": "2026-07-25",
"vacation": "2026-08-15"
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "life.vacation_countdown",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
制限
year_min | 1 |
year_max | 9999 |
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
休暇開始が基準日より前なら、負の数ではなく invalid_input で失敗します。成功した API 呼び出しは $0.002、検証失敗は課金されません。
休暇カウントダウンが測るもの
通し変換は Howard Hinnant の days_from_civil 恒等式に従い、民事の年-月-日の三つ組を、よく知られた Unix エポックの約束で整数の日数に写します。実装は JavaScript の Date を決して作らないため、同じ組は Worker でも、東京のブラウザでも、TZ を America/New_York にした試験台でも、常に同じ整数になります。
二つの ISO 日付の読み方と返るもの
必須フィールドは、YYYY-MM-DD 形式の現在の暦日 from と、同じ形式の休暇開始日 vacation です。基準には別名 today、current、as_of、on を受け付け、旅の開始には start、vacation_start、date、until を受け付けるので、フォーム、クエリ文字列、表計算の列が契約を再利用できます。欠落フィールド、空文字、非文字列型、壊れた形、存在しない月、閏でない二月二十九日は、フィールド名を示す invalid_input で失敗します。成功時の本体は、正規の from と vacation の文字列、残り日数、週の整数と余り remainder_days、旅の開始の year・month・day、基準の from_year・from_month・from_day、真偽値 same_day、formula 文字列、短いメッセージを返します。成功した API 要求は $0.002、無効な入力は請求されません。
休暇カウントダウンが実務の計画に現れる場面
この機能は純 parse エンジンなので、作業はこのページのブラウザ内だけで走り、API では成功した照会ごとに $0.002、検証失敗は残高を消費しません。
連携の活用例
旅行案内ページと結合試験の固定値
「出発まであと何日」ウィジェットと回帰試験に、昨年の旅行日を打つと大きく失敗する再現可能なカウントダウンを播きます。
技術的な質問
休暇日が過去だとどうなりますか。
要求は invalid_input で失敗し、課金されません。このページは将来の旅の開始へのカウントダウンであり、両方向の符号つき間隔ではありません。
休暇カウントダウンの料金はいくらですか。
このページのブラウザでは無料です。API では成功した要求が $0.002、無効な入力は課金されません。