ForHosting KIT · Outils pour développeurs

Variation scolaire en pourcentage

Ce calculateur compare une valeur scolaire initiale à une valeur ultérieure et exprime l’écart en quantité et en pourcentage signé.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Un résultat positif indique une hausse, un résultat négatif une baisse, et zéro une stabilité. Vous pouvez l’utiliser pour les effectifs, l’assiduité, les moyennes, la lecture ou toute mesure scolaire non négative disposant d’un point de départ valable. Une phrase explicative accompagne aussi le résultat afin d’en faciliter l’interprétation.

Placez les valeurs initiale et nouvelle dans le bon ordre

Une variation en pourcentage décrit toujours le passage d’un point de départ à un point ultérieur. Saisissez donc la mesure antérieure comme valeur initiale et la mesure suivante comme nouvelle valeur. Si la bibliothèque comptait 800 emprunts le mois dernier et 920 ce mois-ci, indiquez 800 puis 920. L’ordre inverse répondrait à une autre question, car le dénominateur changerait. Les deux nombres doivent concerner la même grandeur, la même unité, la même population et une durée comparable. Ne comparez pas une fréquentation hebdomadaire à une fréquentation mensuelle, ni une classe à tout l’établissement, sans harmoniser auparavant les mesures. Les quantités peuvent être nulles ou positives, mais la valeur initiale doit être strictement supérieure à zéro. Avec une base nulle, la division par zéro rend la variation ordinaire indéfinie. Présentez alors l’écart numérique ou choisissez une autre méthode plutôt qu’un pourcentage trompeur.

Comprenez la formule et le signe du résultat

Le calcul soustrait d’abord la valeur initiale de la nouvelle valeur. Il divise ensuite cet écart par la valeur initiale, puis multiplie par 100. La formule est donc (nouvelle valeur moins valeur initiale) divisé par valeur initiale, fois 100. Si le temps moyen de lecture passe de 40 à 50, l’écart vaut 10 ; 10 divisé par 40 donne 0.25, soit +25 pour cent. S’il passe de 50 à 40, l’écart vaut -10 et le résultat -20 pour cent. Ces nombres ne sont pas opposés, car leurs bases diffèrent. Le signe indique la direction : positif pour une hausse, négatif pour une baisse et zéro pour une stabilité. La réponse conserve ce signe dans percentage_change et ajoute l’étiquette increase, decrease ou no_change. Seuls l’écart et le pourcentage affichés sont arrondis, selon le nombre de décimales demandé, afin que les mêmes entrées donnent toujours les mêmes sorties.

Présentez clairement le résultat dans un devoir

Une interprétation complète nomme la grandeur, précise les périodes, indique la direction et donne l’ampleur. Vous pourriez écrire : « Le nombre d’élèves participant au tutorat est passé de 48 en septembre à 60 en octobre, soit une hausse de 25 pour cent. » Cette phrase est plus claire qu’un simple « 25 pour cent », qui ne précise ni l’objet ni le sens du changement. Conservez le signe dans les données ou les calculs suivants : il facilite le tri, les graphiques et l’agrégation des baisses. Dans une phrase, utilisez plutôt la valeur absolue avec les mots hausse ou baisse. Enfin, une variation relative ne correspond pas à un écart en points de pourcentage. Si le taux de présence passe de 80 pour cent à 90 pour cent, l’écart est de 10 points, tandis que la variation relative atteint 12.5 pour cent. Vérifiez la mesure demandée. Le calcul déterministe fonctionne dans le navigateur ; une requête API automatisée coûte $0.002.

Cas d’usage

Comparer les effectifs

Mesurez la hausse ou la baisse des inscriptions entre deux années avec l’ancien effectif comme base.

Suivre la participation

Comparez devoirs terminés, minutes de lecture ou présence aux clubs sur deux périodes équivalentes.

Expliquer une tendance

Obtenez le résultat signé et sa direction pour rédiger une phrase claire sur des données scolaires.

Questions fréquentes

Quelle formule est utilisée ?

Le calcul applique ((nouvelle valeur - valeur initiale) / valeur initiale) × 100 et conserve le signe.

Pourquoi la valeur initiale doit-elle dépasser zéro ?

Elle sert de dénominateur. Une base nulle imposerait une division par zéro, donc la variation ordinaire serait indéfinie.

Que signifie un pourcentage négatif ?

La nouvelle valeur est inférieure à l’ancienne ; le champ de direction classe le résultat comme une baisse.

Variation relative et points de pourcentage sont-ils identiques ?

Non. La variation est relative à la valeur initiale, tandis que les points mesurent l’écart direct entre deux pourcentages.

Puis-je choisir la précision ?

Oui. Réglez decimals sur un entier de 0 à 10 ; la valeur par défaut est deux décimales.

Quel est le prix ?

Le calcul dans le navigateur est gratuit et chaque requête API est facturée au tarif de base $0.002.

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/edu/percent-change-school

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

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

import os, requests

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

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

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

Exemple de réponse

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

Limites

max_abs_value 1000000000000000

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 →