valeur_format_nom

Utilisation

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
Un des formats de valeur par défaut répertoriés ci-dessous, 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 de données à l'aide de formats intégrés à Looker ou de vos propres formats personnalisés réutilisables. Si vous souhaitez appliquer un format 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
}

Noms de format par défaut

Looker présente les formats par défaut présentés dans les tableaux suivants. Lorsque vous utilisez l'un des formats par défaut, Looker arrondit à la valeur supérieure ou inférieure afin de supprimer les chiffres, plutôt que de tronquer les valeurs. Lorsqu'un nom de format par défaut est utilisé sur une mesure, les arrondis sont effectués une fois que la mesure a été agrégée.

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 présentés ci-dessous. Elles commencent par la valeur sous-jacente "0.123456789" :

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

Pour les types de champs numériques, id ne doit être utilisé que sur des nombres comportant 16 chiffres ou moins. Au-delà de 16 chiffres, id peut arrondir les résultats. Pour les nombres contenant plus de 16 chiffres, convertissez-les en chaîne et utilisez id sur le type de champ "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 ci-dessous 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 des champs dans vos modèles, le format numérique sélectionné dans l'attribut utilisateur number_format est appliqué au format fourni avec value_format_name. Pour obtenir un exemple et connaître la procédure à suivre, consultez la page de documentation sur la localisation des nombres.