ForHosting KIT · 日付・時間

未来の日付までの週数を正確に計算

2026年7月25日から9月10日までは47日で、6週と5日、小数では6.714286週です。2つの日付を自分で決めるので、発売日などへのカウントダウンが日がたっても変わりません。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
基準日
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からも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

POSThttps://api.kit.forhosting.com/date/weeks-until-date

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"}'
{
  "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リクエストまでです。

1リクエストあたり$0.002

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

HTTPコード意味
401unauthorizedAPIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
402insufficient_balance残高が不足しています。チャージ後に再度お試しください。
404unknown_type指定されたタスクタイプは存在しません。タイプ名を確認してください。
429rate_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料金なしでご利用いただけます。

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