ForHosting KIT · 開発者向けツール

毎月の積立額から貯金目標の達成期間を計算

この計算ツールでは、すでに貯めている金額と毎月の一定の積立額から、貯金目標に到達するまでの期間を確認できます。利息、運用益、手数料、税金、積立額の変動は含めず、分かりやすく検証しやすい基準を示します。現在の貯金額、毎月の積立額、目標額を入力すると、必要な月数、年と月の内訳、残りの必要額が表示されます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

貯金目標を具体的な期間に置き換えます

目標額を決めることは大切ですが、達成までのおおよその期間が分かると、計画はさらに立てやすくなります。まず、すでに確保している金額を現在の貯金額として入力してください。次に、毎月積み立てる予定の一定額と、最終的な目標額を入力します。計算ツールは目標額から現在の貯金額を引き、残りの必要額を求めます。その金額を毎月の積立額で割り、整数の月になるよう切り上げます。この切り上げは重要です。単純なモデルでは、1か月分に満たない積立では計画が完了しないためです。たとえば、残りが1,001で毎月の積立額が100の場合、10回の積立では1,000にしかならないため、11か月が必要です。結果には合計月数と、満年数および追加月数の内訳が含まれます。現在の貯金額がすでに目標額以上であれば、追加の積立は不要なので、結果は0か月になります。

計算結果の前提をご確認ください

この計算は、意図的に単純化した直線的な見積もりです。毎月1回、同じ金額を積み立てることを前提とし、利息、投資の成長、インフレ、手数料、税金、引き出し、収入の変化は考慮しません。そのため、結果は市場の予測ではなく、安定した比較基準としてご利用いただけます。計算式は、残りの必要額を「0」と「目標額から現在の貯金額を引いた値」の大きい方とし、その金額を毎月の積立額で割って切り上げたものが必要月数です。積立に暦上の日付を割り当てないため、特定の完了日は示さず、必要な月単位の積立回数だけを数えます。目標額が現在の貯金額を上回る場合に限り、積立額は正の数でなければなりません。まだ資金が必要なのに積立額が0以下の場合、その計画では目標に到達できないため、架空の期間ではなく入力エラーを返します。すべての金額は有限で負でない数にしてください。

条件を比較して現実的な計画を作ります

結果は、複数の条件を比べる基準として使うと効果的です。まず、無理なく毎月貯められる金額で計算し、次に積立額を少し増減させて期間の変化をご確認ください。わずかな定期増額で計画を数か月短縮できるのか、目標額自体を見直すべきなのかが分かります。緊急資金を使うことで生活の安全性が損なわれる場合は、その資金を分け、実際にこの目標へ充てる残高だけを入力してください。収入が不定期の場合は、直近の最も良い月ではなく、継続できる可能性が高い控えめな月平均をお使いください。節目ごとに新しい貯金額で再計算すれば、当初の計画が変わらないと仮定せず、見積もりを現状に合わせられます。実際の口座には利息が付く場合があり、事情によって積立が中断することもあります。自動化された計画ツールでは、APIが同じ決定論的計算を1回$0.002で実行します。

活用例

緊急資金を計画します

すでに貯めた金額から、希望する現金予備資金を作るために必要な毎月の積立回数を見積もります。

大きな買い物に備えます

利息を仮定せず、車、旅行、頭金、家電などの予定支出に対する積立額を比較します。

予算に期間を加えます

目標と定期的な予算配分を単純な月数に変換し、残高が変わったときに見直せるようにします。

よくある質問

必要な月数はどのように計算されますか？

目標額から現在の貯金額を引き、残りを毎月の積立額で割って、次の整数月へ切り上げます。

貯金の利息は計算に含まれますか？

いいえ。固定積立の分かりやすい基準を示すため、利息、運用益、手数料、税金、インフレは含めません。

すでに目標を達成している場合はどうなりますか？

将来の正の積立額を入力しなくても、結果は0か月となり、goal_already_reachedはtrueになります。

毎月の積立額が0だと拒否されるのはなぜですか？

目標額が現在の貯金額を上回る場合、0以下の積立では差額を埋められず、有限の達成期間が存在しないためです。

APIでの計算料金はいくらですか？

APIの各リクエストは$0.002です。同じ決定論的な入力からは常に同じ結果が得られます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/calc2/savings-goal-time

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/calc2/savings-goal-time \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"current_savings":2500,"monthly_contribution":500,"target_goal":10000}'

const res = await fetch("https://api.kit.forhosting.com/calc2/savings-goal-time", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "current_savings": 2500,
    "monthly_contribution": 500,
    "target_goal": 10000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/calc2/savings-goal-time",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "current_savings": 2500,
    "monthly_contribution": 500,
    "target_goal": 10000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/calc2/savings-goal-time", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"current_savings":2500,"monthly_contribution":500,"target_goal":10000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"current_savings":2500,"monthly_contribution":500,"target_goal":10000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/calc2/savings-goal-time", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "current_savings": 2500,
  "monthly_contribution": 500,
  "target_goal": 10000
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "calc2.savings_goal_time",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

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

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

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