CURRENT_TIMESTAMP |
Horodatage courante |
|---|---|
| BigQuery | |
Syntaxe
| CURRENT_TIMESTAMP() |
Description
Cette fonction permet de demander horodatage courant sous la forme d'un type de données TIMESTAMP.
Remarques
- Retourne la date et l'heure exactes au format TIMESTAMP : La fonction CURRENT_TIMESTAMP() renvoie un horodatage complet, c'est-à-dire la date et l'heure avec la précision maximale disponible, incluant les fractions de seconde. Elle est représentée au format TIMESTAMP, qui est basé sur le temps UTC.
- Utile pour suivre les événements en temps réel : Grâce à sa précision, cette fonction est idéale pour enregistrer des journaux de bords, tracer des actions utilisateur ou générer des horodatages précis dans les bases de données. Elle garantit que chaque appel enregistre exactement le moment de l'exécution.
- Indépendante du fuseau horaire local : Contrairement à CURRENT_DATETIME() ou CURRENT_TIME(), la valeur renvoyée par CURRENT_TIMESTAMP() est toujours calculée par rapport à l'heure UTC, ce qui la rend cohérente et fiable dans des environnements distribués.
- Compatible avec des fonctions de conversion temporelle : Il est courant d'utiliser CURRENT_TIMESTAMP() avec des fonctions comme DATETIME(TIMESTAMP, TIME_ZONE) ou FORMAT_TIMESTAMP() pour adapter l'horodatage à un fuseau horaire spécifique ou à un format lisible par l'utilisateur final.
- Recommandée pour l'horodatage universel dans les applications : En tant qu'horodatage en temps universel (UTC), elle est parfaitement adaptée pour entreposer des événements dans des systèmes multi-fuseaux horaires, garantissant une uniformité temporelle entre utilisateurs ou systèmes.
- Non personnalisable via un paramètre de fuseau horaire : Contrairement à CURRENT_DATE([timezone]) ou CURRENT_DATETIME([timezone]), la fonction CURRENT_TIMESTAMP() ne permet pas d'ajuster directement le fuseau horaire via un paramètre. Toute conversion doit être effectuée séparément.
- Utilisable dans les champs par défaut lors d'insertion de données : Elle peut être utilisée dans une instruction INSERT ou comme valeur par défaut d'une colonne TIMESTAMP pour horodater automatiquement chaque nouvelle ligne ajoutée à une table.
- Précise à la microseconde, voire plus selon le moteur de requête : La granularité de CURRENT_TIMESTAMP() peut aller jusqu'à la microseconde (ou plus), ce qui en fait une fonction essentielle pour les systèmes nécessitant des mesures de performance ou des traces d'événements très détaillées.
Dernière mise à jour : Jeudi, le 18 Juin 2020