Pourcentage de temps écoulé dans un intervalle ISO
Indiquez un début, une fin et l'instant à évaluer, et voyez quelle part de l'intervalle est écoulée : 14:00 dans une plage de 08:00 à 20:00 UTC, c'est 50 %. Rien ne dépend de l'horloge actuelle. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Début
- 2026-07-25T08:00:00Z
- End
- 2026-07-25T20:00:00Z
- Référence
- 2026-07-25T14:00:00Z
- Progression (%)
- 50
- Écoulé (ms)
- 21 600 000
- Durée (ms)
- 43 200 000
- Relation avec la référence
- within
Ce calculateur de pourcentage de temps écoulé mesure l’avancement dans un intervalle explicite sans consulter l’horloge actuelle. Indiquez la date et l’heure de début, celles de fin et l’instant de référence à évaluer. Chaque valeur doit inclure Z ou un décalage UTC numérique ; des instants équivalents donnent ainsi la même réponse sur tout ordinateur ou navigateur. Le résultat comprend le pourcentage arrondi et borné, les millisecondes écoulées signées, la durée totale, l’état du bornage et la position de la référence par rapport à l’intervalle.
Définissez un intervalle complet et un instant de référence
L’avancement n’a de sens que si ses limites et son point d’observation sont sans ambiguïté. Après normalisation des décalages, end doit représenter un instant postérieur à start. La référence peut se situer dans l’intervalle, avant celui-ci ou après.
Le calculateur convient donc aux contrôles historiques, jalons planifiés, comptes à rebours, fenêtres de service et tests reproductibles, puisqu’il ne remplace jamais la référence par l’horloge de l’appareil. Une valeur comme 2026-07-25T14:00:00Z est explicite, tandis qu’une heure locale sans décalage est refusée. Des écritures dotées de décalages différents peuvent désigner le même instant : 2026-07-25T16:00:00+02:00 et 2026-07-25T14:00:00Z sont ici égales.
Les champs calendaires sont vérifiés avant conversion, notamment la longueur des mois et les règles grégoriennes des années bissextiles, afin qu’une date impossible ne bascule pas discrètement vers un autre jour.
Comprenez le calcul UTC et le bornage
Le calcul convertit d’abord chaque date-heure sur une même échelle de millisecondes UTC. Le pourcentage brut correspond au temps écoulé divisé par la durée, puis multiplié par cent. Par défaut, le résultat est borné entre zéro et cent : une référence antérieure au début renvoie zéro, et une référence postérieure à la fin renvoie cent.
Vous pouvez choisir d’autres pourcentages minimal et maximal si vous avez besoin d’une autre échelle bornée, à condition que le maximum ne soit pas inférieur au minimum. Un instant exactement placé sur l’une des limites appartient à l’intervalle et produit naturellement le pourcentage de l’extrémité correspondante.
Cas d’usage
Mesurer une fenêtre de mise en production
Calculez un pourcentage stable pour un déploiement ou une maintenance à un point de contrôle enregistré explicitement.
Reproduire une valeur de tableau de bord
Conservez l’instant de référence avec l’intervalle et régénérez exactement le pourcentage déjà affiché.
Tester le comportement aux limites
Vérifiez les états avant, pendant et après l’intervalle avec des bornes configurables et un résultat déterministe.
Questions fréquentes
Le calcul utilise-t-il l’heure actuelle ?
Non. Vous devez fournir reference explicitement et le calcul ne consulte jamais d’horloge.
Les décalages de fuseau horaire sont-ils acceptés ?
Oui. Utilisez Z ou un décalage numérique tel que +02:00 ou -05:30 ; toutes les entrées sont normalisées en UTC.
Le début et la fin peuvent-ils être identiques ?
Non. end doit être postérieur à start, car un intervalle de durée nulle n’a pas de pourcentage écoulé défini.
Que se passe-t-il si l'instant précède le début ou suit la fin ?
Par défaut, le pourcentage reste à 0 avant le début et à 100 après la fin. Le temps écoulé garde son signe : vous voyez donc toujours de combien l'instant sort de l'intervalle.
Avec combien de décimales le pourcentage est-il donné ?
Six par défaut. Vous pouvez choisir de zéro à douze décimales, et l'arrondi n'intervient qu'après que le pourcentage a été maintenu dans ses limites.
Outils associés
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
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/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)Exemple de requête
{
"start": "2026-07-25T08:00:00Z",
"end": "2026-07-25T20:00:00Z",
"reference": "2026-07-25T14:00:00Z"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.time_progress_percent",
"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
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. |
Notes techniques
Définissez un intervalle complet et un instant de référence
Fournissez start, end et reference sous forme de dates-heures ISO 8601 complètes, avec les secondes et soit Z, soit un décalage UTC numérique explicite.
Comprenez le calcul UTC et le bornage
Il soustrait start de end pour obtenir la durée complète, puis start de reference pour obtenir le temps écoulé signé. Le bornage ne modifie que progress_percent ; elapsed_ms conserve son signe et indique l’écart réel avant ou après l’intervalle. clamped précise si la borne a changé la valeur brute, tandis que reference_relation renvoie before, within ou after.
Choisissez la précision et obtenez un résultat déterministe
L’implémentation n’accède pas au réseau, n’utilise aucun aléa, n’appelle pas Date et ne consulte pas le fuseau horaire du système. Conservez la référence exacte avec le résultat si vous devez le reproduire. Pour un suivi en direct, générez explicitement la référence dans votre application et envoyez-la : cette capacité reste volontairement un calcul pur, sans lecture cachée de l’horloge. Le champ precision permet de choisir de zéro à douze décimales pour progress_percent ; sa valeur par défaut est six. L’arrondi intervient seulement après le bornage du pourcentage brut, ce qui préserve l’autorité des extrémités configurées. duration_ms et elapsed_ms restent des différences entières en millisecondes : vous pouvez donc contrôler le pourcentage ou présenter séparément une durée. Sa conversion grégorienne est arithmétique ; une même requête valide produit donc le même JSON dans un Worker serveur et dans le navigateur.
Questions techniques
Quel est le prix via l’API ?
Chaque requête coûte $0.002. Le même calcul pur peut également être exécuté dans le navigateur.
Que se passe-t-il si la référence est hors de l’intervalle ?
Le pourcentage est borné selon la plage configurée, tandis que elapsed_ms signé et reference_relation conservent sa position réelle.