CURRENT_DATE

Syntaxe

Paramètres

Description

Cette fonction permet de demander la date courante en utilisant le fuseau horaire spécifié ou par défaut.

Remarques

• Renvoie uniquement la date, sans l'heure : La fonction CURRENT_DATE retourne un objet de type DATE, c'est-à-dire l'année, le mois et le jour, mais sans composante horaire. Contrairement à CURRENT_TIMESTAMP(), elle est donc adaptée aux comparaisons ou traitements de dates pures sans tenir compte de l'heure.
• Fuseau horaire personnalisable pour précision locale : Grâce à son paramètre optionnel time_zone, cette fonction peut s'adapter à différents contextes géographiques. Cela permet de récupérer la vraie date locale, utile dans les systèmes multinationaux ou dans les rapports alignés avec l'heure d'un pays ou d'un client.
• Si aucun fuseau n'est fourni, le comportement dépend du projet : Lorsque le paramètre time_zone est omis, CURRENT_DATE se base sur le fuseau horaire par défaut du projet BigQuery. Ce paramètre est souvent défini dans la configuration régionale du projet GCP, ce qui peut surprendre si l'on s'attend à une date UTC.
• Idéale pour les filtres temporels dynamiques : CURRENT_DATE est souvent utilisée dans des clauses WHERE pour filtrer les données du jour ou d'une période relative, comme dans WHERE date_col = CURRENT_DATE() ou WHERE date_col >= DATE_SUB(CURRENT_DATE(), INTERVAL 7 DAY). Elle permet des requêtes dynamiques basées sur la date du jour.
• Supporte un large éventail de fuseaux horaires : Le paramètre time_zone accepte des noms de fuseaux conformes à la base IANA, comme 'Asia/Tokyo', 'America/New_York', etc. Cela offre une flexibilité maximale pour gérer des contextes utilisateurs internationaux sans devoir convertir manuellement des horodatages.
• Ne dépend pas du système de l'utilisateur : La fonction ne lit pas la date depuis la machine du client (navigateur, terminal,...), mais depuis l'environnement serveur de BigQuery, garantissant des résultats constants et reproductibles, ce qui est essentiel dans des environnements multi-utilisateurs ou automatisés.
• Peut être combinée avec CAST pour harmoniser les formats : Il est possible de combiner CURRENT_DATE avec CAST ou FORMAT_DATE pour des comparaisons ou des affichages spécifiques. Par exemple, FORMAT_DATE('%Y-%m', CURRENT_DATE()) permet d'extraire un format mensuel. Cela rend la fonction utile dans la préparation de rapports.
• Comparable mais plus simple que CURRENT_DATETIME : CURRENT_DATE est plus simple que CURRENT_DATETIME([time_zone]), renvoyant une date avec heure sans information de fuseau. En préférant CURRENT_DATE, on évite les problèmes liés à l'heure, notamment dans les agrégats ou les regroupements par jour.