ForHosting KIT · Finances et argent

Valeur temporelle de l'argent

1000 placés à 5 % par an avec capitalisation mensuelle pendant 10 ans deviennent 1647,01 après 120 périodes. Passez en valeur actuelle pour savoir ce que vaut aujourd'hui une somme future au même taux. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Mode de calcul: Future
Capital initial: 1 000
Taux d’intérêt: 5
Fréquence: 12
Années: 10

Vous obtenez

Valeur: 1 647,01
Périodes: 120

La valeur temporelle de l'argent est l'idée qu'un dollar en main aujourd'hui n'équivaut pas à un dollar promis plus tard, car l'argent investi peut rapporter et celui qui arrive ensuite doit être actualisé. Élèves, planificateurs et équipes produit retrouvent sans cesse les deux mêmes formes fermées : la valeur future égale le capital connu multiplié par un plus le taux annuel divisé par la fréquence de capitalisation, élevé au produit de la fréquence et des années ; la valeur actuelle est ce même capital divisé par le même facteur de croissance. Ce calculateur de la valeur temporelle de l'argent accepte un capital unique, un pourcentage annuel nominal, des périodes de capitalisation par an, un horizon en années et un mode qui choisit actuel ou futur, puis renvoie la valeur calculée. Il n'amortit pas un prêt, n'actualise pas une série de flux, n'inverse pas un taux et n'échelonne pas de versements extra.

Ce que la valeur temporelle de l'argent signifie et comment les deux formes fermées fonctionnent

La valeur temporelle de l'argent est l'identité de manuel selon laquelle une somme d'espèces aujourd'hui et une somme plus tard ne sont comparables qu'après croissance ou actualisation à un taux déclaré avec une fréquence d'inscription déclarée. La valeur future capitalise un principal présent vers l'avant : FV égale PV fois un plus r sur n, élevé à n fois t. La valeur actuelle fait l'inverse : PV égale FV divisé par ce même facteur, si bien qu'un montant futur promis se réécrit dans les unités d'aujourd'hui.

P est la somme que vous connaissez déjà : le capital d'aujourd'hui lorsque vous demandez une valeur future, ou le montant futur lorsque vous demandez une valeur actuelle. r est le taux annuel nominal en décimal, si bien qu'une cotation de cinq pour cent donne r égal à 0.05. n est la fréquence de capitalisation, combien de fois par an les intérêts sont inscrits, et t est l'horizon en années.

Les valeurs courantes de n sont un annuel, deux semestriel, quatre trimestriel, douze mensuel, cinquante-deux hebdomadaire et trois cent soixante-cinq quotidien. Une capitalisation plus fréquente, le taux nominal étant fixé, produit une valeur future un peu plus élevée parce que les intérêts commencent à rapporter plus tôt, et une valeur actuelle un peu plus faible parce que le facteur d'actualisation est plus grand.

Cette capacité n'ajoute pas de versements réguliers, ne retranche pas de frais et ne bascule pas vers une capitalisation continue avec e élevé à r t ; ce sont d'autres identités et d'autres intentions de recherche. Un horizon de zéro année renvoie le capital d'origine parce que tout facteur fini élevé à zéro vaut un. Un taux zéro laisse le capital inchangé.

Les taux négatifs sont admis tant qu'ils restent finis, ce qui modélise une baisse contractuelle plutôt qu'une faute de frappe, mais si un plus r sur n n'est pas une base utilisable et que la puissance n'est pas un réel fini, la tâche échoue au lieu de renvoyer NaN.

Quand comparer des sommes dans le temps

Les ménages et les élèves utilisent un calculateur de la valeur temporelle de l'argent lorsqu'un objectif d'épargne, un versement in fine promis ou un exercice demande ce que vaut une somme aujourd'hui ou plus tard à un taux annuel déclaré avec une fréquence d'inscription déclarée. Les conseillers en finances personnelles ont besoin d'un oracle déterministe qui refuse une fréquence de capitalisation qui n'est pas un entier positif, au lieu d'afficher NaN en silence, chiffre qu'un formulaire défectueux pourrait traiter comme un succès.

Cette page n'est pas un outil d'intérêts composés qui renvoie solde final plus intérêts gagnés, ni un calculateur VAN qui actualise une série de flux, ni un modèle DCF, ni une identité de valeur future d'annuité : ces requêtes sont d'autres intentions et elles ont déjà leurs pages. Gardez les requêtes petites, figez la value arrondie dans les tests, et vous obtenez des chiffres actuels et futurs reproductibles pour feuilles, greffons LMS et workers de bord sans dresser un service de tableur à vous.

Lorsque vous aurez besoin plus tard de versements réguliers, passez à une identité d'annuité plutôt que d'étirer ce contrat d'un seul capital.

Cas d’usage

Objectifs d'épargne et versements in fine

Faites croître une somme présente vers une cible future, ou actualisez un versement in fine futur vers les unités d'aujourd'hui, à partir du capital, du pourcentage annuel, de la fréquence de capitalisation et des années.

Oracles de classe et de devoirs

Générez des clés reproductibles de FV = PV(1+r/n)^(nt) et PV = FV/(1+r/n)^(nt) qui refusent une fréquence de capitalisation non entière au lieu d'inventer un chiffre.

Questions fréquentes

Comment calcule-t-on la valeur temporelle de l'argent ?

La valeur future est FV = PV × (1 + r/n)^(n×t). La valeur actuelle est PV = FV / (1 + r/n)^(n×t). P est la somme connue, r le taux annuel en décimal (pourcentage divisé par 100), n le nombre de périodes de capitalisation par an et t les années.

Quelle est la différence entre valeur actuelle et valeur future ?

La valeur future fait croître une somme que vous avez aujourd'hui jusqu'à une date ultérieure. La valeur actuelle actualise une somme que vous recevrez plus tard jusqu'à aujourd'hui. Réglez mode sur future ou present ; principal est PV dans le premier cas et FV dans le second.

Que se passe-t-il si la fréquence de capitalisation n'est pas un entier positif ?

Le zéro, les fractions et les valeurs non numériques sont refusés et ne sont pas facturés.

Le taux d'intérêt est-il un pourcentage ou un décimal ?

Un pourcentage. Envoyez 5 pour cinq pour cent par an. Envoyer 0.05 serait traité comme cinq centièmes de pour cent, non comme cinq pour cent.

Cela traite-t-il les annuités, les versements extra ou une série de flux de trésorerie ?

Non. Il déplace une seule somme entre le présent et le futur avec une capitalisation discrète. Les versements réguliers, la VAN d'une série et la capitalisation continue sont d'autres identités.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/fin/time-value-of-money

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/fin/time-value-of-money \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"future","principal":1000,"rate":5,"frequency":12,"years":10}'

const res = await fetch("https://api.kit.forhosting.com/fin/time-value-of-money", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "mode": "future",
    "principal": 1000,
    "rate": 5,
    "frequency": 12,
    "years": 10
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/time-value-of-money",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "mode": "future",
    "principal": 1000,
    "rate": 5,
    "frequency": 12,
    "years": 10
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/time-value-of-money", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"mode":"future","principal":1000,"rate":5,"frequency":12,"years":10}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"mode":"future","principal":1000,"rate":5,"frequency":12,"years":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/time-value-of-money", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "mode": "future",
  "principal": 1000,
  "rate": 5,
  "frequency": 12,
  "years": 10
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.time_value_of_money",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

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

Exemple : principal mille, cinq pour cent, douze capitalisations par an, dix années et mode future donnent cent vingt periods et un value de 1647.01. Le même capital actualisé comme somme future à six pour cent trimestriel pendant cinq années avec mode present donne une valeur actuelle plus petite. Une validation échouée ne consomme pas de solde. Envoyez par POST un corps JSON avec cinq champs obligatoires. mode est l'enum future ou present et choisit quelle identité évaluer ; les alias solve_for et direction sont acceptés. principal est la somme connue dans une seule monnaie ; lorsque mode vaut future c'est PV, et lorsque mode vaut present c'est FV. Les alias amount, p et lump désignent le même champ, et la valeur doit se situer entre zéro et un billion inclus. rate est le pourcentage annuel nominal —cinq signifie cinq pour cent par an—, non un décimal 0.05 sauf si vous visez vraiment cinq centièmes de pour cent ; les alias interest_rate, annual_rate et annual_percent désignent le même champ. frequency est n, périodes de capitalisation par an, et doit être un entier positif de un à trois cent soixante-cinq. C'est l'erreur contractuelle : si frequency manque, n'est pas entier, vaut zéro, est négatif ou dépasse trois cent soixante-cinq, la tâche échoue avec invalid_input en nommant frequency et n'est pas facturée. Les alias n, compounds_per_year et compounding_frequency sont acceptés. years est t, un nombre fini de zéro à cent vingt ; les années fractionnaires telles que deux point cinq sont admises, ainsi que les alias t, time, period et time_period. Chaque champ numérique peut arriver comme nombre JSON ou comme chaîne numérique. En cas de succès, le corps renvoie en écho mode, principal, rate, frequency et years, indique periods comme n fois t, et renvoie value arrondi half-up à deux décimales plus une chaîne formula qui reformule FV égal à PV fois un plus r sur n élevé à n t, ou l'identité inverse de valeur actuelle. Les appels API réussis utilisent le prix de base publié $0.002.

Où une API de la valeur temporelle de l'argent gagne sa place

Les équipes produit câblent le même contrat dans des démonstrations d'accueil afin que quiconque choisit actuel ou futur, saisit un capital, un pourcentage, une capitalisation mensuelle et un horizon voie le même value que l'API renverra ensuite dans les tests de production. Parce que l'implémentation est parse pur de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle et sans réseau sortant.

Cas d'intégration

Démonstrations produit et fixtures de CI

Alimentez des applications de planification et des tests automatiques avec un value déterministe qui coïncide octet par octet avec le widget gratuit du navigateur sur les cinq mêmes entrées.

Consulter la documentation complète du KIT →

Lancer gratuitement