未来の日付までの週数を正確に計算
2026年7月25日から9月10日までは47日で、6週と5日、小数では6.714286週です。2つの日付を自分で決めるので、発売日などへのカウントダウンが日がたっても変わりません。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 基準日
- 2026-07-25
- 目標日
- 2026-09-10
- 合計日数
- 47
- 完全な週数
- 6
- 残り日数
- 5
- 小数の週数
- 6.714286
指定日までの週数計算では、明示的なISO基準日から、それより後の目標日までの暦日差を正確に測定します。完了した7日単位の週、残りの日数、同じ期間を表す小数週を返します。両方の日付をご指定いただくため、現在時刻、ブラウザーの場所、夏時間、サーバー設定によって結果が変わることはありません。厳密な検証により、存在しない日付や基準日より後ではない目標日も検出します。
2つのISO暦日を明示的に入力します
たとえば2026-07-25は受け付けますが、2026-7-25、July 25 2026、時刻を含む文字列は拒否します。表記を曖昧さのない1種類に限定するため、地域ごとの日月順によって結果が変わりません。この計算機は文字列の形だけでなく、実際の先発グレゴリオ暦として妥当かどうかも検証します。
そのため2月29日は2024年と2000年には有効ですが、2023年と1900年には無効であり、4月31日は常に無効です。対応する年は0001から9999までです。目標日は基準日より厳密に後でなければなりません。
今日の日付を推測して使用することはありません。入力契約も確認しやすく、表示された2つの日付だけが結果の根拠となり、タイムゾーン、ロケール、現在日について隠れた前提が計数に影響することはありません。
UTCで結果が決定的になる理由です
この機能は、指定された各日付をUTCにおける民用日の午前0時境界として扱いますが、JavaScriptのDateオブジェクトを生成せず、ホストのタイムゾーンも参照しません。代わりに年、月、日を検証し、固定算術によって各グレゴリオ暦日を整数の日番号へ変換します。その整数同士を減算すると正確な期間が得られます。
この方式なら、ローカル時刻の減算が1時間短く、または長く見えることがある夏時間の切り替えや、実行環境ごとに異なる日付解析規則を回避できます。応答には両方のISO入力を再掲するため、後続の記録だけでも根拠を確認できます。不正な値を暗黙に補正することはなく、明確に失敗します。
存在しない日付が翌月へ繰り越されることもありません。ブラウザーでは無料でお試しいただけます。
活用例
固定された節目を計画します
承認済みの計画日から、その後の納品日、開始日、公開日までを整数週と小数週で測定します。
再現可能なカウントダウンを作ります
目標日とともに基準日を明示して保存し、現在日が進んでも変化しないレポートを再生成します。
将来の期間を比較します
小数週を使い、契約期間、学習計画、キャンペーン、プロジェクト段階を共通の尺度で比較します。
よくある質問
小数週はどのように計算しますか?
正確な暦日差を7で割り、小数点以下6桁で返します。整数週と残り日数も別々に返します。
夏時間によって答えが変わりますか?
いいえ。 UTCの意味に基づくグレゴリオ暦の整数日演算を使い、ローカル時刻やJavaScriptのDateオブジェクトは使用しません。
2026年7月25日から9月10日までは何週ですか?
47日あり、6週と5日、小数で表すと6.714286週です。小数の値は期間全体を表すもので、6週に足す端数の週ではありません。
目標日を基準日と同じ日や前の日にできますか?
できません。目標日は基準日より後でなければなりません。同じ日や過去の日を入れると受け付けず、未来の日までに残る週数だけを答えます。
週末や祝日は数から除かれますか?
除かれません。暦の日をすべて数えるので、月曜日から次の月曜日まではちょうど7日、1週です。営業日ではなく、カウントダウンや契約期間の確認に向いています。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/date/weeks-until-date \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"reference_date":"2026-07-25","target_date":"2026-09-10"}'const res = await fetch("https://api.kit.forhosting.com/date/weeks-until-date", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"reference_date": "2026-07-25",
"target_date": "2026-09-10"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/weeks-until-date",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"reference_date": "2026-07-25",
"target_date": "2026-09-10"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/weeks-until-date", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"reference_date":"2026-07-25","target_date":"2026-09-10"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"reference_date":"2026-07-25","target_date":"2026-09-10"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/weeks-until-date", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"reference_date": "2026-07-25",
"target_date": "2026-09-10"
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.weeks_until_date",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
2つのISO暦日を明示的に入力します
reference_dateとtarget_dateは、先頭のゼロを省略せず、固定形式YYYY-MM-DDで指定してください。同じ日付や基準日より前の目標を指定するとinvalid_inputエラーになります。この機能は、既知の開始日から既知の将来日まであと何週間あるか、という明確に限定された問いに答えるものだからです。同じリクエストを翌月に実行しても、基準日は時計から取得せずリクエスト自体に含まれるため、同じ回答になります。この性質により、保存した計算、監査記録、テスト、定期ジョブを再現できます。
整数週、残り日数、小数週の意味を確認します
ある午前0時から次の午前0時への移動が1日なので、月曜日から翌週の月曜日までは正確に7日、つまり1週間です。週末や祝日は除外しません。すべてを通常の暦日として扱うため、カウントダウン計画、プロジェクトの節目、契約期間、その他の経過日計算に適していますが、営業日カレンダーの計算ではありません。結果のtotal_daysは、基準日と目標日の間にある午前0時から次の午前0時までの区間数です。whole_weeksはその日数を7で割った整数商で、remaining_daysは0から6までの余りです。fractional_weeksは期間全体を週で表す値であり、total_daysを7で割り、表示するJSON数値を小数点以下6桁に丸めます。したがって47日間は、6整数週、残り5日、6.714286小数週です。これらのフィールドは同じ期間を補完的に示します。fractional_weeksはwhole_weeksに加算する別の端数週ではありません。完了した7日単位だけを数える場合はwhole_weeks、予定表で残りの暦日が必要な場合はremaining_days、小数を扱える見積もり、グラフ、比率、比較にはfractional_weeksをご利用ください。この計算では両端の日をそれぞれ1日として数えません。
UTCで結果が決定的になる理由です
アルゴリズムはネットワークリクエスト、乱数、現在のタイムスタンプ、ロケール依存のパーサーを一切使用しません。そのため同じ入力は、ブラウザー、エッジworker、テストスイート、後日の再実行のどこでも同じJSONになります。成功したAPI項目には公開基本料金$0.002が適用されます。この処理は2つの短い文字列と定数時間の整数演算だけに依存するため、時計のずれや外部サービスの可用性を処理工程へ持ち込まず、繰り返しの自動確認に利用できます。
技術的な質問
この計算機は今日の日付を使用しますか?
いいえ。reference_dateとtarget_dateの両方をご指定いただくため、計算が現在の時計に依存することはありません。
目標日は後の日付でなければなりませんか?
はい。同じ日付と基準日より前の目標はinvalid_inputとして拒否します。この機能は将来の目標までの時間を測定するためです。
APIによる計算の料金はいくらですか?
成功した各項目には公開基本料金$0.002が適用されます。ブラウザーの計算機はAPI料金なしでご利用いただけます。