ForHosting KIT · Strumenti per sviluppatori

Variazione percentuale tra due valori

Questo calcolatore misura quanto un nuovo valore si è spostato rispetto al riferimento iniziale.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Inserisca il valore precedente e quello nuovo per ottenere la differenza aritmetica, la variazione percentuale con segno e un’indicazione chiara di aumento, diminuzione o stabilità. Una percentuale positiva segnala un movimento sopra il riferimento, mentre una negativa indica un movimento sotto di esso. Il calcolo è deterministico, consente di configurare l’arrotondamento e funziona sia direttamente sia tramite API.

Inserisca correttamente riferimento e valore di confronto

Il valore precedente è la misura originale e il denominatore del calcolo; indichi poi il nuovo valore. L’ordine conta: passare da 80 a 100 equivale a un aumento del 25 per cento, mentre passare da 100 a 80 equivale a una diminuzione del 20 per cento. Entrambi i numeri possono essere positivi o negativi, ma il riferimento non può essere zero, perché la divisione per zero non definisce una variazione finita. Se lo zero ha significato nei Suoi dati, riporti la differenza assoluta o adotti una regola specifica del settore. L’opzione dei decimali accetta da zero a dodici posizioni e la risposta conserva gli input per agevolare le verifiche.

Interpreti percentuale con segno e direzione

Lo strumento sottrae il valore precedente da quello nuovo, divide la differenza per il precedente e moltiplica per 100. Con un riferimento positivo, un risultato positivo indica aumento, uno negativo diminuzione e zero stabilità. Viene restituita anche la differenza aritmetica. Presti attenzione ai riferimenti negativi: il segno matematico del denominatore può rendere ambigue parole come miglioramento o peggioramento. Per esempio, passare da -100 a -50 produce -50 per cento con questa formula, sebbene il nuovo numero sia maggiore. Nei contesti finanziari, termici, contabili o di errore, specifichi la convenzione adottata.

Usi responsabilmente la variazione percentuale

Questa misura confronta movimenti su scale diverse rapportandoli al punto iniziale. È adatta a traffico mensile, prezzi, scorte, esperimenti, consumi o voti quando esiste un riferimento significativo e diverso da zero. Mantenga coerenti periodo e unità. Non confonda variazione relativa e punti percentuali: passare dal 20% al 25% significa cinque punti, ma un aumento relativo del 25%. Nelle automazioni conservi insieme valori, differenza, percentuale e direzione; calcoli dai dati originali e adotti un’unica regola di arrotondamento. Browser e API condividono lo stesso algoritmo puro.

Casi d'uso

Monitorare le metriche aziendali

Confronti ricavi, ordini, traffico o scorte con il periodo precedente, mantenendo la direzione della variazione.

Spiegare un andamento sperimentale

Misuri il movimento dal riferimento conservando sia la differenza relativa sia quella assoluta.

Automatizzare report ricorrenti

Generi campi coerenti per dashboard, avvisi, esportazioni e riepiloghi pianificati.

Domande frequenti

Quale formula usa il calcolatore?

Usa ((nuovo valore - valore precedente) / valore precedente) × 100 e restituisce il risultato con segno.

Perché il valore precedente non può essere zero?

È il denominatore; la divisione per zero non è definita e non produce una variazione finita.

Che cosa significa un risultato negativo?

Con riferimento positivo, il nuovo valore è inferiore. I riferimenti negativi richiedono un’interpretazione attenta.

Equivale a una variazione in punti percentuali?

No. Passare dal 20% al 25% significa cinque punti percentuali, ma un aumento relativo del 25%.

Quanto costa un calcolo tramite API?

Ogni richiesta API costa $0.002. Lo stesso calcolo deterministico funziona anche nel browser.

Posso controllare l’arrotondamento?

Sì. Imposti da 0 a 12 decimali; il valore predefinito è sei.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/stat/percent-change

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo 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)

Esempio di richiesta

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

Esempio di risposta

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

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →