貯蓄目標までの日数

ゼロまたは負の積立は無限大を計画と偽る代わりに invalid_input で拒否され、負の残高も拒否されます。現在残高がすでに目標以上なら days はゼロ、already_reached は true です。経路は純粋な決定論的算術で、ネットワークも金利モデルも乱数シードも壁時計依存もなく、無料のブラウザ実行と前払い API は固定小数丸め後に毎回同じ JSON を返します。

毎日・毎週の定額積立における目標到達日数の意味

remaining はゼロと goal から current を引いた値の最大、deposits は remaining がゼロならゼロ、そうでなければ remaining を deposit で割った切り上げ、days は毎日なら deposits、毎週なら deposits の七倍です。

API の呼び出し方と返却内容

正でない積立では正の不足を埋められないためです。通貨形式の文字列より素の数を好み、数値文字列はドル記号やカンマのない厳密な有限数パターンに一致する場合のみ受け付けます。必須フィールド四つの JSON 本体を送ってください。goal（別名 target, savings_goal, amount）は非負の有限な貯蓄目標、current（別名 current_savings, saved, balance）はすでに貯めた非負額、deposit（別名 deposit_amount, contribution, amount_per_period）は期間あたりの正の定額、frequency（別名 period, cadence, deposit_frequency）は daily または weekly の文字列で、大文字小文字を問わず day, d, week, w の短縮も受け付けます。金額フィールドの絶対値は一兆以内に保ち、Worker とブラウザの IEEE 倍精度で中間積が有限になるようにします。積立額は厳密に正でなければならず、ゼロ・ほぼゼロ・負は invalid_input で拒否されます。成功時、応答は丸めた goal, current, deposit を返し、frequency を正規化した daily または weekly にし、remaining をなお必要な非負額、deposits_needed を整数の積立回数、days を暦日数、weeks と days_remainder を日数の便利な分割、total_contributed を deposits_needed と deposit の積、already_reached を真偽値、formula を文書化された文字列、message を短い英語要約、steps を代入行の順序付き配列にします。検証失敗—欠落フィールド、非有限数、絶対限界外、負の goal や current、正でない deposit、不明な frequency、非有限の計算結果—は invalid_input を返し課金されません。料金は成功リクエストごとに定額 $0.002、単位は item です。

実用上の注意、制限、関連する検索

指導やテストでは例を組み合わせてください。複利の将来価値ツールでも、月単位の到達月数プランナーでも（その意図には月向け計算機を）、ローン償却表でもありません。金額がすでに分かり毎日または毎週の線形日数だけが必要なときに本能力を選び、金利・昇給・月次予算の言葉が含まれる計画なら成長モデルや月次モデルを選んでください。goal, current, deposit には同じ通貨単位を使い、換算なしにドルとセントを同じ尺度として混ぜないでください。積立は厳密に正に保ち、ゼロを送る無料ブラウザ実験は正しく invalid_input になり、API では課金されません。目標一千・current 二百・毎日五十でちょうど十六日、残が deposit の倍数でない週次で切り上げが一週増え日数が七倍、current がすでに目標以上で days がゼロ、わざとゼロの deposit で硬い invalid_input 経路、などです。このランディングは、定額積立で貯蓄目標までの日数、貯金箱計算機、毎日または毎週の拠出で何日かかるか、を探す人向けです。invalid_input を返す失敗タスクは前払い残高を消費しないため、開発者がわざと悪い deposit を送る探索スクリプトも安く保てます。往復確認は簡単です。 手でゼロと goal から current を引いた最大を求め、deposit で割り、切り上げ、頻度に応じて一または七を掛け、金額フィールドの同じ十二桁丸めのもとで公開 days と一致することを確認します。