日付に日数を加算
日付に日数を足すか引くと、結果の日付が正確に分かります。2024年3月1日に10日を足すと2024年3月11日です。うるう年や月の長さの違いも自動で考慮され、ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 日付
- 2024-03-01
- 加算日数
- 10
- 算出日
- 2024-03-11
- 年
- 2,024
- 月
- 3
- 日
- 11
固定の暦日数を日付に加える操作は、うるう年・各月の日数・無効な基準文字列が絡むと単純ではなくなります。プロジェクト管理者はキックオフから三十日後のフォローを予定し、財務チームは請求書の支払期限を計算し、サポート窓口は七日以内の返信を約束し、データパイプラインは純粋な日数オフセットでイベント時刻をずらします。本ツールは厳格な年-月-日形式のISO基準日と、正・負・ゼロのいずれでもよい整数日オフセットを受け取り、うるう年の二月を含むグレゴリオ暦上に基準日が実在することを検証し、ホスト時計やJavaScriptのDateオブジェクトを一切参照せずに結果の暦日を返します。平年の二月二十九日のような存在し得ない基準は、三月に繰り越さず明確な検証エラーで失敗します。
時計なしで暦日加算が動く仕組み
基準となる暦日を、ハイフン区切りの固定幅で年・月・日を表す国際ISO形式で書き、すべてのクライアントが同じ三つの整数で合意できるようにします。年が実用的なグレゴリオ範囲にあること、月が一から十二であること、その月の日がグレゴリオのうるう規則で存在することを確認します。うるう年は四で割り切れる年ですが、世紀年は四百でも割り切れる場合に限られます。
この規則により二千二十四年や二千年では二月二十九日が合法、二千二十三年や千九百年では違法になります。三組が有効なら、それ以前の完全な月の長さを足し、月内の日を加えて年内通算日（序数）に変換します。その序数に整数オフセットを加えます。
合計が当年の日数を超える間は、その長さを引いて年を進め、一未満になる間は年を戻して前年の長さを加えます。最後に安定した序数を月と日に戻し、四-二-二のISO文字列として整形します。
日数加算計算が実務で使われる場面
請求システムは請求日にネット三十暦日を足して支払期限を求め、完全なスケジューリングライブラリを引き込みません。カスタマーサクセスツールはオンボーディングイベントから七または十四日後にリマインダを設定します。法務・コンプライアンスは営業日ではなく暦日で通知期間を追跡します。
データエンジニアは単一のISO基準と設定に保存した整数オフセットから、保持期間・トライアル終了・キャンペーン終了の派生列を生成します。週末と祝日を除く営業日数、二日付の日数差、生年月日から年齢、年内通算日だけが必要な場合は、この「日付に日数を加算する」ページを肥大化させず、別の検索意図とランディングとして扱ってください。
活用例
請求・サブスクリプションの支払期限
請求書のISO日付にネット十五日または三十暦日を加え、タイムゾーンやホストに依存しない支払期限を生成します。
リマインダとフォローアップ
チケットやキックオフ日から七・十四・九十日後のサポート／営業フォローを、純粋な日数演算で予定します。
よくある質問
日付に日数を加算するとは何ですか？
有効なグレゴリオ暦の一日を取り、整数の暦日数だけ前後へ移動することです。月・年の境界や、該当する場合のうるう日も正しく越えます。
うるう年に対応していますか？
はい。 グレゴリオのうるう規則を適用します。4で割り切れる年、ただし世紀年は400でも割り切れる場合のみ。2月29日はうるう年のみ受理され、オフセットがその日に着地または通過するとき正しく扱われます。
必要な日付形式は何ですか？
厳格なISO YYYY-MM-DDで、年は四桁、月と日は二桁です。2024-3-1や2024/03/01のような値は拒否され、すべてのクライアントが同じ文字列で合意します。
2023-02-29のような無効な基準日ではどうなりますか？
エラーメッセージは、その年と月ではその日が無効であることを説明します。
日数を引くこともできますか？
はい、できます。マイナスの数を入力すると過去へ戻り、たとえばマイナス7なら1週間前の日付になります。0を入力すると同じ日付がそのまま返ります。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/date/add-days \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-01","days":10}'const res = await fetch("https://api.kit.forhosting.com/date/add-days", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-01",
"days": 10
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/add-days",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-01",
"days": 10
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/add-days", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-01","days":10}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-01","days":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/add-days", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"date": "2024-03-01",
"days": 10
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.add_days",
"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 | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
送信する内容と返ってくる内容
必須は二項目です。 dateは二千二十四年ハイフン零三ハイフン零一のような厳格なISO暦日、daysは十・零・負の七のような有限整数の日数です。定番の確認例は、二千二十四年三月一日に十日を加えて三月十一日にすること、平年の二月二十八日に一日を加えて三月一日にすること、うるう年の二月二十八日に一日を加えて二十九日にすること、月曜日相当のISO日から七日を引いて前週に着地することです。欠落フィールド、文字列でない日付、四-二-二桁パターンに合わない文字列、非整数の日オフセット、パターンには合うが実在しない暦日はすべてinvalid_inputで失敗し課金されません。成功時の応答は正規化済み基準日、適用した整数daysオフセット、加算後のresult ISO文字列、結果の数値の年・月・日、結果年の真偽値is_leap_year、うるう規則を示す短いformula文字列を返します。成功したAPI呼び出しの料金は公開ベースの$0.002／件で、検証失敗はプリペイド残高を消費しません。
日数加算計算が実務で使われる場面
本機能は純粋なparseエンジンのため、API料金は成功一件あたり公開ベースの$0.002で、検証失敗は残高を消費しません。
連携の活用例
保持期間とトライアル窓
開始ISO文字列と設定済み整数日オフセットから、トライアル終了日と保持カットオフをパイプラインやQA fixture向けに導出します。
技術的な質問
料金はいくらですか？
ブラウザツールは無料でローカル実行です。APIリクエストはプリペイドKIT残高を成功一件あたり$0.002で使用し、無効入力は課金されません。