ForHosting KIT · Dates et temps

Compte à rebours entre deux dates

De minuit UTC le 1er janvier 2026 à 01:01:01 le 2 janvier, il y a 1 jour, 1 heure, 1 minute et 1 seconde, soit 90061 secondes. Saisissez deux dates avec heure et décalage pour obtenir le compte complet. 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

Date-heure ISO-8601 de début: 2026-01-01T00:00:00Z
Date-heure ISO-8601 de fin: 2026-01-02T01:01:01Z

Vous obtenez

Secondes d'époque d'origine: 1 767 225 600
Secondes d'époque de cible: 1 767 315 661
Secondes totales: 90 061
Jours: 1

Les planificateurs d'événements, pages de lancement produit, comptes à rebours d'examens et tableaux de bord SLA ont tous besoin de la même réponse claire : combien de jours, heures, minutes et secondes restent entre deux instants connus. Ce calculateur de compte à rebours entre deux dates accepte une paire de dates-heures ISO-8601, valide chaque jour civil et chaque champ d'horloge selon les règles grégoriennes, convertit les deux côtés en secondes UTC absolues par arithmétique entière pure et renvoie un reste structuré que les interfaces peuvent afficher sans réimplémenter les années bissextiles ni les décalages horaires.

Choisir from et to ISO et quels formats sont acceptés

Envoyez deux champs chaîne nommés from et to. Chaque valeur doit être une date-heure civile ISO-8601 : année à quatre chiffres, mois et jour, éventuellement suivis d'une heure du jour avec heures, minutes et secondes. Vous pouvez ajouter une partie fractionnaire de seconde ; le moteur l'accepte pour compatibilité et tronque aux secondes entières pour les entiers du compte à rebours.

Un Z final signifie UTC ; un décalage numérique tel que plus zéro deux deux-points zéro zéro ou moins zéro cinq deux-points zéro zéro décale les champs locaux en UTC absolu avant la soustraction. Les valeurs date seule comme deux mille vingt-six tiret zéro six tiret quinze sont traitées comme minuit UTC pour que les bornes de jour simples fonctionnent sans inventer d'heure.

Les années sont limitées de un à neuf mille neuf cent quatre-vingt-dix-neuf, les mois de un à douze, et les jours doivent exister dans ce mois, y compris le 29 février en année bissextile le cas échéant. Les heures vont de zéro à vingt-trois et minutes et secondes de zéro à cinquante-neuf ; toute valeur hors de ces plages est une entrée invalide plutôt qu'un report silencieux.

Usages courants et limites pratiques

Appelez l'outil gratuit de compte à rebours entre deux dates dans le navigateur pour pages de lancement, minuteries de mariage, démos de classe et scripts de support sans installer de bibliothèques de dates ni de bases de fuseaux. Associez-le à des compteurs de jours ouvrés lorsque seuls les jours de semaine et fériés comptent, ou à des outils de longueur de mois pour valider d'abord les champs civils avant de construire un horodatage complet.

Gardez des attentes honnêtes : ce produit mesure le temps civil écoulé entre deux instants absolus après application de décalages explicites ; il ne planifie pas de notifications, ne charge pas de calendriers publics de fériés et n'invente pas l'instant présent de l'horloge murale pour vous. Les entrées suivent les mêmes règles de rétention que les autres éléments parse de KIT.

Cas d’usage

Comptes à rebours de lancement et marketing

Les pages d'atterrissage fixent from comme ouverture de campagne et to comme mise en ligne, puis affichent jours, heures, minutes et secondes jusqu'à la sortie sans bibliothèques de dates côté client.

Questions fréquentes

Que se passe-t-il si une date-heure est invalide ?

Forme ISO incorrecte, jours civils impossibles et champs d'horloge hors plage sont rejetés et non facturés.

Utilise-t-il l'horloge murale du serveur ou Date de JavaScript ?

Non. Les deux instants proviennent de vos chaînes d'entrée. Le moteur utilise une arithmétique grégorienne et de décalage pure sans Date, réseau ni hasard, donc les résultats sont pleinement déterministes.

Et si le moment visé est déjà passé ?

Les jours, heures, minutes et secondes restent positifs, mais le total en secondes devient négatif et le résultat est marqué comme passé. Une page peut alors afficher « en retard » au lieu de « restant ».

Puis-je saisir une date sans heure ?

Oui. Une date seule est lue comme minuit UTC ce jour-là, ce qui permet de travailler avec des limites de journée sans inventer une heure.

Comment les fuseaux horaires sont-ils pris en compte ?

Ajoutez Z pour UTC ou un décalage comme +02:00 après l'heure. Les deux moments sont ramenés en UTC avant la soustraction, de sorte que l'écart reste exact entre deux pays.

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/date/countdown-between

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/countdown-between \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"2026-01-01T00:00:00Z","to":"2026-01-02T01:01:01Z"}'

const res = await fetch("https://api.kit.forhosting.com/date/countdown-between", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "from": "2026-01-01T00:00:00Z",
    "to": "2026-01-02T01:01:01Z"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/countdown-between",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "from": "2026-01-01T00:00:00Z",
    "to": "2026-01-02T01:01:01Z"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/countdown-between", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"from":"2026-01-01T00:00:00Z","to":"2026-01-02T01:01:01Z"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"from":"2026-01-01T00:00:00Z","to":"2026-01-02T01:01:01Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/countdown-between", 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

{
  "from": "2026-01-01T00:00:00Z",
  "to": "2026-01-02T01:01:01Z"
}

Exemple de réponse

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

Le chemin ne touche jamais l'horloge murale, le hasard ni le réseau, de sorte que les mêmes chaînes from et to produisent toujours le même JSON en intégration continue et en production. Formes invalides, dates impossibles telles que le 30 février et composants d'horloge hors plage échouent avec invalid_input et ne sont pas facturés.

Choisir from et to ISO et quels formats sont acceptés

Les alias start, begin et start_date correspondent à from ; end, until, end_date et target correspondent à to, selon les noms courants de formulaires et d'API. Les deux champs sont obligatoires : omettre l'un d'eux, envoyer un non-chaîne ou seulement des espaces lève invalid_input qui nomme le côté manquant.

Lire jours heures minutes secondes total_seconds et direction

Les champs days, hours, minutes et seconds sont toujours non négatifs et ensemble recomposent la valeur absolue de cette différence, de sorte qu'un intervalle d'un jour une heure une minute une seconde produit days un, hours un, minutes un et seconds un quelle que soit la direction. En cas de succès la réponse répète les chaînes normalisées from et to envoyées, plus from_epoch_seconds et to_epoch_seconds comme secondes entières absolues de style Unix calculées sans l'objet Date de l'hôte. Le champ total_seconds est la différence signée to moins from : positive lorsque la fin est plus tardive, nulle lorsque les instants coïncident et négative lorsque la fin est antérieure. Les drapeaux is_past et is_zero, et l'étiquette de direction forward, backward ou zero, permettent aux tableaux de bord de choisir des textes restant versus en retard sans redériver le signe. La chaîne formatée joint les quatre parties en une ligne compacte comme one d one h one m one s pour un affichage rapide, tandis que method est toujours countdown_between pour routeurs et tests dorés.

Usage API, tarification, flux produit et limites pratiques

Envoyez un corps JSON avec les champs chaîne obligatoires from et to au format ISO-8601. Utilisez l'API prépayée lorsqu'un site marketing, un système de billetterie, une plateforme d'examens ou un tableau d'opérations a besoin d'un contrat stable sous solde KIT à $0.002 par élément réussi ; les échecs de validation ne consomment jamais de solde après le rejet du moteur. Les auteurs de SDK peuvent mapper days, hours, minutes et seconds directement en quatre chiffres de compte à rebours et piloter le style en retard depuis is_past avec la même forme de réponse dans chaque liaison de langue.

Cas d'intégration

Examens, événements et délais d'inscription

Les systèmes éducatifs et de billetterie calculent le temps restant jusqu'à une échéance ISO fixe et basculent le texte d'interface avec is_past lorsque l'inscription est close.

Tableaux de bord SLA et opérations

Les outils d'exploitation passent les instants d'ouverture d'incident et de résolution cible, stockent total_seconds pour le tri et affichent des restes formatés sur les tableaux de statut.

Questions techniques

Comment obtenir un compte à rebours entre deux dates ?

Envoyez un JSON avec from et to comme dates-heures ISO-8601 (par exemple from: "2026-01-01T00:00:00Z" et to: "2026-01-02T01:01:01Z"). La réponse inclut days, hours, minutes, seconds et total_seconds signé.

Et si la fin est avant le début ?

Les champs de décomposition restent non négatifs pour l'intervalle absolu, total_seconds est négatif, is_past est vrai et direction est backward pour afficher un état en retard.

Le calculateur de compte à rebours entre deux dates est-il gratuit ?

L'outil navigateur s'exécute gratuitement sur votre appareil. Les appels API utilisent le solde KIT prépayé à $0.002 par élément réussi ; les échecs de validation ne sont pas facturés.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Choisir from et to ISO et quels formats sont acceptés

Usages courants et limites pratiques

Cas d’usage

Comptes à rebours de lancement et marketing

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

Choisir from et to ISO et quels formats sont acceptés

Lire jours heures minutes secondes total_seconds et direction

Usage API, tarification, flux produit et limites pratiques

Cas d'intégration

Examens, événements et délais d'inscription

Tableaux de bord SLA et opérations

Questions techniques

merci