Écart d'offset UTC

Les offsets hors plus ou moins quatorze heures sont rejetés avec invalid_input. Le chemin est déterministe—sans réseau, sans graines aléatoires, sans Date d’horloge murale—ainsi l’exécuteur gratuit du navigateur et l’API prépayée renvoient le même JSON après un arrondi fixe à chaque fois.

Offsets UTC fixes versus zones horaires nommées

En limitant le contrat à des nombres fixes dans l’intervalle fermé de moins quatorze à plus quatorze heures, l’outil reste prévisible pour les tableurs, les tests d’API et les notes de voyage qui impriment déjà des libellés UTC±.

Comment appeler l’API et lire la réponse

Envoyez un corps JSON avec les nombres finis obligatoires offset_a et offset_b (les alias incluent a, from_offset, offset_from, utc_a pour le premier, et b, to_offset, offset_to, utc_b pour le second), chacun entre moins quatorze et plus quatorze inclus, plus l’entier obligatoire hour_a de zéro à vingt-trois pour l’heure locale en A. L’optionnel minute_a vaut zéro par défaut et doit être un entier de zéro à cinquante-neuf lorsqu’il est présent. En cas de succès la réponse renvoie les offsets arrondis et l’horloge d’entrée, publie offset_a_label et offset_b_label comme courtes chaînes UTC±, fixe hour_diff à offset_b moins offset_a, abs_diff_hours à la valeur absolue de cet écart, hour_b et minute_b et time_b pour l’horloge projetée en B, day_offset pour le nombre de minuits franchis en ajoutant la différence, day_note et direction comme résumés courts, message comme résultat d’une ligne, et steps comme un tableau ordonné de lignes de substitution. Une validation échouée—champs manquants, nombres non finis, heure ou minute non entières, heure hors de zéro à vingt-trois, minute hors de zéro à cinquante-neuf, ou tout offset dont la valeur absolue dépasse quatorze heures—renvoie invalid_input et n’est jamais facturée. Le tarif est un $0.002 forfaitaire par requête réussie avec unité item et prix unitaire marginal nul.

Conseils pratiques, limites et recherches associées

Gardez les offsets dans la fenêtre publiée de plus ou moins quatorze heures ; des valeurs telles que quinze ou moins quatorze virgule un sont rejetées pour que les appelants n’inventent pas d’offsets civils impossibles. Préférez les heures fractionnaires pour les zones de demi-heure et de trois quarts d’heure—cinq virgule cinq pour l’Inde, cinq virgule sept cinq pour le Népal, neuf virgule cinq pour certaines parties de l’Australie—plutôt que de glisser des minutes dans un second champ qui n’existe pas pour l’offset lui-même. Cette page vise les recherches sur la différence d’offset horaire, les heures d’offset UTC entre deux lieux ou l’heure locale données deux offsets fixes ; ce n’est ni un calculateur de durée de vol, ni un conseiller d’heure d’été, ni un convertisseur de zone par nom de ville. Préférez cette capacité lorsque les deux extrémités publient déjà des libellés UTC± fixes ; si vous n’avez que des noms de ville, résolvez d’abord les offsets ou utilisez un outil de zone conscient de l’heure d’été. Lors de la projection d’une horloge locale, souvenez-vous que la différence signée est toujours B moins A : si A est UTC plus deux et B UTC moins cinq, hour_diff vaut moins sept, donc quinze heures trente en A devient huit heures trente le même jour calendaire en B. Franchir minuit fixe day_offset à plus un ou moins un et la chaîne day_note explique de quel côté de minuit B se trouve par rapport à A. Associez des exemples en enseignant : le même offset laisse l’horloge inchangée ; un trajet vers l’ouest d’heures entières soustrait des heures ; vers l’est en ajoute ; un offset d’une demi-heure produit un décalage de trente minutes ; un offset hors plage démontre le chemin dur invalid_input. Les tâches échouées qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui garde les scripts exploratoires peu coûteux lorsque des apprenants envoient volontairement l’offset quinze. Les contrôles aller-retour sont simples : recalculez à la main offset_b moins offset_a et confirmez l’égalité avec hour_diff, puis ajoutez autant d’heures à time_a et confirmez que time_b et day_offset correspondent après le wrap sur vingt-quatre heures.