Sparziel-Zeit-Rechner

Ein monatlicher Beitrag von null wird mit invalid_input abgelehnt, statt vorzutäuschen, Unendlichkeit sei ein Plan; negative Einzahlungen und negative Salden werden ebenfalls abgelehnt. Wenn die aktuellen Ersparnisse das Ziel bereits erreichen oder übersteigen, ist months null und already_reached wahr.

Wie man die API aufruft und was zurückkommt

Bevorzugen Sie nackte Zahlen gegenüber währungsformatierten Zeichenketten; Zeichenkettenzahlen werden nur akzeptiert, wenn sie einem strengen endlichen Zahlenmuster ohne Dollarzeichen oder Tausenderkommas entsprechen. Senden Sie einen JSON-Body mit drei erforderlichen endlichen Zahlen: goal (Aliasse target, savings_goal, amount), das nicht negative Sparziel; current (Aliasse current_savings, saved, balance), der nicht negative bereits gesparte Betrag; und monthly (Aliasse contribution, monthly_contribution, deposit), der feste positive monatliche Beitrag. Absolute Werte müssen innerhalb einer Billion bleiben, damit Zwischenprodukte in IEEE-Doppelpräzision auf dem Worker und im Browser endlich bleiben. Der monatliche Beitrag muss streng positiv sein; ein Wert von null oder nahezu null wird mit invalid_input abgelehnt, weil eine Nulleinzahlung die Lücke nie schließt, und eine negative Einzahlung wird ebenfalls abgelehnt. Bei Erfolg spiegelt die Antwort gerundete goal, current und monthly wider; setzt remaining auf den nicht negativen noch benötigten Betrag; months auf die Ganzmonatszahl; years und months_remainder auf die Ganzzahldivision von months in Zwölf-Monats-Blöcke; total_contributed auf months mal monthly; already_reached auf einen Booleschen Wert; formula auf die dokumentierte Zeichenkette; message auf eine kurze englische Zusammenfassung; und steps auf ein geordnetes Array von Substitutionszeilen. Fehlgeschlagene Validierung —fehlende Felder, nicht endliche Zahlen, Werte außerhalb absoluter Grenzen, ein negatives goal oder current, ein nuller oder negativer monthly-Beitrag, oder ein nicht endliches berechnetes remaining oder months— gibt invalid_input zurück und wird nie berechnet. Die Preisgestaltung ist ein fester $0.002 pro erfolgreicher Anfrage mit Einheit item und marginalem Stückpreis null.

Praktische Tipps, Grenzen und verwandte Suchen

Bevorzugen Sie diese Fähigkeit, wenn Sie die drei Geldbeträge bereits kennen und nur die lineare Monatszahl brauchen; wenn Ihr Plan Zinsen oder Erhöhungen enthält, nutzen Sie stattdessen ein eigenes Wachstumsmodell. Round-Trip-Prüfungen sind einfach: berechnen Sie von Hand das Maximum von null und Ziel minus aktuell, teilen Sie durch monthly, nehmen Sie die Ceiling und bestätigen Sie, dass sie dem veröffentlichten months mit derselben Zwölf-Dezimalstellen-Rundung auf den Geldfeldern entspricht. Verwenden Sie dieselbe Währungseinheit für goal, current und monthly —mischen Sie nicht Dollar und Cent, als wären sie dieselbe Skala, ohne zuerst umzurechnen. Halten Sie den monatlichen Beitrag streng positiv; kostenlose Browser-Experimente, die null senden, treffen korrekt invalid_input und werden auf der API nicht berechnet. Beim Lehren oder Testen kombinieren Sie Beispiele: Zehntausend-Ziel mit current zweitausendfünfhundert und monthly fünfhundert für einen exakten Fünfzehn-Monats-Pfad; einen Fall, in dem remaining kein Vielfaches der Einzahlung ist, sodass die Ceiling einen Extra-Monat addiert; einen Fall, in dem current das Ziel bereits erreicht oder übersteigt, sodass months null ist; und einen absichtlich nullen monthly-Beitrag, um den harten invalid_input-Pfad zu demonstrieren. Diese Seite richtet sich an Personen, die einen Sparziel-Zeit-Rechner, Monate zum Sparen für ein Ziel oder wie lange mit festem Monatsbeitrag online suchen; es ist kein Zinseszins-Zukunftswert-Werkzeug, kein Kredit-Tilgungsplan und kein Renten-Monte-Carlo. Fehlgeschlagene Aufgaben, die invalid_input zurückgeben, verbrauchen kein vorausbezahltes Guthaben, was explorative Skripte günstig hält, wenn Entwickler absichtlich einen Nullbeitrag senden.