UNIX_SECONDS |
Secondes UNIX |
| BigQuery |
Syntaxe
|
UNIX_SECONDS(timestamp_expression)
|
Paramètres
| Nom |
Description |
| timestamp_expression |
Ce paramètre permet de spécifier l'expression de type TIMESTAMP pour laquelle vous souhaitez calculer le nombre de secondes écoulées depuis l'époque UNIX (le 1er janvier 1970, 00:00:00 UTC). La fonction retourne un nombre entier (INT64) représentant ce compte. Si l'horodatage fourni est antérieur à l'époque UNIX, le résultat sera un nombre négatif. |
Description
Cette fonction permet de calculer le nombre de secondes s'étant écoulé entre l'expression d'horodatage spécifié et le 1er janvier 1970.
Remarques
- Conversion directe en format UNIX standard : La fonction UNIX_SECONDS permet de convertir un TIMESTAMP en nombre de secondes écoulées depuis l'époque
UNIX (1er janvier 1970 à 00:00:00 UTC). Ce format est largement utilisé en informatique pour stocker des dates sous forme de nombre entier.
- Retourne un entier de type INT64 : Le résultat est un nombre entier (INT64), ce qui assure une grande précision temporelle sur de longues périodes. Cette
représentation est particulièrement utile pour des opérations mathématiques rapides ou pour l'entreposage dans des systèmes numériques.
- Adaptée aux applications web et systèmes de journaux de bords : De nombreux langages et plateformes comme
JavaScript, Node.js, ou certaines bases
NoSQL utilisent les horodatages en secondes UNIX. La fonction est donc très utile pour assurer la compatibilité avec ces
technologies lors des échanges de données.
- Valeurs négatives possibles pour les dates historiques : Lorsqu'on utilise un horodatage antérieur au 1er janvier 1970, le résultat est négatif, ce
qui respecte les normes POSIX. Cela permet d'analyser des événements passés ou historiques dans des calculs cohérents.
- Moins précise que UNIX_MILLIS ou UNIX_MICROS : Contrairement aux autres fonctions similaires, UNIX_SECONDS tronque les valeurs à la seconde près. Cela
signifie que toute précision au-delà (millisecondes, microsecondes) est ignorée, ce qui peut être insuffisant pour certaines applications sensibles au temps.
- Fonction inverse disponible pour reconstruire les dates : La fonction TIMESTAMP_SECONDS permet de reconvertir un nombre de secondes UNIX en un
TIMESTAMP. Cela facilite les allers-retours entre formats numériques et temporels, notamment lors de l'importation/exportation de données.
- Particulièrement utile pour les calculs de durée : En convertissant deux horodatages en secondes UNIX, il devient trivial de calculer des écarts
temporels simples via une soustraction. Cela permet de mesurer facilement des durées entre deux événements.
- S'appuie sur le fuseau horaire UTC : Comme tous les TIMESTAMP dans BigQuery, UNIX_SECONDS se base sur le temps universel coordonné (UTC). Il est donc
recommandé de faire attention au décalage horaire si les données doivent être interprétées dans un contexte local.
Dernière mise à jour : Jeudi, le 18 Juin 2020