指定日までの日数
2026年7月25日から2026年12月25日までは、あと153日です。数え始める日と待っている日付を入れると、残りの暦日数が分かります。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 開始
- 2026-07-25
- 日付
- 2026-12-25
- 日数
- 153
- 残り日数
- 153
- 年
- 2,026
- 月
- 12
この「指定日までの日数」計算機は、日常の計画の問い—選んだ基準日から、未来の暦日まであと何日の全日が残るか—に答えます。年-月-日形式の ISO 暦日を二つ送ります。今日の代わりとなる from と、数え先の目標日です。エンジンは負でない残り日数を返します。同じ日の組は残りゼロ日です。
未来日までの日数とは何か
人は目標の暦日をすでに知っていて、残りの全日数だけが欲しいとき、「クリスマスまで何日」「結婚式まで何日」「締切まであと何日」と入力します。その検索は、任意の二日のあいだをどちら向きにも数えることとも、十二月三十一日までの残りだけを聞くこととも違います。このページは目標を未来の地平として扱います。
残り日数は、目標のグレゴリオ通し日番号から基準の通し日番号を引いたものです。閏日と世紀の規則は年をまたいでも一貫します。引き算が負なら、目標は基準に対して過去にあり、能力はその組を拒みます。
引き算がゼロなら、出来事は同じ暦日で、残りはゼロです。時刻、タイムゾーン、営業日暦は範囲外です。単位は真夜中から真夜中の民事日です。
二つの ISO 日付の読み方と返るもの
各値は実在するグレゴリオ日でなければなりません。年は四桁、月は二桁、日は二桁で、二月二十九日は閏年にだけ許されます。年は一から九千九百九十九までの閉区間に限り、四桁 ISO 文字列がきちんと定義されるようにします。
from より前の目標は、日付が過去であるというメッセージで失敗します。古典的な確認は、二千二十六ハイフン零七ハイフン二十五からクリスマスの二千二十六ハイフン一二ハイフン二十五までが百五十三日、二千二十四ハイフン零二ハイフン二十八から二千二十四ハイフン零三ハイフン零一までが閏日をまたいで二日、です。
指定日までの日数カウントダウンが実務に現れる場面
婚礼や祝日の計画者は、カード、サイトの帯、印刷用の招待状が、訪問者のタイムゾーンが開催都市の西にあってもひっくり返らない一つの残り日数を必要とするときに、この数字を使います。教員は、表計算が黙って現地の真夜中を使うのを避け、閏の二月と年越しの組を確かめさせるため、カウントダウンの宿題を出します。
転居日、査証の予約、学期の開始に向けて数える家庭は、誤って昨年の日付を打ったときに、カウントダウンに見える符号付き負数ではなく、はっきりした拒否を望みます。応答のあと何も保存しません。
どちら向きにも符号付き間隔が要るときは二日のあいだの日数ツールと、地平が常に十二月三十一日のときは年内残り日数ツールと、余り時間と分も要るときは日付あいだのカウントダウンと組み合わせ、このページは「この未来日まで何日か」という一つの検索に残してください。
活用例
祝日と婚礼のカウントダウン
基準日と未来の行事日を、タイムゾーンのずれなしに、カード・帯・招待状用の一つの残り日数にします。
授業での閏年と年越しの確認
現地の真夜中を使う表計算なしに、二月二十九日と新年をまたぐ全日カウントダウンを学習者が確かめられます。
よくある質問
未来日までの日数はどう計算しますか？
グレゴリオ暦で days = serial(date) − serial(from) です。ISO 日付 YYYY-MM-DD を二つ送ってください。同じ日は 0 を返します。from より前の目標は過去として拒否されます。
閏日は残り日数を変えますか？
はい。 2月29日は from と date のあいだに厳密に入るとき数えられます。2024-02-28 から 2024-03-01 までは二日です。2023 年に同じ組で 2023-02-29 と書くと無効です。
目標の日付がすでに過ぎているとどうなりますか？
日数は出ません。カウントダウンなので、開始日より前の日付はマイナスの数にせず、受け付けない仕組みです。
時差や時刻で結果は変わりますか？
変わりません。真夜中から真夜中までの暦日で数えるため、同じ2つの日付なら、どこにいても同じ日数になります。
目標の日付が今日だとどうなりますか？
結果は0日です。開始日と目標の日付が同じ暦日なら、その日はすでに来ているので、残りの日数はありません。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/life/days-until \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-12-25","from":"2026-07-25"}'const res = await fetch("https://api.kit.forhosting.com/life/days-until", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2026-12-25",
"from": "2026-07-25"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/life/days-until",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2026-12-25",
"from": "2026-07-25"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/days-until", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2026-12-25","from":"2026-07-25"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2026-12-25","from":"2026-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/days-until", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"date": "2026-12-25",
"from": "2026-07-25"
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "life.days_until",
"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 形式の未来目標 date と、今日の代わりとなる基準暦日 from です。目標には別名 until、target、to、end を受け付け、基準には today、start、as_of、on を受け付けるので、フォーム、クエリ文字列、表計算の列が契約を再利用できます。欠落フィールド、空文字、非文字列型、壊れた形、存在しない月、閏でない二月二十九日は、フィールド名を示す invalid_input で失敗します。成功時の本体は、正規の date と from の文字列、残り日数と days_left（同じ非負整数）、目標の year・month・day、基準の from_year・from_month・from_day、真偽値 same_day、formula 文字列、短いメッセージを返します。成功した API 要求は $0.002、無効な入力は請求されません。
指定日までの日数カウントダウンが実務に現れる場面
この機能は純 parse エンジンなので、作業はこのページのブラウザ内だけで走り、API では成功した照会ごとに $0.002、検証失敗は残高を消費しません。
連携の活用例
公開ウィジェットと結合試験の固定値
ホスト時計に依存してはならない「公開まで何日」画面と試験のために、決定的な残り日数の整数を固定します。
技術的な質問
今日を自動で使わず、from 日付を送る必要があるのはなぜですか。
計算機はホスト時計を読まないため、どのタイムゾーンでもゴールデン試験でも結果が同じになります。今日の代わりに from を使ってください。
目標日が過去だとどうなりますか。
要求は invalid_input で失敗し、課金されません。このページは未来日へのカウントダウンであり、両方向の符号付き間隔ではありません。
指定日までの日数計算機の料金はいくらですか。
このページのブラウザでは無料です。API では成功した要求が $0.002、無効な入力は課金されません。