Percentuale di tempo trascorso in un intervallo ISO
Indichi un inizio, una fine e il momento da valutare, e veda quanta parte dell'intervallo è trascorsa: le 14:00 in una fascia dalle 08:00 alle 20:00 UTC sono il 50%. Nulla dipende dall'orologio attuale. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Inizio
- 2026-07-25T08:00:00Z
- End
- 2026-07-25T20:00:00Z
- Riferimento
- 2026-07-25T14:00:00Z
- Avanzamento (%)
- 50
- Trascorso (ms)
- 21.600.000
- Durata (ms)
- 43.200.000
- Relazione con il riferimento
- within
Questo calcolatore della percentuale di tempo trascorso misura l’avanzamento in un intervallo esplicito senza consultare l’orologio attuale. Inserisca data e ora iniziali, data e ora finali e l’istante di riferimento da valutare. Ogni valore deve includere Z o uno scostamento UTC numerico; in questo modo, istanti equivalenti producono la stessa risposta su qualsiasi computer o browser. Il risultato comprende la percentuale arrotondata e limitata, i millisecondi trascorsi con segno, la durata totale, lo stato del limite e la posizione del riferimento rispetto all’intervallo.
Definisca un intervallo completo e un istante di riferimento
L’avanzamento ha significato soltanto quando i limiti e il punto di osservazione sono inequivocabili. Dopo la normalizzazione degli scostamenti, end deve rappresentare un istante successivo a start. Il riferimento può trovarsi nell’intervallo, prima o dopo di esso.
Il calcolatore è quindi adatto a verifiche storiche, traguardi pianificati, conti alla rovescia, finestre di servizio e test riproducibili, perché non sostituisce mai il riferimento con l’orologio del dispositivo. Un valore come 2026-07-25T14:00:00Z è esplicito, mentre un orario locale senza scostamento viene rifiutato. Formati con scostamenti diversi possono indicare lo stesso istante: 2026-07-25T16:00:00+02:00 e 2026-07-25T14:00:00Z qui coincidono.
I campi del calendario vengono convalidati prima della conversione, compresi la durata dei mesi e le regole gregoriane degli anni bisestili, affinché una data impossibile non venga spostata silenziosamente a un altro giorno.
Comprenda il calcolo UTC e l’applicazione dei limiti
Il calcolo converte anzitutto ogni data e ora nella stessa scala di millisecondi UTC. La percentuale grezza è il tempo trascorso diviso per la durata e moltiplicato per cento. Per impostazione predefinita, la percentuale restituita è limitata tra zero e cento: un riferimento precedente all’inizio restituisce zero, mentre uno successivo alla fine restituisce cento.
Lei può impostare percentuali minime e massime diverse quando serve un’altra scala limitata, purché il massimo non sia inferiore al minimo. Un istante collocato esattamente su uno dei limiti è considerato interno all’intervallo e genera naturalmente la percentuale dell’estremo corrispondente.
Casi d'uso
Misurare una finestra di rilascio
Calcoli una percentuale stabile per una distribuzione o manutenzione in un punto di controllo registrato esplicitamente.
Riprodurre un valore del pannello
Salvi l’istante di riferimento con l’intervallo e rigeneri esattamente la percentuale visualizzata in precedenza.
Verificare il comportamento ai limiti
Controlli gli stati precedenti, interni e successivi con limiti configurabili e un risultato atteso deterministico.
Domande frequenti
Viene usata l’ora corrente?
No. Lei deve fornire reference esplicitamente e il calcolo non consulta mai un orologio.
Sono supportati gli scostamenti di fuso orario?
Sì. Usi Z o uno scostamento numerico come +02:00 o -05:30; ogni input viene normalizzato in UTC.
Inizio e fine possono coincidere?
No. end deve essere successivo a start perché un intervallo di durata zero non ha una percentuale trascorsa definita.
Cosa succede se il momento è prima dell'inizio o dopo la fine?
Per impostazione predefinita la percentuale resta a 0 prima dell'inizio e a 100 dopo la fine. Il tempo trascorso mantiene il segno, così vede comunque di quanto il momento è fuori dall'intervallo.
Con quanti decimali esce la percentuale?
Con sei per impostazione predefinita. Può scegliere da zero a dodici decimali, e l'arrotondamento avviene solo dopo aver mantenuto la percentuale entro i suoi limiti.
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/date/time-progress-percent \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"start":"2026-07-25T08:00:00Z","end":"2026-07-25T20:00:00Z","reference":"2026-07-25T14:00:00Z"}'const res = await fetch("https://api.kit.forhosting.com/date/time-progress-percent", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"start": "2026-07-25T08:00:00Z",
"end": "2026-07-25T20:00:00Z",
"reference": "2026-07-25T14:00:00Z"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/time-progress-percent",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"start": "2026-07-25T08:00:00Z",
"end": "2026-07-25T20:00:00Z",
"reference": "2026-07-25T14:00:00Z"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/time-progress-percent", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"start":"2026-07-25T08:00:00Z","end":"2026-07-25T20:00:00Z","reference":"2026-07-25T14:00:00Z"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"start":"2026-07-25T08:00:00Z","end":"2026-07-25T20:00:00Z","reference":"2026-07-25T14:00:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/time-progress-percent", 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
{
"start": "2026-07-25T08:00:00Z",
"end": "2026-07-25T20:00:00Z",
"reference": "2026-07-25T14:00:00Z"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.time_progress_percent",
"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
Definisca un intervallo completo e un istante di riferimento
Fornisca start, end e reference come date e ore ISO 8601 complete, con i secondi e Z oppure uno scostamento UTC numerico esplicito.
Comprenda il calcolo UTC e l’applicazione dei limiti
Sottrae start da end per ottenere la durata completa e start da reference per ottenere il tempo trascorso con segno. Il limite modifica soltanto progress_percent; elapsed_ms conserva il segno e indica quanto il riferimento precede o supera l’intervallo. clamped segnala se il valore grezzo è stato modificato, mentre reference_relation restituisce before, within oppure after.
Scelga la precisione e ottenga risultati deterministici
L’implementazione non accede alla rete, non usa casualità, non richiama Date e non consulta il fuso orario del sistema. Conservi il riferimento esatto insieme al risultato se dovrà riprodurlo. Per mostrare un avanzamento in tempo reale, generi esplicitamente il riferimento nella Sua applicazione e invii quel valore: la capacità rimane volutamente un calcolo puro, senza letture nascoste dell’orologio. Con precision può scegliere da zero a dodici cifre decimali per progress_percent; il valore predefinito è sei. L’arrotondamento avviene soltanto dopo che la percentuale grezza è stata limitata, mantenendo autorevoli gli estremi configurati. duration_ms ed elapsed_ms restano differenze intere in millisecondi, così Lei può verificare la percentuale o presentare una durata separata. La conversione gregoriana è aritmetica; pertanto, la stessa richiesta valida produce lo stesso JSON in un Worker sul server e nel browser.
Domande tecniche
Quanto costa tramite API?
Ogni richiesta costa $0.002. Lo stesso calcolo puro può essere eseguito anche nel browser.
Cosa accade se il riferimento è fuori dall’intervallo?
La percentuale è vincolata all’intervallo configurato, mentre elapsed_ms con segno e reference_relation conservano la posizione reale.