Convertir un horodatage Unix sur Mac sans confondre unités et fuseaux horaires

Lorsqu’un journal ou une réponse d’API contient un horodatage Unix, vérifiez d’abord si sa valeur est en secondes ou en millisecondes. Vérifiez ensuite le fuseau horaire utilisé pour l’affichage. Dans Frset, l’outil Timestamp convertit les horodatages numériques en dates et les dates locales en secondes ou millisecondes.

Distinguez l’instant de son affichage

Un horodatage Unix compte le temps écoulé depuis l’époque Unix. Le même instant peut s’afficher différemment en UTC et dans le fuseau horaire local de votre Mac. La documentation Python sur les dates et heures explique la conversion des horodatages et le rôle des fuseaux horaires.

Par exemple, 1704067200 secondes et 1704067200000 millisecondes représentent le même instant : le 1er janvier 2024 à 00:00:00 UTC. Dans le fuseau Asia/Shanghai, cet instant correspond au 1er janvier à 08:00:00. Un décalage de huit heures entre ces affichages ne signifie pas qu’il faut ajouter huit heures à l’un des horodatages.

Convertissez un horodatage avec Frset

1. Ouvrez la recherche Frset et choisissez Timestamp, avec le mot-clé /time par défaut s’il n’a pas été modifié.
2. Sélectionnez le mode de conversion d’un horodatage en date.
3. Collez uniquement la valeur numérique, sans nom de champ ni guillemets.
4. Lancez la conversion et vérifiez si l’unité détectée est la seconde ou la milliseconde.
5. Comparez les résultats en heure locale et en UTC, puis copiez la représentation voulue.

Les réglages de sortie de l’outil peuvent inclure l’heure locale, UTC, ISO 8601 et RFC 3339. Si une représentation utile manque, vérifiez quelles sorties sont activées. Les résultats obtenus sont copiés dans le presse-papiers et ajoutés à l’historique.

Dans son implémentation actuelle, l’outil accepte les valeurs en secondes à 9 ou 10 chiffres et les valeurs en millisecondes à 12 ou 13 chiffres, dans la plage prise en charge allant du 1er janvier 2000 au 1er janvier 2100 UTC. Cet outil ne prend pas en charge les valeurs négatives, les nombres décimaux ni les dates en dehors de cette plage. Le rejet d’une valeur ne prouve pas que les données sources sont invalides pour tous les systèmes.

Convertissez une date locale en horodatage

Passez au mode de conversion d’une date en horodatage et saisissez une date au format yyyy-MM-dd HH:mm:ss, par exemple 2024-01-01 08:00:00. Choisissez les secondes ou les millisecondes comme unité de sortie, puis lancez l’outil.

Cette date est interprétée dans le fuseau horaire actuellement défini sur le Mac. Si le Mac utilise le fuseau Asia/Shanghai, l’exemple correspond à 1704067200 secondes. Dans un autre fuseau horaire, la même date saisie peut représenter un instant différent. Vérifiez le fuseau du Mac avant de convertir une heure de rendez-vous envoyée par un collègue.

Ce champ n’est pas un parseur de dates universel. Ne collez pas une date ISO avec un suffixe Z ou une date exprimée en langage naturel en supposant qu’elle sera interprétée correctement. Utilisez le format requis et vérifiez séparément le fuseau horaire visé.

Vérifiez trois points si le résultat semble incorrect

• Unité : un système qui attend des millisecondes a besoin d’une autre valeur numérique qu’un système qui attend des secondes. Consultez la documentation de l’API au lieu de vous fier uniquement au nombre de chiffres.
• Fuseau : comparez les résultats UTC et locaux avant de modifier le nombre d’origine. Un décalage d’affichage n’indique pas forcément une erreur de données.
• Signification : vérifiez si le champ correspond à la création, à la modification, à l’expiration ou à un événement programmé. Une conversion correcte ne précise pas le sens du champ.

Ne copiez que la valeur attendue par la destination. Si celle-ci attend un nombre, ne collez pas un bloc de résultat complet contenant des libellés et plusieurs formats de date. Vérifiez une date d’expiration ou une heure programmée avant de l’appliquer à un système réel.

Gardez la source à côté de la conversion

Lorsque vous étudiez une réponse, conservez dans votre note de travail le nom du champ, la valeur d’origine et l’unité attendue. Le guide JSON aide à rendre la réponse lisible, tandis que l’historique du presse-papiers permet de retrouver la source copiée.

La conversion d’horodatages s’exécute localement et ne nécessite aucun fournisseur d’IA. Le nombre d’utilisations disponible dépend de votre offre Frset ; les règles d’unité, de plage et de fuseau horaire restent les mêmes quelle que soit l’offre.