ForHosting KIT · Outils pour développeurs

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.

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

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.

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.

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.

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/local-time-from-offset

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/local-time-from-offset \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}'
{
  "utc_time": "18:45",
  "city": "Kathmandu",
  "offset_hours": 5
}
{
  "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.

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 →