Heure locale avec un décalage UTC
Le calculateur d’heure locale à partir d’un décalage UTC transforme une heure UTC connue en heure affichée dans une ville lorsque vous connaissez déjà son décalage fixe.
Lancer gratuitement
Saisissez l’heure UTC, le nom de la ville ainsi que les composantes signées en heures et minutes. Le résultat indique l’heure locale et précise si elle appartient à la veille, au même jour ou au lendemain. Aucune recherche de fuseau, connexion réseau, horloge système ou hypothèse sur l’heure d’été ne modifie le calcul.
Saisissez l’heure UTC de référence et la ville
Commencez par une heure exprimée en temps universel coordonné et respectez strictement le format 24 heures HH:MM. Minuit correspond à 00:00, midi à 12:00 et la dernière minute valide à 23:59. Le champ ville sert à identifier le résultat, et non à demander une recherche géographique. Par exemple, saisir Katmandou ne conduit pas le calculateur à consulter un service de fuseaux horaires ni à choisir le décalage actuellement applicable. Vous devez fournir vous-même le décalage adapté à la date et au contexte. Cette distinction est essentielle, car les villes peuvent appliquer l’heure d’été, les autorités peuvent modifier les règles civiles et les décalages historiques peuvent différer des valeurs actuelles. Consultez une source fiable, déterminez le décalage pertinent, puis associez-le à l’heure UTC. Le format strict évite les valeurs ambiguës, tandis que le nom de ville rend la réponse lisible dans un planning, un rapport ou un tableau de bord sans prétendre que le lieu a été vérifié.
Indiquez les composantes signées du décalage UTC
Saisissez les heures entières dans offset_hours et les minutes restantes dans offset_minutes. Une valeur positive décrit une horloge en avance sur UTC; une valeur négative décrit une horloge en retard. Le décalage +05:45 utilise 5 heures et 45 minutes, tandis que -03:30 utilise -3 heures et -30 minutes. Les deux composantes non nulles doivent porter le même signe afin que le sens soit explicite. Pour un retard inférieur à une heure, indiquez zéro heure et des minutes négatives. La plage totale acceptée va de -12:00 à +14:00. Les minutes doivent être des entiers compris entre -59 et 59; aucune fraction ni valeur excessive n’est arrondie silencieusement. Après validation, le calculateur transforme le décalage complet en minutes signées et l’ajoute au nombre de minutes écoulées depuis minuit UTC. Cette méthode prend en charge les décalages d’une demi-heure ou d’un quart d’heure sans recourir à des heures décimales imprécises.
Interprétez l’heure locale et le changement de jour
Le champ local_time contient l’heure convertie au format 24 heures HH:MM, avec les zéros initiaux. day_offset indique le rapport entre le jour local et celui de la référence UTC: -1 désigne la veille, 0 le même jour et 1 le lendemain. Un décalage positif appliqué tard peut franchir minuit, tandis qu’un décalage négatif juste après minuit UTC peut revenir à la date précédente. Le calculateur ne reçoit aucune date; il n’invente donc ni mois, ni jour de semaine, ni date après le franchissement. Vous pouvez appliquer day_offset à votre date connue avec un outil calendaire adapté. La réponse conserve la ville, les deux heures et les composantes du décalage, ce qui rend le calcul vérifiable. L’algorithme emploie uniquement des entiers bornés et ne dépend ni des paramètres régionaux, ni du fuseau de la machine, ni de l’heure courante. Les entrées incorrectes produisent une erreur typée. L’utilisation de l’API coûte $0.002 par requête, et le même calcul peut fonctionner dans le navigateur.
Cas d’usage
Préparer une réunion à distance
Convertissez une réunion fixée en UTC vers l’horloge de la ville d’un participant lorsque le décalage applicable est connu.
Construire un itinéraire
Affichez l’heure de destination et conservez l’indicateur de changement de jour dans un planning issu de données UTC.
Uniformiser les tableaux de bord
Transformez des heures d’événements UTC en affichages urbains à décalage fixe sans dépendre du fuseau du serveur.
Questions fréquentes
Le calculateur trouve-t-il le décalage UTC actuel d’une ville?
Non. Vous fournissez le décalage; la ville constitue seulement une étiquette descriptive du résultat.
Prend-il en compte l’heure d’été?
Non. Fournissez le décalage fixe applicable au lieu et à la date après examen des règles saisonnières.
Comment saisir un décalage UTC-03:30?
Utilisez -3 dans offset_hours et -30 dans offset_minutes afin que les deux composantes indiquent un retard sur UTC.
Que signifie day_offset?
La valeur est -1 pour la veille, 0 pour le même jour ou 1 pour le lendemain par rapport à la référence UTC.
Combien coûte une requête API?
Chaque requête API coûte $0.002. Le calcul déterministe peut aussi s’exécuter directement dans le navigateur.
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/local-time-from-offset \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}'const res = await fetch("https://api.kit.forhosting.com/date/local-time-from-offset", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"utc_time": "18:45",
"city": "Kathmandu",
"offset_hours": 5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/local-time-from-offset",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"utc_time": "18:45",
"city": "Kathmandu",
"offset_hours": 5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/local-time-from-offset", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/local-time-from-offset", 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
{
"utc_time": "18:45",
"city": "Kathmandu",
"offset_hours": 5
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.local_time_from_offset",
"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. |