UNIX_MILLIS

Syntaxe

Paramètres

Description

Cette fonction permet de calculer le nombre de millisecondes s'étant écoulé entre l'expression d'horodatage spécifié et le 1^er janvier 1970.

Remarques

• Conversion précise des horodatages en millisecondes : La fonction UNIX_MILLIS permet de transformer un horodatage (TIMESTAMP) en un entier représentant le nombre de millisecondes écoulées depuis l'époque UNIX (le 1er janvier 1970 à 00:00:00 UTC). Cela facilite les calculs temporels et les comparaisons dans les systèmes utilisant des représentations numériques du temps.
• Résultat exprimé en INT64 : Le résultat retourné est de type INT64, ce qui garantit une grande capacité d'entreposage même pour des horodatages très éloignés dans le temps. Cela permet de manipuler des dates futures ou historiques avec une précision de la milliseconde sans risque de dépassement.
• Utile pour l'intégration avec d'autres systèmes : Beaucoup d'APIs, de bases de données ou de formats de journaux de bords (comme ceux de JavaScript, Firebase, ou Elasticsearch) utilisent le format UNIX en millisecondes. Cette fonction est donc précieuse pour convertir les timestamps BigQuery en format attendu par d'autres systèmes.
• Prise en charge des valeurs négatives pour les dates avant 1970 : Si l'horodatage spécifié est antérieur à l'époque UNIX, UNIX_MILLIS retournera un nombre négatif, ce qui est conforme au standard UNIX. Cela garantit la cohérence dans les traitements de données historiques.
• Moins précis que UNIX_MICROS, mais plus rapide et suffisant dans la majorité des cas : Alors que UNIX_MICROS offre une précision plus fine, UNIX_MILLIS est souvent suffisant pour la majorité des cas d'utilisation, comme les analyses journalières, les durées d'activités, ou les journaux de connexion. Il est aussi plus léger en termes de traitement.
• Permet des calculs temporels efficaces avec d'autres fonctions : UNIX_MILLIS s'intègre bien avec des opérations arithmétiques ou des fonctions comme TIMESTAMP_MILLIS, qui permet de reconvertir la valeur en timestamp. Cela permet de faire des allers-retours simples entre représentation temporelle et numérique.
• Favorise la simplification de la comparaison entre horodatages : Comparer deux horodatages devient plus simple une fois convertis en millisecondes, car il s'agit alors de simples comparaisons d'entiers. Cela permet de mesurer des durées, classer des événements ou calculer des écarts de temps plus facilement.
• La fonction suppose le fuseau horaire UTC : Comme tous les horodatages dans BigQuery sont stockés en UTC, UNIX_MILLIS fait ses calculs par rapport à ce fuseau. Il est donc important de ne pas oublier la conversion de fuseau horaire si l'on souhaite afficher ou interpréter les résultats dans un autre contexte horaire.