ForHosting KIT · Outils pour développeurs

Point médian entre deux dates

Trouver le point médian entre deux dates répond à une question différente du décompte de jours entiers, d’un compte à rebours ou d’un calcul d’âge : elle demande l’unique instant équidistant entre deux points connus de la ligne temporelle.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Ce calculateur du point médian entre deux dates accepte deux datetimes ISO-8601 explicites—horodatages complets avec Z ou décalage numérique, ou date seule traitée comme minuit UTC—, convertit les deux en millisecondes d’époque par arithmétique grégorienne pure, moyenne ces instants avec le plancher déterministe de la somme, et renvoie le datetime à mi-chemin formaté en UTC avec précision à la milliseconde. Contrôles classiques : minuit à minuit sur des jours consécutifs tombe à midi ; un intervalle d’une seconde tombe à la demi-seconde ; des extrémités identiques renvoient le même instant. Le moteur ne consulte jamais l’horloge hôte, n’appelle pas le réseau et n’utilise pas l’objet Date de la plateforme, de sorte que les mêmes entrées produisent toujours le même point médian dans le widget gratuit du navigateur et dans l’API à $0.002 par requête réussie. Utilisez-le pour des jalons à mi-projet, des centres de fenêtres de facturation et des fixtures reproductibles en CI.

Ce qu’un point médian d’instants signifie et ce que la réponse contient

Moyennner deux instants absolus est l’analogue temporel du milieu d’un segment sur la droite numérique : si vous connaissez le début et la fin d’une réunion, d’une étude, d’une campagne ou d’une fenêtre contractuelle, le point médian est l’unique instant UTC équidistant en millisecondes des deux extrémités. Ce n’est pas la date civile « au milieu de mars » sur plusieurs jours, ni un milieu en jours ouvrables qui saute les week-ends, ni une moyenne d’horloge murale qui prétend que chaque jour civil fait exactement vingt-quatre heures en ignorant les décalages. Vous fournissez start et end comme chaînes ISO-8601 ; chacune peut être un datetime complet avec secondes fractionnaires optionnelles et un décalage Z ou heures-minutes, ou une valeur date seule YYYY-MM-DD traitée comme minuit UTC pour que les paires de calendrier simples fonctionnent encore. Le calculateur valide que les deux jours existent sur le calendrier grégorien—y compris le 29 février uniquement les années bissextiles—, convertit chaque entrée en nombre de millisecondes d’époque UTC par arithmétique civile proleptique, puis fixe midpoint_epoch_ms au plancher de la somme des deux époques divisée par deux, de sorte qu’un total impair de millisecondes donne encore un choix unique et déterministe. La réponse répète les chaînes originales start et end pour l’audit, renvoie midpoint comme chaîne ISO UTC avec trois chiffres fractionnaires et Z final, rapporte start_epoch_ms, end_epoch_ms et midpoint_epoch_ms pour les pipelines numériques, et inclut span_ms comme distance absolue plus signed_span_ms comme end moins start pour voir la direction lorsque le second instant est antérieur au premier. Un court champ formula rappelle la moyenne pour documenter le contrat à côté de la réponse. Les cas rejetés incluent un start ou end manquant, des chaînes non ISO-8601, des mois ou jours impossibles comme 2023-02-29, des composants d’horloge invalides et des années hors de un à 9999. Si vous avez besoin de décomptes de jours de calendrier, de parties de compte à rebours ou d’âge en années et mois, utilisez ces outils dédiés ; cette page répond uniquement à l’instant exact à mi-chemin entre deux horodatages validés.

Comment start et end sont lus et comment le point médian reste reproductible

Le premier champ préféré est start, mais les alias from, date1, a et begin sont acceptés pour que tableurs, chaînes de requête et formulaires réutilisent le même contrat sans renommer les colonnes. Le second préféré est end, avec les alias to, date2, b et finish pour la même raison. Chaque chaîne est tronquée des espaces ; les valeurs date seule deviennent minuit UTC ; les datetimes peuvent utiliser T ou un espace entre date et heure ; les secondes fractionnaires sont acceptées et tronquées en millisecondes entières avant la moyenne afin que le bruit sous-milliseconde n’invente pas un second point médian. Les décalages tels que plus zéro deux deux-points zéro zéro ou moins zéro cinq deux-points zéro zéro sont convertis en UTC en soustrayant les minutes de décalage de l’époque civile locale, de sorte qu’un soir à New York et un matin à Paris qui désignent le même intervalle absolu se moyennent correctement en UTC. En interne le moteur mappe chaque triple civil vers un compte de jours série via le mappage bien connu days_from_civil, multiplie par quatre-vingt-six millions quatre cent mille millisecondes par jour, ajoute les millisecondes de l’heure du jour et ajuste le décalage—arithmétique entière pure sans Date, Math.random ni réseau. Le point médian est reformaté avec le mappage inverse civil_from_days pour que la chaîne UTC imprimée corresponde exactement à midpoint_epoch_ms. Des entrées identiques donnent le même instant comme point médian ; inverser la paire laisse le point médian et l’écart absolu inchangés et n’inverse que le signe de signed_span_ms. Comme chaque étape est déterministe, l’exécution gratuite dans le navigateur et le chemin API payant s’accordent octet par octet sur le même module, idéal pour des fixtures CI qui figent 2024-01-01T12:00:00.000Z comme point médian de minuits consécutifs sans réimplémenter les tables bissextiles à la main.

Où l’arithmétique du point médian s’inscrit en planification, science et logiciel

Les chefs de projet marquent des points de contrôle à mi-chemin lorsqu’une fenêtre de lancement ou un sprint est défini par deux horodatages explicites et que les parties prenantes veulent une seule heure de revue à mi-fenêtre plutôt qu’une vague étiquette de mi-semaine. Chercheurs et systèmes de laboratoire enregistrent le point médian d’un intervalle d’observation pour que les tableaux récapitulatifs montrent un instant représentatif pour les graphiques et jointures sans choisir arbitrairement le début ou la fin. Les équipes finance et opérations centrent des fenêtres de facturation ou de préavis lorsqu’une politique se réfère au milieu d’une période déjà stockée comme paire d’instants ISO dans un grand livre. Les développeurs appellent le contrat depuis des scripts pour générer des points médians déterministes pour les planificateurs, affirmer des champs à mi-chemin dans les rapports, ou satisfaire des exigences produit qui exigent une moyenne UTC pure sans dérive de fuseau due à l’objet Date hôte. Éducateurs et rédacteurs de normes utilisent l’outil pour montrer que le point médian d’un intervalle d’une seconde est la demi-seconde, et que des entrées avec décalage se réduisent encore à une seule réponse normalisée avec Z. Sur cette page le travail s’exécute entièrement dans votre navigateur ; via l’API chaque recherche réussie coûte $0.002, une validation échouée n’est pas facturée et rien n’est stocké après la réponse. Cette répartition—exploration interactive gratuite et API payante identique—correspond au reste du catalogue KIT de niveau A et vous permet de passer d’un contrôle ponctuel à un pipeline sans changer le résultat mathématique. Associez-le à days-between, countdown-between ou aides d’époque lorsque vous avez besoin d’étapes temporelles liées, et gardez cette page pour l’intention de recherche du point médian entre deux dates comme datetime exact.

Jalons à mi-projet et à mi-campagne

Calculez l’heure exacte de revue à mi-fenêtre pour un sprint, un lancement ou une campagne marketing définie par deux horodatages ISO.

Points médians d’observation et d’expérience

Enregistrez un unique instant UTC représentatif d’un intervalle d’observation pour que graphiques et jointures ne choisissent pas arbitrairement le début ou la fin.

Fixtures déterministes de CI et de facturation

Générez des valeurs de point médian reproductibles pour tests unitaires, centres de grand livre et pipelines sans dépendre de Date ni de l’horloge hôte.

Combien coûte le calculateur du point médian entre deux dates ?

Il est gratuit dans votre navigateur sur cette page. Via l’API une requête réussie coûte $0.002 ; les entrées invalides ne sont pas facturées.

Comment le point médian est-il défini ?

Les deux entrées sont converties en millisecondes d’époque UTC. midpoint_epoch_ms vaut floor((start_ms + end_ms) / 2), puis formaté en chaîne ISO-8601 UTC à la milliseconde.

Les fuseaux horaires et décalages affectent-ils le résultat ?

Oui, correctement : les décalages de chaque entrée sont convertis en UTC avant la moyenne. Le point médian est toujours renvoyé avec un Z final en UTC.

Que se passe-t-il si les deux datetimes sont identiques, ou si end est avant start ?

Des entrées identiques renvoient ce même instant comme point médian. Si end est antérieur à start, le point médian est inchangé et seul signed_span_ms devient négatif.

Les valeurs date seule sont-elles acceptées ?

Oui. Une chaîne YYYY-MM-DD est traitée comme minuit UTC de ce jour civil, puis moyennée comme tout autre instant.

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.

POSThttps://api.kit.forhosting.com/date/midpoint-between-dates

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é.

curl -X POST https://api.kit.forhosting.com/date/midpoint-between-dates \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2024-01-01T00:00:00Z","end":"2024-01-02T00:00:00Z"}'
{
  "start": "2024-01-01T00:00:00Z",
  "end": "2024-01-02T00:00:00Z"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.midpoint_between_dates",
  "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.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →