Syntaxe
|
FORMAT(format_string, ...)
|
Paramètres
| Nom |
Description |
| format_string |
Ce paramètre permet de définir le modèle de formatage du texte. Il inclut du texte littéral et des spécificateurs de format (par exemple, %s pour une chaîne, %d pour un entier) qui indiquent où les valeurs des paramètres suivants doivent être insérées et comment elles doivent être formatées. |
| ... |
Ces paramètres permettent de fournir les valeurs qui seront substituées dans le format_string. Le nombre et les types de ces paramètres doivent correspondre aux spécificateurs de format définis dans le format_string. Par exemple, si votre format_string contient %s et %d, vous devrez fournir un paramètre de type chaîne et un paramètre de type entier dans cet ordre. |
Description
Cette fonction permet d'effectuer la transformation d'un texte selon un certain format, un peu comme une fonction de style printf du langage de programmation C.
Remarques
- La fonction FORMAT fonctionne comme printf en C : Elle permet d'insérer dynamiquement des valeurs dans une chaîne de caractères en utilisant des
spécificateurs de format. Cela la rend très utile pour produire des résultats textuels lisibles à partir de données numériques ou mixtes, surtout dans des rapports ou
exports personnalisés.
- Elle prend en charge plusieurs types de données grâce aux spécificateurs : Les plus courants sont %s pour les chaînes, %d pour les entiers, %f pour les
flottants. Il est donc essentiel de connaître le type de chaque valeur fournie, car une incohérence entre le format et la valeur provoque une erreur.
- L'ordre des paramètres est fondamental : Les valeurs passées après le format_string sont substituées dans l'ordre où apparaissent les spécificateurs. Il
faut donc veiller à respecter le bon alignement entre les types de données et leur position dans le format pour éviter des erreurs ou des résultats inattendus.
- Le format_string peut contenir du texte libre et structuré : Il est possible de combiner du texte libre, des symboles, des unités et des variables
dynamiques dans un même appel à FORMAT. Cela permet par exemple de générer des étiquettes comme : "Total: $%f USD" avec un montant formaté automatiquement.
- Très utile pour formater des résultats avant export : Quand on souhaite préparer des chaînes pour l'affichage ou l'exportation, par exemple dans un
fichier CSV ou JSON généré depuis BigQuery, FORMAT permet d'obtenir une
présentation propre et bien agencée.
- Utile pour concaténer proprement plusieurs valeurs hétérogènes : Plutôt que de faire des chaînes complexes avec CONCAT, CAST, ou SAFE_CAST, la fonction
FORMAT permet de gérer plusieurs types de manière élégante et en une seule étape, rendant le SQL plus lisible.
- Peut être combinée avec des fonctions d'analyse ou de regroupement : Dans des requêtes avancées, on peut utiliser FORMAT dans des champs SELECT ou dans
des sous-requêtes, afin de présenter des agrégats, totaux ou valeurs intermédiaires sous forme de messages clairs (exemple : "Moyenne: %.2f kg").
- Permet le contrôle de la précision numérique : Avec %f, on peut spécifier le nombre de décimales (exemple %.2f pour deux chiffres après la virgule), ce
qui est particulièrement pratique pour les rapports financiers, statistiques ou scientifiques où la présentation numérique normalisée est essentielle.
Dernière mise à jour : Jeudi, le 18 Juin 2020
