Vorjahreswachstumsrechner

Ein vorheriger Wert von null wird mit invalid_input zurückgewiesen, weil die Rate undefiniert ist.

Was Vorjahreswachstum bedeutet und wie der Prozentsatz definiert ist

Ist previous_value die Vorjahreszahl und current_value die Zahl dieses Jahres, so lautet die Identität growth_percent gleich current_value minus previous_value, geteilt durch previous_value, mal einhundert. Dieses Ergebnis ist ein Prozentsatz, kein Dezimal: ein Anstieg von einhundert auf einhundertzwölf ist zwölf, den ein Journalist als zwölf Prozent zitieren würde, ohne weiter zu multiplizieren.

Eingabevertrag, Form der Antwort und Verhalten bei Fehlern

Der Wert muss eine endliche Zahl sein und darf nicht null sein. Er muss eine endliche Zahl sein und darf höher, gleich oder niedriger als die Vorjahreszahl liegen. Eine fehlgeschlagene Prüfung wird nicht berechnet. Senden Sie per POST einen JSON-Körper mit zwei erforderlichen endlichen Zahlen in denselben Einheiten. previous_value ist die Vorjahreszahl und der Nenner der Rate; die Aliase previous, prior, last_year, year0 und previous_year_value werden akzeptiert, damit Tabellen vertraute Spaltennamen behalten. Fehlt previous_value, ist er leer, unendlich oder genau null, schlägt die Aufgabe mit invalid_input fehl und nennt previous_value; ein Vorjahr von null ist der vertragliche Fehler und wird nicht berechnet. current_value ist die Zahl dieses Jahres; die Aliase current, later, this_year, year1 und current_year_value zeigen auf dasselbe Feld. Jedes Feld darf als JSON-Zahl oder als numerische Zeichenkette eintreffen. Bei Erfolg wiederholt der Körper previous_value und current_value, liefert change als aktuell minus vorherig, kaufmännisch half-up auf zehn Dezimalstellen gerundet, liefert growth_percent als den Prozentsatz half-up auf zehn Dezimalstellen, setzt direction auf growth, decline oder unchanged je nach Vorzeichen des Prozentsatzes, und enthält eine formula-Zeichenkette, die die Identität wiederholt. Beispiel: vorher einhundert und aktuell einhundertzwölf ergibt growth_percent zwölf, change zwölf und direction growth. Vorher zweihundertfünfzigtausend und aktuell zweihunderttausend ergibt growth_percent minus zwanzig und direction decline.

Wo ein Vorjahreswachstumsrechner seinen Platz verdient

Finanzteams, Gründer und Unterrichtsräume nutzen einen Vorjahreswachstumsrechner, wenn die Frage lautet, wie stark sich eine Größe vom Vorjahr zu diesem Jahr geändert hat, nicht wie sie über einen längeren Horizont aufgezinst wurde. Betreiber vergleichen Vorjahresumsatz, Stückzahlen, Nutzer oder Verkehr mit der Zahl dieses Jahres, um einen Vorstand oder einen Kreditgeber zu unterrichten. Wenn Sie später eine mehrjährige Verbundrate oder ein BIP-spezifisches Dezimal brauchen, nutzen Sie jene eigenen Identitäten, statt diesen Zweizahlen-Vorjahresvertrag zu überdehnen. Produktteams legen denselben Vertrag in Dashboards, damit ein Gründer, der zwei Jahressummen eintippt, denselben growth_percent sieht, den die API später in einer Testsuite liefern wird. Weil die Umsetzung reines parse der Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Grundpreis $0.002 ohne Modell-Token und ohne ausgehendes Netz. Halten Sie Anfragen klein, pinnen Sie den gerundeten growth_percent in Tests, und Sie erhalten reproduzierbare Vorjahresprozente für Tabellen, LMS-Erweiterungen und Edge-Worker, ohne einen eigenen Zeitreihen-Client aufzustellen.