Calcul d'annuité

Elle applique la formule classique de l'annuité et renvoie le montant du versement, ni plus ni moins. Servez-vous-en pour chiffrer une mensualité de prêt, calibrer le retrait d'un capital de retraite ou vérifier le devis de location qu'un concessionnaire vient de vous remettre — un appel déterministe, sans tableur ni inscription.

Ce qu'est réellement un versement d'annuité

Une annuité est une suite de versements égaux effectués à intervalles réguliers — mensualités d'un prêt, retraits trimestriels d'une pension, redevances annuelles d'un bail. Le versement est le montant qui rend l'ensemble de cette suite équivalent, au taux donné, au capital d'aujourd'hui. Empruntez 10 000 à 1 % par mois sur 12 mois : il existe exactement une mensualité qui ramène le solde à zéro avec le dernier versement, et c'est ce montant que ce point d'accès renvoie.

La formule sous-jacente, versement = capital × r ÷ (1 − (1 + r)^(−n)), est celle qu'utilisent toutes les banques, tous les bailleurs et tous les fonds de pension ; elle s'obtient en actualisant chaque versement futur à aujourd'hui et en résolvant pour le montant constant. Le taux étant exprimé par période, le calcul convient à toute cadence : un taux mensuel avec des périodes mensuelles, un taux annuel avec des périodes annuelles, ou tout autre couple cohérent.

L'essentiel est la cohérence — le taux et le nombre de périodes doivent décrire le même intervalle. Envoyez un taux mensuel avec un nombre de périodes exprimé en années et le résultat sera faux par construction ; aucune calculatrice ne sauvera des unités incompatibles. Gardez les deux alignés et le résultat est exact, déterministe et reproductible sur n'importe quelle machine, c'est pourquoi le même calcul s'exécute à l'identique dans votre navigateur et sur notre infrastructure de périphérie.

Entrées, unités et cas limites

Le point d'accès prend trois nombres. Le capital est la valeur actuelle de l'annuité : le montant du prêt, la réserve en cours d'amortissement, le prix financé — il doit être positif. Le champ des périodes est le nombre de versements, un entier positif jusqu'à 1200, ce qui couvre largement cent ans de mensualités.

Deux cas limites sont traités délibérément. Un taux nul est valide et revient à une simple division : sans intérêts, le versement est exactement le capital réparti sur les périodes, ce qui est la limite mathématique correcte de la formule lorsque le taux tend vers zéro ; le point d'accès le renvoie donc directement au lieu d'échouer sur une division par zéro.

Par ailleurs, le versement renvoyé est arrondi à deux décimales — les centimes — afin que la réponse soit stable à l'octet près d'une exécution à l'autre et d'une machine à l'autre. Cette stabilité n'est pas cosmétique : les tests de référence comparent la sortie littéralement, et vous pouvez faire de même lorsque vous mettez en cache ou rapprochez des résultats dans vos propres systèmes. Si vous avez besoin de plus de précision, conservez la précision complète de votre côté et traitez la valeur renvoyée comme le montant canonique réglé.

Comment bien l'utiliser et ce qu'il ne fait pas

Les usages typiques relèvent de trois schémas. Les prêteurs et les places de marché l'appellent pour chiffrer une mensualité avant de lancer un dossier complet, car le versement est le premier chiffre qu'un client demande. Les produits SaaS l'intègrent derrière leurs propres calculateurs de prix, de sorte que les calculs soient maintenus à un seul endroit au lieu d'être réimplémentés — souvent incorrectement — dans chaque interface.

Et les équipes financières s'en servent pour contre-vérifier les devis reçus : si la mensualité annoncée par un concessionnaire ne correspond pas à la formule, quelque chose d'autre, des frais ou une prime d'assurance, se cache dans le versement. Il convient d'être clair sur ce que le point d'accès exclut délibérément. Il ne renvoie que le versement ; il ne produit pas le tableau d'amortissement période par période avec la répartition entre intérêts et capital — c'est une autre capacité.

Il suppose une annuité ordinaire, c'est-à-dire des versements en fin de période ; les annuités à terme d'avance, versées en début de période, en diffèrent d'un facteur (1 + r). Et il ne modélise ni frais, ni taxes, ni versements finaux majorés, ni changements de taux. Lorsque votre cas correspond au modèle simple de l'annuité, c'est le bon outil ; sinon, calculez ici le versement comme base de référence et ajoutez le reste dans votre propre code.