ForHosting KIT · Mathématiques

Calculez le compte à rebours jusqu'à une date cible

Sachez combien de temps il reste avant une date : du 25 juillet 2026 à 10 h 15 UTC au 28 juillet 2026 à 12 h 45 UTC, il y a 3 jours, 2 heures et 30 minutes, soit 4470 minutes. Vous fixez l'instant de départ. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Actuel: 2026-07-25T10:15:00Z
Cible: 2026-07-28T12:45:00Z

Vous obtenez

Jours: 3
Heures: 2
Minutes: 30
Total de minutes: 4 470

Calculez un compte à rebours jusqu'à une date cible sans dépendre de l'horloge de l'ordinateur. Indiquez la date et l'heure actuelles ainsi que la cible future au format ISO-8601 afin d'obtenir une répartition stable en jours complets, heures restantes et minutes restantes. Des entrées explicites rendent la même requête reproductible dans les tests, les tâches planifiées, les outils web et les traitements serveur. Les décalages horaires sont normalisés avant la soustraction. Si la cible est déjà passée, la requête renvoie une erreur sauf si vous activez volontairement le mode écoulé, ce qui évite de confondre une échéance dépassée avec du temps restant.

Indiquez explicitement l'heure actuelle et l'heure cible

Chacune accepte une date YYYY-MM-DD ou une date et heure ISO-8601. Une date sans heure correspond à minuit UTC, ce qui convient aux jalons définis à la journée. Pour une échéance précise, ajoutez les heures et les minutes, de préférence avec un Z final ou un décalage numérique tel que +02:00.

La calculatrice convertit les deux entrées sur une même chronologie absolue avant de les soustraire. Deux chaînes décrivant le même instant donnent donc un compte nul, même si leurs heures locales affichées diffèrent. Le moteur vérifie la longueur des mois grégoriens et les années bissextiles, sans reporter une date impossible au mois suivant.

Il refuse aussi les heures mal formées, décalages invalides, champs absents et valeurs non textuelles. Les fractions de seconde sont acceptées, mais le résultat ne contient que des minutes entières ; les secondes restantes sont ignorées afin d'éviter un arrondi supérieur inattendu.

Interprétez le résultat et gérez sûrement les cibles dépassées

Le contrôle des échéances dépassées est plus strict. Ce comportement empêche de transformer silencieusement un intervalle négatif en compte apparemment positif. Si votre processus doit réellement afficher le temps écoulé depuis une échéance, envoyez elapsed avec true.

Ce choix explicite simplifie le libellé en aval : affichez « restant » pour une échéance active et « écoulé » ou « dépassé » pour une échéance terminée, sans déduire l'état des nombres. Une cible égale à current est valide et renvoie zéro pour toutes les composantes.

Exploitez des résultats déterministes dans vos automatisations

Cette capacité convient aux lancements, clôtures d'inscription, préparations d'événements, fenêtres de maintenance, rappels de paiement et à tout processus connaissant déjà l'instant considéré comme actuel. Cette propriété est utile lorsqu'une file retente une tâche ou qu'un rapport historique doit être recréé. Les décalages numériques sont appliqués directement ; l'interprétation de l'heure d'été revient au client, qui doit fournir le bon décalage pour chaque instant local plutôt qu'un nom de ville.

Le calcul mesure le temps ordinaire en journées fixes de vingt-quatre heures. Il ne compte pas les jours ouvrés, n'ignore pas les week-ends, ne charge pas les jours fériés, ne planifie aucune notification et ne se met pas à jour en continu. Pour actualiser un écran actif, fournissez une nouvelle valeur current.

Traitez séparément les erreurs de validation afin de demander une correction pour une date incorrecte ou une cible passée non autorisée.

Cas d’usage

Compte à rebours de lancement

Transformez un instant actuel connu et l'échéance d'un produit en chiffres normalisés pour une page de lancement.

Suivi des échéances

Vérifiez le temps restant avant la clôture d'une inscription ou d'un paiement et signalez toute cible dépassée inattendue.

Rapport sur un jalon écoulé

Activez le mode écoulé pour indiquer les jours, heures et minutes entiers depuis un événement connu.

Questions fréquentes

La calculatrice utilise-t-elle l'heure système actuelle ?

Non. Vous devez fournir current explicitement afin que chaque calcul soit déterministe et reproductible.

Que se passe-t-il si la cible est passée ?

Dans ce mode, la réponse indique le temps depuis la cible et définit direction sur elapsed.

Les décalages de fuseau horaire sont-ils acceptés ?

Oui. Utilisez Z ou un décalage numérique comme +02:00. Les deux entrées sont normalisées sur la même chronologie absolue avant soustraction.

Comment les secondes sont-elles traitées ?

Vous pouvez les fournir, mais le résultat exprime des minutes entières. La dernière fraction de minute est ignorée, sans arrondi supérieur.

Le compte à rebours exclut-il les week-ends et les jours fériés ?

Non. Il mesure le temps écoulé en jours fixes de 24 heures, donc les week-ends et les jours fériés comptent comme n'importe quel autre jour. Pour des jours ouvrés, il faut un autre calcul.

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

POSThttps://api.kit.forhosting.com/math/countdown-to-date

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/math/countdown-to-date \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"current":"2026-07-25T10:15:00Z","target":"2026-07-28T12:45:00Z"}'

const res = await fetch("https://api.kit.forhosting.com/math/countdown-to-date", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "current": "2026-07-25T10:15:00Z",
    "target": "2026-07-28T12:45:00Z"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/math/countdown-to-date",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "current": "2026-07-25T10:15:00Z",
    "target": "2026-07-28T12:45:00Z"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/math/countdown-to-date", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"current":"2026-07-25T10:15:00Z","target":"2026-07-28T12:45:00Z"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"current":"2026-07-25T10:15:00Z","target":"2026-07-28T12:45:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/math/countdown-to-date", 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

{
  "current": "2026-07-25T10:15:00Z",
  "target": "2026-07-28T12:45:00Z"
}

Exemple de réponse

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

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

Indiquez explicitement l'heure actuelle et l'heure cible

Commencez par deux chaînes obligatoires : current et target. Fournir current au lieu de demander au service de consulter son horloge est un choix intentionnel : les exemples enregistrés, tests automatisés, traitements de facturation et appels API répétés deviennent déterministes.

Interprétez le résultat et gérez sûrement les cibles dépassées

Un compte futur valide renvoie days, hours, minutes, total_minutes, direction et is_past. Les trois champs d'affichage forment une durée normalisée : hours reste toujours compris entre zéro et vingt-trois, et minutes entre zéro et cinquante-neuf. total_minutes contient le nombre absolu de minutes entières ; il facilite le tri des enregistrements, la comparaison à des seuils et le changement d'une interface. Pour une cible future ou exactement identique, direction vaut remaining et is_past vaut false. Si target désigne un instant antérieur à current, la requête ordinaire échoue et précise qu'elapsed doit être activé. Les composantes restent positives, direction devient elapsed et is_past devient true.

Exploitez des résultats déterministes dans vos automatisations

Un client peut associer directement days, hours et minutes à des cartes de compte à rebours, tout en conservant total_minutes pour les alertes et le tri. Comme l'implémentation ne consulte jamais Date, l'horloge système, une base de fuseaux, le réseau ni une valeur aléatoire, un JSON identique produit toujours la même sortie. La version web exécute localement la même opération pure, tandis que l'automatisation API coûte $0.002 par élément.

Questions techniques

Quel est le prix d'un calcul par API ?

Chaque élément API réussi coûte $0.002. La calculatrice web peut exécuter localement la même logique déterministe.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Indiquez explicitement l'heure actuelle et l'heure cible

Interprétez le résultat et gérez sûrement les cibles dépassées

Exploitez des résultats déterministes dans vos automatisations

Cas d’usage

Compte à rebours de lancement

Suivi des échéances

Rapport sur un jalon écoulé

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Indiquez explicitement l'heure actuelle et l'heure cible

Interprétez le résultat et gérez sûrement les cibles dépassées

Exploitez des résultats déterministes dans vos automatisations

Questions techniques

merci