Calcolatore del potere d'acquisto

Questo calcolatore del potere d'acquisto restituisce quel valore rivalutato da tre ingressi—amount, inflation_rate e years—e rifiuta un orizzonte negativo invece di inventare un passato che la formula non era chiamata a ricostruire.

Che cosa significa il potere d'acquisto restante e come funziona la formula

L'identità standard di capitalizzazione annuale che cattura quell'erosione è buying_power uguale ad amount diviso per (uno più il tasso di inflazione annuo in decimale) elevato al numero di years. In modo equivalente, si calcoli un fattore di inflazione (uno più r) elevato a years, poi si divida amount per quel fattore.

Contratto di ingresso, forma della risposta e comportamento in errore

Se years è negativo il gestore fallisce con un messaggio che years non deve essere negativo—la guardia richiesta, perché un orizzonte negativo non è un problema ben posto di potere restante per questa landing. Se amount è negativo la richiesta viene rifiutata invece di restituire una cifra di cassa negativa. Abbini il risultato alla propria serie CPI se servono livelli di indice ufficiali; inizi qui quando la domanda di prodotto è un valore trasparente rivalutato a tre ingressi per una pagina, un foglio di lavoro o un lotto di scenari. Invii con POST un corpo JSON con tre numeri finiti obbligatori: amount (unità di valuta della somma di cui vuole il valore reale, maggiore o uguale a zero; alias principal, value, sum, money), inflation_rate (inflazione annua in percentuale, ad esempio tre per il tre per cento; alias rate, rate_percent, annual_inflation, inflation) e years (l'orizzonte di capitalizzazione, maggiore o uguale a zero; alias n, period, horizon). Ogni campo può arrivare come numero JSON o come stringa numerica. Campi mancanti, stringhe vuote e valori non finiti falliscono con invalid_input nominando il campo e non vengono addebitati. Se inflation_rate è minore o uguale a meno cento per cento, uno più r non è positivo e la potenza non è un fattore reale utile, quindi anche quel caso è invalid_input. In caso di successo il corpo ripete amount, inflation_rate e years; riporta inflation_factor arrotondato a otto decimali; restituisce buying_power e purchasing_power_loss come denaro arrotondato half-up a due decimali; restituisce purchasing_power_ratio arrotondato a sei decimali; e include una breve stringa di formula che riformula l'identità.

Dove un calcolatore del potere d'acquisto merita il suo posto

Le redazioni che convertono uno stipendio storico, una multa d'epoca o un cartellino d'epoca nei termini di oggi possono inviare gli stessi tre numeri che il giornalista ha già e citare la cifra rivalutata con un contratto stabile a due decimali. Chi insegna la differenza tra saldi nominali e potere d'acquisto reale può seminare esempi d'aula che mostrano l'erosione al tre per cento contro il cinque per cento, e dimostrare il fallimento duro quando qualcuno digita un conteggio di anni negativo. La convalida fallita non consuma saldo. Gli strumenti di pensione e di cuscinetto di cassa spesso memorizzano un'ipotesi di inflazione prevista accanto a un nido-obiettivo; chiamare questo endpoint riempie una scheda che mostra quanto del mucchio di oggi comprerà ancora la spesa tra dieci o vent'anni, domanda diversa da quanto grande sarà il mucchio se rende anche un rendimento. Poiché l'implementazione è parse pura di tier A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello e senza rete in uscita.