nom_format_valeur

Utilisation

view: view_name {
  dimension: field_name {
    value_format_name: format_name
  }
}
Hiérarchie
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 value_format plutôt.

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

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

Noms de format 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 pour supprimer les chiffres, plutôt que de les tronquer. Lorsqu'un nom de format par défaut est utilisé sur une mesure, l'arrondi est effectué après l'agrégation de la mesure.

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

Formats numériques

Les formats par défaut pour les 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 sur 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 type paramètre doit être défini pour ce champ.

Difficultés courantes

Utilisation de value_format_name avec l'attribut utilisateur number_format

Si vous utilisez value_format_name pour mettre en forme des champs dans 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 Localisation de la mise en forme des nombres.