nom_format_valeur

Utilisation

view: view_name {
  dimension: field_name {
    value_format_name: format_name
  }
}

Hiérarchie Afficher le fichier view Type de champ value_format_name

Types de champs possibles Dimension, Mesure Acceptation L'un des formats de valeur par défaut listés sur cette page de documentation ou le nom d'un format que vous avez créé avec le paramètre named_value_format

Définition

Le paramètre value_format_name vous permet de mettre en forme les valeurs des données à l'aide de formats intégrés à Looker ou de vos propres formats personnalisés et réutilisables. Si vous souhaitez appliquer un format de type Excel directement à un champ unique, utilisez plutôt value_format.

Le paramètre value_format_name peut être utilisé à la fois pour les dimensions et les mesures. Exemple :

measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format_name: usd
}

Remarque : value_format_name n'affecte que la façon dont les valeurs des champs sont affichées dans le contenu Looker. value_format_name ne modifie pas la valeur dans la base de données et n'a aucune incidence sur celle-ci.

Noms de formats par défaut

Looker propose les formats par défaut indiqués dans les tableaux suivants. Lorsque vous utilisez l'un des formats par défaut, Looker arrondit les valeurs à l'entier supérieur ou inférieur pour supprimer les chiffres, au lieu de les tronquer. Lorsqu'un nom de format par défaut est utilisé sur une mesure, l'arrondi a lieu après l'agrégation de la mesure.

Vous pouvez également créer vos propres formats nommés à l'aide du paramètre named_value_format.

Formats numériques

Les formats par défaut des types de champs numériques sont indiqués dans le tableau suivant. Ils commencent par la valeur sous-jacente "1234.56789" :

Nom	Exemple
decimal_0	1 235
decimal_1	1 234,6
decimal_2	1 234,57
decimal_3	1 234,568
decimal_4	1,234.5679
usd_0	1 235 $
usd	1 234,57 $
gbp_0	1 235 £
gbp	1 234,57 £
eur_0	1 235 €
eur	1 234,57 €
id	1235

Pour les types de champs numériques, id ne doit être utilisé que pour les nombres comportant 16 chiffres ou moins. Au-delà de 16 chiffres, id peut arrondir les résultats. Pour les nombres comportant plus de 16 chiffres, convertissez-les en chaîne et utilisez id sur le type de champ de chaîne.

Formats de pourcentage

Pour les formats de pourcentage, Looker prend la valeur décimale sous-jacente et la multiplie par 100 pour obtenir un pourcentage. Les exemples suivants commencent par la valeur sous-jacente "0.123456" :

Nom	Exemple
percent_0	12 %
percent_1	12,3 %
percent_2	12,35 %
percent_3	12,346 %
percent_4	12,3456 %

Bon à savoir

Pour appliquer value_format_name à un champ, le paramètre type doit être défini pour ce champ.

Difficultés courantes

Utiliser value_format_name avec l'attribut utilisateur number_format

Si vous utilisez value_format_name pour mettre en forme les champs de vos modèles, le format numérique sélectionné dans l'attribut utilisateur number_format est appliqué en plus du format indiqué avec value_format_name. Pour obtenir un exemple et en savoir plus, consultez la page de documentation Localiser la mise en forme des nombres.