Écart horaire entre villes
À 15:00 à New York (UTC−5), il est 05:00 le lendemain à Tokyo (UTC+9), soit 14 heures d'écart. Saisissez les deux villes, leurs décalages UTC et l'heure locale pour caler un appel ou un voyage. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Ville A
- New York
- Utc a
- -5
- Ville B
- Tokyo
- Utc b
- 9
- Heure
- 15
- Minute
- 0
- Libellé UTC de A
- UTC-5
- Libellé UTC de B
- UTC+9
- Heure à A
- 15:00
- Heure à B
- 05:00
Un calculateur d'écart horaire entre villes répond à la question quotidienne du voyage et de l'appel : s'il est telle heure locale dans une ville, quelle heure est-il dans l'autre, et combien d'heures séparent ces deux horloges ? Vous nommez les deux villes et fournissez le décalage UTC fixe de chacune en heures—moins cinq pour New York à l'heure d'hiver, plus neuf pour Tokyo, plus douze pour Auckland, moins dix pour Honolulu—plus l'heure locale et la minute facultative dans la première ville. Le moteur renvoie l'écart horaire signé, les deux horloges locales en HH:MM, le décalage de jour civil après le repli de minuit, un repli par le chemin le plus court dans une fenêtre de plus ou moins douze heures, et un indicateur lorsque les deux décalages sont séparés de plus d'une demi-journée, signature civile d'un franchissement de la ligne de changement de date. Les décalages hors de plus ou moins quatorze heures sont rejetés.
Comment l'écart d'heures et les deux horloges locales sont calculés
Toute horloge civile d'une ville peut s'écrire comme un décalage fixe par rapport au temps universel coordonné dès que vous connaissez déjà le calendrier saisonnier qui vous importe. New York à l'Eastern Standard Time est UTC moins cinq ; Tokyo est UTC plus neuf ; Delhi est UTC plus cinq et demi ; Adelaide est UTC plus neuf et demi ; Kathmandu est UTC plus cinq et trois quarts.
Ce calculateur ne recherche jamais ces nombres pour vous : vous saisissez les noms de villes comme étiquettes et les deux décalages en heures, puis vous donnez l'heure locale—et éventuellement la minute—déjà affichée sur l'horloge de la première ville. L'écart horaire signé est toujours le décalage de la ville B moins le décalage de la ville A. Cette seule soustraction est le nombre d'heures à ajouter à l'heure locale de la première ville pour obtenir celle de la seconde au même instant.
Le travail se fait en minutes entières afin que les fuseaux de demi-heure et de quart d'heure restent exacts : l'écart est multiplié par soixante et arrondi à la minute la plus proche, puis ajouté à heure fois soixante plus minute. Le total de minutes est replié sur une horloge de vingt-quatre heures.
Ce qui reste après retrait des jours complets est le HH:MM dans la ville B ; le nombre de jours complets retirés est le décalage de jour civil, qui peut aller de moins deux à plus deux aux extrêmes réels de UTC moins quatorze et UTC plus quatorze. Lorsque les deux villes partagent un décalage, les horloges coïncident et le décalage de jour vaut zéro.
Sinon, la réponse nomme la ville en avance, imprime les deux horloges et liste les étapes de substitution afin que vous puissiez vérifier l'arithmétique à la main avant de réserver un appel ou une réunion.
Saut de jour à la ligne internationale de changement de date
La ligne internationale de changement de date est la couture civile près de cent quatre-vingts degrés de longitude où la date du calendrier saute. Les villes du flanc est de cette couture utilisent de grands décalages positifs, comme UTC plus douze à Auckland, UTC plus treize aux Samoa ou UTC plus quatorze aux Line Islands. Celles du flanc ouest utilisent de grands décalages négatifs, comme UTC moins dix à Honolulu, UTC moins onze aux American Samoa ou UTC moins douze à Baker Island.
Soustraire ces décalages peut produire un écart supérieur à douze heures et, aux extrêmes, supérieur à vingt-quatre, de sorte qu'ajouter l'écart à une horloge locale peut atterrir non seulement la veille ou le lendemain, mais à deux jours de distance. Ce point de terminaison traite cette situation comme une donnée de premier plan, non comme une remarque tardive. Des paires classiques illustrent le contrat.
Quinze heures à New York en UTC moins cinq sont cinq heures du matin le jour civil suivant à Tokyo en UTC plus neuf, un écart de plus quatorze heures qui signale la ligne de date et se replie à moins dix heures dans l'autre sens. Midi à Auckland en UTC plus douze est quatorze heures la veille à Honolulu en UTC moins dix, un écart de moins vingt-deux heures qui se replie à plus deux.
Neuf heures du matin aux Samoa en UTC plus treize sont neuf heures du matin la veille aux American Samoa en UTC moins onze : même cadran, vingt-quatre heures et un jour civil d'écart. Servez-vous de ces champs lorsqu'il faut dire à un voyageur s'il doit écrire mardi ou mercredi sur la carte d'embarquement, et pas seulement ce que l'horloge murale indiquera.
Cas d’usage
Planifier un appel de l'autre côté de l'océan
Choisissez une heure locale dans votre ville, saisissez le décalage UTC de l'autre et lisez les deux horloges plus la note de jour civil avant d'envoyer l'invitation à la réunion.
Vérifier le jour de voyage à la ligne de date
Comparez Auckland et Honolulu ou Samoa et American Samoa et voyez si le calendrier de destination est hier, aujourd'hui ou décalé de deux jours.
Inscrire les horloges de ville dans un briefing de voyage
Étiquetez deux villes, figez leurs décalages UTC± publiés et placez la paire HH:MM et l'écart d'heures dans l'itinéraire sans ouvrir une base de fuseaux.
Questions fréquentes
Comment trouver l'écart horaire entre deux villes ?
Saisissez les deux noms de villes, le décalage UTC fixe de chacune en heures et l'heure locale dans la première.
Pourquoi le jour civil peut-il différer si les horloges semblent proches ?
À la ligne de date, l'écart brut peut valoir 22 ou 24 heures. Les cadrans peuvent sembler n'être séparés que de deux heures, voire identiques, alors que la ville B est la veille ou le lendemain.
Cet outil interroge-t-il les fuseaux à partir du nom de la ville ?
Non. Les noms de villes sont uniquement des étiquettes d'affichage. Vous fournissez les décalages UTC fixes. Le moteur n'appelle pas de base de fuseaux, n'applique pas le DST et ne lit pas l'horloge hôte.
Comment tenir compte de l'heure d'été ?
Choisissez les décalages de la saison qui vous intéresse avant de les saisir. Le calculateur utilise les décalages fixes que vous indiquez : New York est à moins cinq en heure normale, et en été il faut saisir son décalage d'été.
Les fuseaux à la demi-heure ou au quart d'heure sont-ils pris en charge ?
Oui. Les décalages peuvent être fractionnaires, comme plus cinq et demi pour Delhi, plus neuf et demi pour Adélaïde ou plus cinq trois quarts pour Katmandou. Le calcul se fait en minutes entières, ces fuseaux restent donc exacts.
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/travel/time-difference-cities \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"city_a":"New York","utc_a":-5,"city_b":"Tokyo","utc_b":9,"hour":15}'const res = await fetch("https://api.kit.forhosting.com/travel/time-difference-cities", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"city_a": "New York",
"utc_a": -5,
"city_b": "Tokyo",
"utc_b": 9,
"hour": 15
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/travel/time-difference-cities",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"city_a": "New York",
"utc_a": -5,
"city_b": "Tokyo",
"utc_b": 9,
"hour": 15
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/time-difference-cities", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"city_a":"New York","utc_a":-5,"city_b":"Tokyo","utc_b":9,"hour":15}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"city_a":"New York","utc_a":-5,"city_b":"Tokyo","utc_b":9,"hour":15}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/time-difference-cities", 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
{
"city_a": "New York",
"utc_a": -5,
"city_b": "Tokyo",
"utc_b": 9,
"hour": 15
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "travel.time_difference_cities",
"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.
Limites
max_abs_offset_hours | 14 |
max_city_len | 80 |
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
L'arithmétique est déterministe : sans réseau, sans horloge hôte, sans base de zones IANA et sans deviner l'heure d'été, de sorte que l'exécuteur gratuit du navigateur et l'API s'accordent toujours.
Saut de jour à la ligne internationale de changement de date
Le champ hour_diff est l'écart brut signé. Le champ hour_diff_wrapped projette cet écart sur le représentant unique de l'intervalle semi-ouvert de moins douze à plus douze, le chemin le plus court autour de l'horloge de vingt-quatre heures. Le booléen crosses_date_line est vrai précisément lorsque l'écart brut absolu est strictement supérieur à douze heures : le test civil selon lequel les deux horloges sont séparées de plus d'une demi-journée.
Contrat d'entrée, erreurs et quand cette page est le bon outil
L'intention de recherche ici est la requête grand public écart horaire entre villes, non une identité brute de décalage de fuseau ni une horloge d'arrivée par durée de vol. Réglez vous-même l'heure d'été avant de choisir les décalages, ou utilisez un convertisseur de zone nommée lorsque vous n'avez que des identifiants IANA. Envoyez un corps JSON avec cinq champs obligatoires et un champ facultatif. city_a et city_b sont des noms non vides d'au plus quatre-vingts caractères après trim ; ce sont des étiquettes du résultat, pas des clés d'une base de fuseaux. utc_a et utc_b sont des décalages UTC finis en heures, inclus de moins quatorze à plus quatorze, et peuvent être fractionnaires afin que l'Inde, le Népal et les fuseaux australiens de demi-heure restent honnêtes. hour est l'heure locale entière dans la ville A sur une horloge de vingt-quatre heures de zéro à vingt-trois. minute est facultatif, vaut zéro par défaut et doit être un entier de zéro à cinquante-neuf lorsqu'il est présent. Des alias sont acceptés au transport : from_city, city ou a_name pour city_a ; to_city ou b_name pour city_b ; offset_a, from_offset ou utc_from pour utc_a ; offset_b, to_offset ou utc_to pour utc_b ; hour_a, h ou local_hour pour hour ; minute_a, m ou local_minute pour minute. Noms manquants, chaînes vides, décalages non finis, heures ou minutes hors plage, hour ou minute non entiers, et tout décalage dont la valeur absolue dépasse quatorze heures échouent avec invalid_input en nommant le champ ; ces échecs ne sont pas facturés. En cas de succès, le corps répète les villes, les décalages arrondis, les libellés UTC±, l'horloge d'entrée, les deux chaînes HH:MM, les écarts horaires signé, absolu et replié, day_offset et day_label, l'indicateur de ligne de date, ahead_city et behind_city, un message d'une ligne et les étapes ordonnées. Les appels API réussis coûtent $0.002 par requête ; une entrée invalide ne consomme pas le solde prépayé.
Questions techniques
Que signifie crosses_date_line ?
Il est vrai lorsque l'écart horaire absolu est supérieur à 12. Ce test civil marque des horloges séparées de plus d'une demi-journée, signature habituelle d'une paire du Pacifique ou de la ligne de date.
Combien coûte le calculateur d'écart horaire entre villes ?
L'outil du navigateur est gratuit. Les requêtes API utilisent le solde KIT prépayé à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.