Ziel-Abschlussdatum

Eine Tagesrate von null wird mit invalid_input abgelehnt, statt Unendlichkeit als Plan vorzutäuschen; negative Raten und negative Salden werden ebenfalls abgelehnt.

Was das Ziel-Abschlussdatum bei fester Tagesrate bedeutet

Er wendet nur die Arithmetik an: remaining ist das Maximum von null und goal minus current, days ist null wenn remaining null ist, sonst ist days das Ceiling von remaining über daily_rate, und completion_date ist start_date plus so viele gregorianische Kalendertage ohne die Host-Uhr.

Wie Sie die API aufrufen und was zurückkommt

Unmögliche Kalendertage wie der neunundzwanzigste Februar in einem Nichtschaltjahr scheitern an der Validierung mit einer klaren Feldmeldung. Senden Sie einen JSON-Body mit vier Pflichtfeldern: goal (Aliase target, target_amount, amount), das nichtnegative numerische Ziel; current (Aliase current_amount, progress, completed), die nichtnegative bereits erledigte Menge; daily_rate (Aliase rate, daily_progress, progress_rate), der feste positive Tagesfortschritt; und start_date (Aliase date, as_of, current_date), eine strenge ISO-Kalenderzeichenkette YYYY-MM-DD, die ein reales gregorianisches Datum ist. Absolute Geld- oder Zählwerte müssen innerhalb einer Billion bleiben, damit Zwischenprodukte in IEEE-Doppelgenauigkeit auf dem Worker und im Browser endlich bleiben. Die Tagesrate muss streng positiv sein; ein Wert von null oder nahezu null wird mit invalid_input abgelehnt, weil eine Nullrate eine positive Lücke nie schließt, und eine negative Rate wird ebenfalls abgelehnt. Bei Erfolg spiegelt die Antwort gerundetes goal, current und daily_rate plus das normalisierte start_date; setzt remaining auf die nichtnegative noch benötigte Menge; days_needed auf die Ganzzahl der Tage; weeks und days_remainder auf die Ganzzahldivision der Tage in Siebenertage-Blöcke; amount_at_rate auf Tage mal Tagesrate; completion_date auf das projizierte ISO-Datum; 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, negatives goal oder current, null oder negative daily_rate, ungültiges Datum oder eine Projektion außerhalb des Jahresbereichs 0001–9999—liefert invalid_input und wird nie berechnet. Der Preis ist pauschal $0.002 pro erfolgreicher Anfrage mit Einheit item.

Praktische Tipps, Grenzen und verwandte Suchen

Bevorzugen Sie diese Fähigkeit, wenn Sie die drei Fortschrittszahlen und ein Stichtagsdatum bereits kennen und nur den linearen Kalender-Abschlusstag brauchen; umfasst Ihr Plan Zinsen, Zinseszins oder Werktagskalender, nutzen Sie stattdessen ein eigenes Modell. Verwenden Sie dieselbe Einheit für goal, current und daily_rate—mischen Sie Seiten und Wörter oder Dollar und Cent nicht, ohne zuerst umzurechnen. Halten Sie die Tagesrate 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: eintausend Ziel mit zweihundertfünfzig aktuell und fünfundzwanzig pro Tag ab dem ersten Januar für einen exakten dreißig-Tage-Weg bis zum einunddreißigsten; einen Fall, in dem der Rest kein Vielfaches der Rate ist und das Ceiling einen Extra-Tag hinzufügt; einen Fall, in dem current das Ziel bereits erreicht oder überschreitet, also days null ist und der Abschluss dem Start entspricht; und eine absichtlich null gesetzte Tagesrate, um den harten invalid_input-Pfad zu zeigen. Diese Landingpage zielt auf Personen, die nach einem Ziel-Abschlussdatum-Rechner, Fertigstellungsdatum aus Tagesfortschrittsrate oder Rest geteilt durch Rate online suchen; es ist kein Sparmonate-Werkzeug mit monatlichen Einzahlungen, kein Werktagsplaner, der Wochenenden überspringt, und keine Monte-Carlo-Geschwindigkeitsprognose. Fehlgeschlagene Aufgaben, die invalid_input liefern, verbrauchen kein Prepaid-Guthaben, was explorative Skripte günstig hält, wenn Entwickler absichtlich eine Nullrate senden. Round-Trip-Prüfungen sind einfach: berechnen Sie von Hand das Maximum von null und goal minus current, teilen Sie durch daily_rate, nehmen Sie das Ceiling, addieren Sie so viele Kalendertage zum Startdatum mit einer bekannten gregorianischen Bibliothek oder einem Papierkalender und bestätigen Sie die Übereinstimmung mit dem veröffentlichten completion_date innerhalb derselben Zwölf-Dezimalstellen-Rundung auf Mengenfeldern.