TIMESTAMP_MICROS

Syntaxe

Paramètres

Description

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

Remarques

• Conversion directe depuis l'époque UNIX : La fonction TIMESTAMP_MICROS transforme un entier représentant un nombre de microsecondes écoulées depuis le 1er janvier 1970 (UTC) en un horodatage compréhensible. Elle permet donc de manipuler des données temporelles issues de systèmes basés sur l'époque UNIX.
• Utile pour interpréter des données brutes de capteurs ou de journaux de bords : Certains fichiers de journalisation (logs), bases de données ou API fournissent les temps sous forme de microsecondes. Cette fonction facilite leur conversion en horodatages standards sans devoir effectuer de calculs manuels.
• Nécessite une précision INT64 : Le paramètre attendu est un entier 64 bits. Cette précision est essentielle pour représenter correctement les microsecondes sans débordement, surtout pour des dates éloignées ou des traitements à haute fréquence.
• Résultat exprimé au format TIMESTAMP : Le résultat est un horodatage standard de BigQuery, ce qui permet d'utiliser ensuite d'autres fonctions temporelles comme TIMESTAMP_DIFF, FORMAT_TIMESTAMP, ou EXTRACT.
• Permet la conversion inverse avec UNIX_MICROS : TIMESTAMP_MICROS a une fonction complémentaire nommée UNIX_MICROS, convertissant un horodatage en nombre de microsecondes depuis 1970. Ces deux fonctions permettent d'encoder et de décoder des horodatages facilement.
• Supporte les dates très précises jusqu'à la microseconde : Contrairement à d'autres fonctions plus grossières (par exemple TIMESTAMP_SECONDS), cette fonction permet une précision temporelle extrêmement fine, adaptée à des cas d'usage critiques comme les événements financiers ou scientifiques.
• Fonction indépendante du fuseau horaire : Comme elle se base sur l'époque UNIX en UTC, la valeur convertie ne dépend pas du fuseau horaire. Cela garantit une cohérence temporelle dans les calculs, notamment lorsqu'on traite des données internationales.
• Attention aux erreurs de conversion de millisecondes en microsecondes : Il est courant de confondre millisecondes et microsecondes. Une erreur de facteur 1 000 peut produire des dates erronées (trop anciennes ou trop éloignées dans le futur). Il est donc crucial de connaître l'unité exacte de la donnée source.