CURRENT_TIME

Syntaxe

Description

Cette fonction permet de demander l'heure courante.

Remarques

• Retourne uniquement l'heure, sans date ni fuseau horaire : La fonction CURRENT_TIME() fournit l'heure courante sous forme de type TIME, incluant les heures, minutes, secondes et fractions de secondes, mais sans inclure la date ni le fuseau horaire. Cela la distingue nettement des fonctions comme CURRENT_DATETIME() ou CURRENT_TIMESTAMP().
• Idéale pour des comparaisons horaires répétitives ou journalières : Cette fonction est particulièrement utile lorsqu'on souhaite effectuer des comparaisons basées uniquement sur l'heure, indépendamment de la date, par exemple pour vérifier si une action se produit durant une plage horaire régulière chaque jour (comme une heure d'ouverture ou de fermeture).
• Le fuseau horaire appliqué dépend du contexte de la session : Même si CURRENT_TIME() ne retourne pas directement le fuseau, l'heure générée est calculée selon le fuseau horaire par défaut du projet BigQuery ou de la session en cours. Cela peut entraîner des différences de valeur selon le contexte d'exécution.
• Particulièrement pratique pour l'affichage simplifié de l'heure : En retournant une heure sous la forme simple HH:MM:SS, la fonction est parfaitement adaptée pour des interfaces utilisateurs ou des rapports qui n'ont pas besoin d'une granularité plus complexe avec la date ou le fuseau horaire.
• N'est pas adaptée pour des calculs de durée en contexte UTC : Comme elle ne fournit ni date ni fuseau, CURRENT_TIME() ne convient pas pour mesurer des durées globales ou effectuer des comparaisons temporelles entre fuseaux horaires ou jours différents. Dans ces cas, il vaut mieux utiliser CURRENT_TIMESTAMP().
• Compatible avec des opérations de type EXTRACT et des filtres temporels : On peut facilement utiliser CURRENT_TIME() dans des clauses comme WHERE EXTRACT(HOUR FROM CURRENT_TIME()) < 12 pour filtrer les données par tranche horaire, ce qui est utile dans les systèmes d'analyse ou les alertes horaires.
• Peut contenir des fractions de seconde selon le contexte de sortie : Le type TIME retourné par CURRENT_TIME() inclut potentiellement des microsecondes, selon le format d'affichage ou l'utilisation ultérieure (comme une concaténation ou un CAST explicite). Cela permet une précision suffisante pour de nombreuses applications.
• Moins courante que d'autres fonctions temporelles, mais utile dans des cas précis : Même si CURRENT_TIME() est moins utilisée que CURRENT_DATE ou CURRENT_TIMESTAMP, elle reste utile pour des cas d'usage où seule l'heure locale est pertinente, sans souci de décalage ou de contexte global, comme les plannings horaires ou les automatisations quotidiennes.