FORMAT_DATE |
Date de format |
| BigQuery |
Syntaxe
|
FORMAT_DATE(format_string, date_expr)
|
Paramètres
| Nom |
Description |
| format_string |
Ce paramètre permet de définir le modèle de formatage souhaité pour la date de sortie. Il utilise des éléments de format spécifiques (par exemple, %Y pour l'année à quatre chiffres, %m pour le mois à deux chiffres, %d pour le jour à deux chiffres). |
| date_expr |
Ce paramètre permet de spécifier l'expression de date (une colonne de type DATE ou une expression qui en résulte) que vous souhaitez formater. |
Description
Cette fonction permet de demander une date selon le formatage et l'expression de date spécifié.
Remarques
- La fonction FORMAT_DATE est idéale pour la personnalisation des dates : Elle permet de convertir une date au format DATE en chaîne de caractères selon un
modèle spécifié. Cela est très utile pour afficher la date dans un format lisible ou conforme à des standards régionaux (comme dd/mm/yyyy ou yyyy-mm).
- Le paramètre format_string utilise des codes similaires à strftime : Par exemple, %Y pour l'année, %m pour le mois, %d pour le jour. Il est donc nécessaire
de bien connaître ces spécificateurs de formatage pour créer des chaînes précises. Une mauvaise combinaison donne souvent un résultat vide ou incorrect.
- Elle transforme une date structurée en texte lisible : Contrairement à FORMAT, qui accepte différents types, FORMAT_DATE est spécialement conçue pour le
type DATE. Cela évite les conversions manuelles et permet de s'assurer que la sortie est bien une chaîne lisible et homogène.
- Utile pour les rapports et les interfaces utilisateurs : Quand on veut présenter une date dans un rapport ou une interface utilisateur, il est souvent
préférable de ne pas afficher le format standard YYYY-MM-DD, mais plutôt quelque chose de plus lisible comme "le 16 juin 2025" ou "juin 2025".
- Permet d'adapter les dates à des formats locaux ou métiers : Certaines applications ou services requièrent des formats spécifiques (par exemple, MM/YYYY
pour la comptabilité). FORMAT_DATE offre cette flexibilité sans passer par des manipulations complexes.
- La sortie est toujours une chaîne de caractères (STRING) : Cela signifie que le résultat ne peut plus être utilisé directement dans des opérations de
comparaison ou de calculs de date, sauf si on le convertit à nouveau en DATE avec PARSE_DATE. C'est donc une fonction de présentation uniquement.
- Compatible avec des expressions dynamiques : Le paramètre date_expr peut être une date statique, une colonne de table ou même une sous-expression
(comme CURRENT_DATE()). Cela permet d'utiliser FORMAT_DATE dans des contextes très variés, y compris dans des sous-requêtes ou des champs calculés.
- N'affiche que la partie DATE, pas l'heure : Même si on fournit une valeur dérivée d'un TIMESTAMP ou d'un DATETIME, seule la composante DATE est prise
en compte. Si on souhaite afficher également l'heure, il faut utiliser la fonction FORMAT_DATETIME ou FORMAT_TIMESTAMP à la place.
Dernière mise à jour : Jeudi, le 18 Juin 2020
