Calculateur de valeur future

Un décompte de périodes négatif ou non entier échoue avec invalid_input au lieu d'inventer une histoire à rebours ou intra-période.

Ce que signifie la valeur future et comment fonctionne l'identité du capital unique

Cas résolu : mille à cinq pour cent par période pendant dix périodes ont growth_factor 1.62889463 et future_value 1628.89462678 après arrondi half-up à huit décimales, donc les intérêts gagnés valent 628.89462678.

Contrat d'entrée, forme de la réponse et comportement d'erreur

Si periods est négatif le gestionnaire échoue avec un message indiquant que periods ne doit pas être négatif. Si periods n'est pas un entier — deux virgule cinq, un tronçon trimestriel, un 3.2 saisi — le gestionnaire échoue avec un message indiquant que periods doit être un entier. Ces deux gardes sont le contrat exigé de cette page : un exercice de valeur future et un calendrier de périodes entières au style NPER d'Excel traitent n comme un décompte d'étapes de capitalisation, non comme un temps réel. Associez le résultat à votre propre calendrier d'apports si vous avez besoin de dépôts en cours de route ; commencez ici lorsque la question produit est une valeur future transparente de capital unique pour une page, une feuille de travail ou un lot de scénarios qui partagent déjà un taux et un horizon entier. Envoyez par POST un corps JSON avec trois nombres finis obligatoires : present_value (le capital unique d'aujourd'hui ; alias pv, principal, amount), rate (le taux d'intérêt par période en pour cent, par exemple cinq pour cinq pour cent ; alias interest_rate, i, rate_percent, periodic_rate) et periods (le nombre de capitalisations n, un entier non négatif ; alias n, nper, number_of_periods). Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique. Champs absents, chaînes vides, booléens et valeurs non finies échouent avec invalid_input en nommant le champ et ne sont pas facturés. Si rate est inférieur ou égal à moins cent pour cent, un plus i n'est pas positif et la puissance n'est pas un facteur réel utile, donc ce cas est aussi invalid_input. En cas de succès le corps répète present_value, rate et periods ; signale rate_decimal et growth_factor arrondis half-up à huit décimales ; renvoie future_value et interest arrondis de la même façon ; et inclut une courte chaîne de formule qui reformule VF égale à VA fois (1 + rate/100) élevé à periods.

Où un calculateur de valeur future justifie sa place

Les enseignants qui expliquent la valeur temps de l'argent peuvent semer des exemples de classe montrant mille à cinq pour cent pendant dix périodes face à l'alternative d'intérêt simple PV fois un plus i fois n, et démontrer l'échec franc lorsqu'on saisit un nombre de périodes négatif ou un n fractionnaire. Les tableaux de scénarios qui comparent deux ou trois taux sur le même horizon entier restent honnêtes car le gestionnaire est parse pur : pas de flux de marché, pas de graine aléatoire, pas d'horloge. Une validation en échec ne consomme pas de solde. Les équipes produit et finance qui rapprochent une valeur actuelle stockée d'un taux coté peuvent poster les trois mêmes nombres déjà stockés par le produit et citer un future_value stable avec un contrat à huit décimales. Comme l'implémentation est parse de tier A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant. Gardez le taux au-dessus de moins cent pour cent, periods comme entier non négatif, figez le future_value arrondi dans les tests, et vous obtenez des résultats de valeur future reproductibles pour widgets, embeds CMS et workers en bordure sans dresser un service de tableur à vous.