Calcolatore di percentuale di assenze
Trasformi i giorni persi in un tasso confrontabile: 6 giorni di assenza su 22 giorni lavorativi previsti danno un tasso di assenza del 27,27%, che il team conti cinque persone o 200. Anche le mezze giornate valgono. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Giorni di assenza
- 6
- Totale giorni lavorativi
- 22
- Percentuale di assenza
- 27,27
Divide il primo per il secondo e restituisce il risultato come percentuale, arrotondata alla precisione scelta. Se i giorni di assenza superano i giorni lavorativi previsti — un dato impossibile — rifiuta la richiesta con un chiaro errore di validazione invece di restituire una cifra priva di senso superiore al cento per cento.
Cosa indica il tasso di assenza
Il tasso di assenza è la misura più semplice e confrontabile del tempo lavorativo perso. Un semplice conteggio delle assenze dice poco da solo: sei giorni mancati sono gravi in un mese di venti giorni e modesti in un trimestre. Esprimerlo come percentuale dei giorni lavorativi previsti normalizza il dato, così un team di cinque persone e un reparto di duecento possono essere confrontati sulla stessa scala, e un mese può essere messo a confronto con il successivo anche quando le durate dei calendari differiscono.
Invia i giorni di assenza e i giorni lavorativi previsti per lo stesso periodo e riceve la percentuale di assenza, arrotondata al numero di decimali richiesto.
Rifiuta deliberatamente l'unico dato che rende la metrica priva di significato: se i giorni di assenza superano il totale dei giorni lavorativi previsti, qualcosa nei dati di origine non va — un doppio conteggio, un periodo non corrispondente, un errore di battitura — e la risposta corretta è un errore che indica i due valori incriminati, non una percentuale superiore al cento che contamina silenziosamente un report a valle.
Come vengono convalidati gli input
Entrambi gli input devono essere numeri finiti, e la definizione del periodo spetta a Lei: un mese, un trimestre, un anno contrattuale — il rapporto è lo stesso purché entrambi i numeri descrivano la stessa finestra temporale. I giorni di assenza devono essere zero o positivi; i giorni lavorativi previsti devono essere maggiori di zero, perché un periodo senza giorni previsti non ha un tasso di assenza significativo. I valori frazionari sono accettati su entrambi i lati, poiché molti sistemi paghe registrano mezze giornate.
Il parametro di precisione controlla l'arrotondamento della percentuale restituita e ha come valore predefinito due decimali, in linea con il modo in cui la maggior parte delle dashboard delle risorse umane mostra il dato; può richiedere qualsiasi valore da zero a sei. La validazione è volutamente rigorosa.
Un conteggio di assenze negativo, un denominatore pari a zero o giorni di assenza superiori al previsto restituiscono tutti un errore che indica il campo esatto e i valori incriminati, così una pipeline chiamante può registrare il problema, saltare il record e avvisare chi gestisce i dati di origine invece di importare un numero errato.
Gli input che arrivano come stringhe numeriche vengono convertiti, perché gli invii di moduli e i parametri di query spesso arrivano in quel formato, ma tutto ciò che non può essere interpretato come numero finito viene rifiutato con la stessa chiarezza.
Dove si colloca nella pratica
I team integrano questo calcolo in tre tipi di flussi. Il primo è il reporting: un processo notturno scorre l'esportazione delle presenze, calcola la percentuale di assenze per dipendente, per team e per sede, e archivia le serie storiche in modo che le tendenze siano visibili prima di diventare problemi.
Il secondo è l'alerting: una soglia — diciamo il cinque per cento in un mese — attiva una verifica, e calcolare il tasso in modo centralizzato significa che ogni avviso usa esattamente la stessa formula e lo stesso arrotondamento invece di lasciare che ogni foglio di calcolo segua la propria versione. Il terzo è il benchmarking: convertire i conteggi grezzi delle assenze in percentuali rende confrontabili periodi di durata diversa e team di dimensioni diverse, che è l'unico modo onesto di leggere i numeri.
L'oggetto risultato restituisce i due input insieme alla percentuale calcolata, così un record archiviato è autoesplicativo e un revisore può vedere con precisione quali numeri hanno prodotto quale tasso senza dover ricalcolare nulla dai log.
Casi d'uso
Creare un report mensile delle assenze
Calcoli la percentuale di assenze per dipendente e per team a partire dall'esportazione delle presenze, con un'unica formula e regola di arrotondamento condivise.
Avvisi su tassi di assenza anomali
Attivi una verifica quando la percentuale di assenze di un team supera una soglia, calcolata allo stesso modo ovunque.
Confrontare periodi di durata diversa
Normalizzi un mese corto e un mese lungo in percentuali affinché la linea di tendenza sia onesta.
Domande frequenti
Come viene calcolata la percentuale di assenze?
Giorni di assenza divisi per il totale dei giorni lavorativi previsti, moltiplicati per cento, arrotondati alla precisione scelta (due decimali per impostazione predefinita).
Posso usare le mezze giornate?
Sì. Entrambi gli input accettano numeri frazionari, quindi 4.5 giorni di assenza su 22 giorni lavorativi funzionano senza problemi.
Quanto costa?
È anche gratuito da eseguire nel browser di questa pagina.
Vengono archiviati dati?
No. I due numeri vengono elaborati e scartati; viene restituito solo il risultato.
I giorni lavorativi previsti possono essere zero?
No. Un periodo con zero giorni lavorativi previsti non ha un tasso di assenza definito, quindi l'input viene rifiutato.
Strumenti correlati
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
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/fin/absence-percentage \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"days_absent":6,"workdays_total":22}'const res = await fetch("https://api.kit.forhosting.com/fin/absence-percentage", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"days_absent": 6,
"workdays_total": 22
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/absence-percentage",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"days_absent": 6,
"workdays_total": 22
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/absence-percentage", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"days_absent":6,"workdays_total":22}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"days_absent":6,"workdays_total":22}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/absence-percentage", 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
{
"days_absent": 6,
"workdays_total": 22
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.absence_percentage",
"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
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. |
Note tecniche
L'API della percentuale di assenze calcola un tasso di assenza a partire da due numeri: i giorni in cui una persona è stata assente e il totale dei giorni lavorativi previsti nello stesso periodo.
Cosa indica il tasso di assenza
Questo endpoint esegue esattamente tale normalizzazione. Poiché il calcolo è pura aritmetica, lo stesso codice viene eseguito gratuitamente nel browser di questa pagina e come chiamata API a pagamento al costo di $0.002 per richiesta, così può verificare un dato a mano e pagare solo quando lo automatizza.
Dove si colloca nella pratica
L'endpoint non mantiene stato e non archivia nulla: entrano i due numeri, esce la percentuale e nulla viene conservato. Questo lo rende sicuro da usare su dati sensibili del personale.
Domande tecniche
Cosa succede se i giorni di assenza superano i giorni lavorativi previsti?
La richiesta viene rifiutata con un errore invalid_input che indica entrambi i valori, poiché tale dato non può descrivere un periodo reale.