US-Einkommensperzentil

Fehlendes Einkommen, negatives Einkommen und nicht endliche Zahlen scheitern mit invalid_input und werden nicht berechnet. Erfolgreiche Aufrufe werden mit $0.002 berechnet.

Eingabevertrag, Fehlerverhalten und Form der Antwort

Größen über der veröffentlichten Grenze scheitern ebenfalls. Beispiel: achtzigtausend Dollar landen auf dem Medianknoten und liefern percentile 50, rank 50th und band middle. Zweihundertfünfundzwanzigtausend Dollar liegen in der Mitte zwischen den Knoten zweihunderttausend und zweihundertfünfzigtausend und liefern percentile 87. Verknüpfen Sie den Rang mit Ihren eigenen Lebenshaltungskosten, wenn Sie regionalen Kontext brauchen; dieser Endpunkt ordnet nur gegen eine nationale Haushaltstabelle. Senden Sie per POST einen JSON-Körper mit einem Pflichtfeld: income, das jährliche Haushaltseinkommen in den Vereinigten Staaten in Dollar. Es muss eine nicht negative endliche Zahl sein; die Aliase annual_income, household_income, amount und salary werden akzeptiert, damit eine Gehaltszeile keinen rename-Schritt braucht. JSON-Zahlen sind vorzuziehen; numerische Zeichenketten, die als endliche Dezimalzahl gelesen werden, sind zulässig. Fehlendes Einkommen, eine leere Zeichenkette, NaN, Infinity, ein nicht numerischer Wert oder ein negativer Betrag scheitern mit invalid_input unter Nennung des Feldes und werden nicht berechnet, weil ein Perzentil für ein negatives Haushaltseinkommen auf dieser Tabelle nicht definiert ist. Bei Erfolg wiederholt der Körper income und liefert dann percentile als interpolierten Rang auf einer Skala 0–100, percentile_rounded als nächste ganze Zahl, rank als englische Ordnungszahl dieser ganzen Zahl — etwa 50th oder 91st —, share_below gleich dem Perzentil, share_above gleich 100 minus dem Perzentil und band als grobe Kennzeichnung wie bottom_20, lower_middle, middle, upper_middle, top_20, top_10, top_5 oder top_1. Die Antwort nennt außerdem die Rahmenknoten lower_income, lower_percentile, upper_income und upper_percentile, plus method linear_interpolation und eine formula-Zeichenkette, die Sie neben der Antwort anzeigen können. Der Preis eines erfolgreichen Postens ist ein pauschales $0.002.

Wo ein US-Einkommensperzentilrechner seinen Nutzen hat

Kurse der Verbraucher Mathematik vergeben Verteilungsblätter und brauchen ein Orakel, das ein negatives Einkommen als invalid_input markiert statt es still auf null zu stutzen. Vergütungsdashboards und Haushaltsbudgethefte rufen denselben Vertrag zu $0.002 je erfolgreichem Posten auf, ohne eine Census-Download-Pipeline aufzustellen. Halten Sie Anfragen klein, pinnen Sie das interpolierte Perzentil in Tests, und Sie erhalten einen reproduzierbaren US-Haushaltsrang für Artikel, Angebotsschreiben und schlanke Finanz-Webhooks, ohne vorzugeben, die Tabelle sei das Mikrodatum der diesjährigen Erhebung.