Calculateur d'annuité croissante

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

Ce qu'est une annuité croissante et comment se forment valeur actuelle et future

Actualiser chaque flux à r et sommer produit la forme fermée present_value égale à PMT fois un moins le rapport de un plus g sur un plus r élevé à n, le tout divisé par r moins g, lorsque les deux taux diffèrent. Ce calculateur accepte les deux taux en points de pourcentage, de sorte qu'un trois saisi signifie trois pour cent, et renvoie present_value et future_value après arrondi half-up à huit décimales.

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

Si periods est zéro, négatif ou 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 positif. Cette garde est le contrat exigé de cette page : un exercice d'annuité croissante et un calendrier de périodes entières au style NPER d'Excel traitent n comme un décompte de dates de versement, non comme un temps réel. Associez le résultat à votre propre calendrier d'apports si vous avez besoin d'un échéancier d'avance en début de période ; commencez ici lorsque la question produit est une annuité croissante ordinaire transparente pour une page, une feuille de travail ou un lot de scénarios qui partagent déjà une trajectoire de croissance et un horizon entier. Envoyez par POST un corps JSON avec quatre nombres finis obligatoires : payment (le premier flux de fin de période ; alias pmt, p, amount, first_payment), growth_rate (la croissance constante des versements suivants en pour cent, par exemple trois pour trois pour cent ; alias g, growth, growth_percent), discount_rate (le taux d'intérêt par période en pour cent ; alias r, rate, interest_rate, i) et periods (le nombre n de versements, un entier positif ; 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 l'un des taux est inférieur ou égal à moins cent pour cent, un plus le taux décimal 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 payment, growth_rate, discount_rate et periods ; signale growth_rate_decimal et discount_rate_decimal arrondis half-up à huit décimales ; active rates_equal lorsque les deux saisies en pour cent coïncident ; renvoie present_value et future_value arrondis de la même façon ; et inclut une courte chaîne de formule qui reformule la forme fermée utilisée.

Où un calculateur d'annuité croissante justifie sa place

Les enseignants qui expliquent la valeur temps de l'argent peuvent semer des exemples de classe montrant cent croissant à trois pour cent et actualisé à huit pour cent pendant cinq périodes face au cas particulier de taux égaux, et démontrer l'échec franc lorsqu'on saisit un décompte de périodes nul, négatif ou fractionnaire. Les modèles de dividendes et de redevances qui supposent une croissance constante sur un contrat fini, non à jamais, 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 rémunération et baux qui rapprochent un salaire ou un loyer qui indexe selon un calendrier fixe peuvent poster les quatre mêmes nombres déjà stockés par le produit et citer un present_value stable avec un contrat à huit décimales, puis lire future_value comme la valeur accumulée de ce flux à la date du dernier versement. 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 les deux taux au-dessus de moins cent pour cent, periods comme entier positif, figez le present_value et le future_value arrondis dans les tests, et vous obtenez des résultats d'annuité croissante reproductibles pour widgets, embeds CMS et workers en bordure sans dresser un service de tableur à vous.