ForHosting KIT · Outils pour développeurs

Variation en pourcentage entre deux valeurs

Ce calculateur mesure l’évolution d’une nouvelle valeur par rapport à sa référence initiale.

● BetaGratuit · dans votre navigateur

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez l’ancienne et la nouvelle valeur pour obtenir l’écart arithmétique, la variation en pourcentage signée et une indication claire de hausse, de baisse ou de stabilité. Un pourcentage positif signale un mouvement au-dessus de la référence, tandis qu’un résultat négatif indique un mouvement en dessous. Le calcul est déterministe, son arrondi est configurable et il s’utilise directement ou via l’API.

Saisissez correctement la référence et la valeur comparée

L’ancienne valeur constitue la mesure initiale et le dénominateur du calcul ; indiquez ensuite la nouvelle valeur. L’ordre est essentiel : passer de 80 à 100 correspond à une hausse de 25 pour cent, tandis que passer de 100 à 80 correspond à une baisse de 20 pour cent. Les deux nombres peuvent être positifs ou négatifs, mais la référence ne peut pas être nulle, car une division par zéro ne définit aucune variation finie. Si zéro a un sens dans vos données, publiez l’écart absolu ou choisissez une règle adaptée au domaine. Le réglage des décimales accepte de zéro à douze positions et la réponse conserve les entrées pour faciliter l’audit.

Interprétez le signe et le sens de la variation

L’outil soustrait l’ancienne valeur de la nouvelle, divise cet écart par l’ancienne, puis multiplie par 100. Avec une référence positive, un résultat positif indique une hausse, un résultat négatif une baisse et zéro une stabilité. L’écart arithmétique est également fourni. Soyez prudent avec une référence négative : le signe mathématique du dénominateur peut rendre les notions d’amélioration ou de dégradation ambiguës. Ainsi, passer de -100 à -50 donne -50 pour cent selon la formule, même si le nouveau nombre est supérieur. Dans un contexte financier, thermique, comptable ou d’erreur, précisez la convention employée.

Employez la variation en pourcentage à bon escient

Cette mesure compare des évolutions sur des échelles différentes en les rapportant à leur point de départ. Elle convient au trafic mensuel, aux prix, aux stocks, aux expériences, à la consommation ou aux notes lorsqu’une référence non nulle est pertinente. Conservez les mêmes périodes et unités. Ne confondez pas variation relative et points de pourcentage : passer de 20% à 25% représente cinq points, mais une hausse relative de 25%. Dans vos automatisations, gardez ensemble les valeurs, l’écart, le pourcentage et le sens ; repartez des données brutes et appliquez une règle d’arrondi unique. Le navigateur et l’API partagent le même algorithme pur.

Cas d’usage

Suivre les indicateurs d’entreprise

Comparez chiffre d’affaires, commandes, trafic ou stocks à la période précédente en conservant le sens de l’évolution.

Expliquer une évolution expérimentale

Mesurez le mouvement depuis la référence tout en conservant l’écart relatif et absolu.

Automatiser les rapports récurrents

Produisez des champs cohérents pour tableaux de bord, alertes, exports et synthèses planifiées.

Questions fréquentes

Quelle formule le calculateur applique-t-il ?

Il applique ((nouvelle valeur - ancienne valeur) / ancienne valeur) × 100 et renvoie le résultat signé.

Pourquoi l’ancienne valeur ne peut-elle pas être nulle ?

Elle sert de dénominateur ; la division par zéro est indéfinie et ne donne aucune variation finie.

Que signifie un résultat négatif ?

Avec une référence positive, la nouvelle valeur est inférieure. Une référence négative demande davantage de prudence.

S’agit-il d’une variation en points de pourcentage ?

Non. Passer de 20% à 25% représente cinq points, mais une hausse relative de 25%.

Quel est le prix d’un calcul par API ?

Chaque requête API coûte $0.002. Le même calcul déterministe s’exécute aussi dans le navigateur.

Puis-je régler l’arrondi ?

Oui. Choisissez de 0 à 12 décimales ; la valeur par défaut est six.

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/stat/percent-change

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/stat/percent-change \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"old_value":80,"new_value":100}'

const res = await fetch("https://api.kit.forhosting.com/stat/percent-change", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "old_value": 80,
    "new_value": 100
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/stat/percent-change",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "old_value": 80,
    "new_value": 100
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/stat/percent-change", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"old_value":80,"new_value":100}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"old_value":80,"new_value":100}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/stat/percent-change", 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

{
  "old_value": 80,
  "new_value": 100
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "stat.percent_change",
  "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.

Consulter la documentation complète du KIT →