TIMESTAMP_MILLIS

Syntaxe

Paramètres

Description

Cette fonction permet de demander le nombre de milliseconde écoulé depuis le 1^er janvier 1970 en se basant sur une expression horodatage.

Remarques

• Conversion pratique depuis l'époque UNIX en millisecondes : La fonction TIMESTAMP_MILLIS convertit une valeur entière représentant un nombre de millisecondes depuis le 1er janvier 1970 (UTC) en un horodatage BigQuery. Elle est très utile pour interpréter des données issues de systèmes ou d'API utilisant les millisecondes comme unité de temps.
• Complément logique de UNIX_MILLIS : Cette fonction fonctionne en sens inverse de UNIX_MILLIS, convertissant un TIMESTAMP en millisecondes. Ensemble, elles permettent de passer facilement d'une représentation temporelle à une autre sans perte de précision jusqu'à la milliseconde.
• Précision suffisante pour la majorité des cas d'usage : Les millisecondes offrent une granularité suffisante pour la plupart des applications métier, telles que les journaux d'événements, les systèmes de transaction ou les enregistrements de navigation.
• Paramètre d'entrée requis en INT64 : Le paramètre int64_expression doit être un entier 64 bits. Cette exigence permet de couvrir une très large intervalles de dates, bien au-delà des limites des entiers 32 bits classiques.
• Indépendante du fuseau horaire utilisateur : La conversion est basée sur le temps universel coordonné (UTC). Ainsi, la fonction assure une cohérence temporelle entre systèmes et utilisateurs, peu importe leur fuseau horaire local.
• Souvent utilisée pour les données importées : Lors d'une ingestion de données depuis des fichiers JSON, CSV ou Parquet, il est fréquent que les horodatages soient entreposés sous forme de millisecondes. TIMESTAMP_MILLIS permet leur conversion immédiate et fiable en TIMESTAMP natif.
• Attention aux confusions avec TIMESTAMP_MICROS : Il est essentiel de ne pas confondre cette fonction avec TIMESTAMP_MICROS, attendant des microsecondes. Une telle confusion entraîne des résultats de dates complètement erronés avec des décalages très importants.
• Peut être utilisée dans des expressions calculées : Cette fonction peut être insérée dans des requêtes SQL complexes afin de transformer dynamiquement des données numériques en horodatages utilisables dans des filtres, des jointures temporelles ou des visualisations.