value_format

Utilisation

view: view_name {
  dimension: field_name {
    value_format:"$#.00;($#.00)"
  }
}
Hiérarchie
view
Type de champ
value_format
Types de champs possibles
Dimension, Mesure

Acceptation
Chaîne contenant une mise en forme de type Excel

Définition

Le paramètre value_format vous permet de mettre en forme les valeurs de données dans Looker à l'aide de formats de style Excel. Vous pouvez utiliser value_format de différentes manières :

  • Au niveau du champ, pour appliquer une mise en forme de style Excel directement à une dimension ou une mesure spécifique
  • En tant que sous-paramètre du paramètre named_value_format, au niveau du modèle, pour créer un format personnalisé réutilisable qui peut être appliqué à plusieurs champs

Appliquer value_format directement aux dimensions et aux mesures

Le paramètre value_format peut être utilisé à la fois pour les dimensions et les mesures. Pour appliquer une mise en forme de style Excel aux dimensions via value_format, le type de dimension doit être number. Pour appliquer une mise en forme de style Excel aux mesures via value_format, assurez-vous que la mesure est numérique et non type: string. Exemple :

dimension: order_amount {
  type: number
  sql: ${TABLE}.order_amount ;;
  value_format: "$#.00;($#.00)"
}
measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format: "$#.00;($#.00)"
}

Utiliser value_format pour définir un format personnalisé réutilisable

Pour savoir comment utiliser value_format avec named_value_format afin de définir des formats réutilisables, consultez la page de documentation du paramètre named_value_format.

Options de mise en forme par défaut

Si vous préférez appliquer l'un des formats de valeur intégrés de Looker, vous pouvez choisir parmi les formats listés dans la section Noms de formats par défaut de la page de documentation du paramètre value_format_name. Consultez cette page pour savoir comment utiliser value_format_name afin d'appliquer des formats intégrés.

Chaînes de mise en forme courantes

value_format accepte une chaîne de mise en forme de type Excel.

La mise en forme utilisée avec le paramètre value_format est la même que celle utilisée dans le champ Format de la valeur des visualisations, à la différence que le paramètre value_format exige que la chaîne de mise en forme soit placée entre guillemets doubles. Pour en savoir plus sur les formats de valeurs dans les visualisations, consultez la page de documentation Options du graphique à barres.

Pour savoir comment spécifier ces formats, consultez le guide complet d'Excel dans sa documentation. Néanmoins, la mise en forme des dates, des couleurs et la conversion hexadécimale ne sont pas prises en charge dans Looker pour le moment.

Certaines des options de mise en forme les plus courantes sont affichées ici. Notez que certains caractères spéciaux, tels que les symboles monétaires internationaux, doivent être placés entre guillemets.

value_format: "0"             # Integer (123)
value_format: "*00#"          # Integer zero-padded to 3 places (001)
value_format: "0 \" String\"" # Integer followed by a string (123 String)
                              #   Note \"String\" can be replaced with any other word

value_format: "0.##"          # Number up to 2 decimals (1. or 1.2 or 1.23)
value_format: "0.00"          # Number with exactly 2 decimals (1.23)
value_format: "*00#.00"       # Number zero-padded to 3 places and exactly 2 decimals (001.23)
value_format: "#,##0"         # Number with comma between thousands (1,234)
value_format: "#,##0.00"      # Number with comma between thousands and 2 decimals (1,234.00)
value_format: "0.000,,\" M\"" # Number in millions with 3 decimals (1.234 M)
                              #   Note division by 1 million happens automatically
value_format: "0.000,\" K\""  # Number in thousands with 3 decimals (1.234 K)
                              #   Note division by 1 thousand happens automatically

value_format: "$0"            # Dollars with 0 decimals ($123)
value_format: "$0.00"         # Dollars with 2 decimals ($123.00)
value_format: "\"€\"0"        # Euros with 0 decimals (€123)
value_format: "$#,##0.00"     # Dollars with comma btwn thousands and 2 decimals ($1,234.00)
value_format: "$#.00;($#.00)" # Dollars with 2 decimals, positive values displayed
                              #   normally, negative values wrapped in parenthesis

value_format: "0\%"           # Display as percent with 0 decimals (1 becomes 1%)
value_format: "0.00\%"        # Display as percent with 2 decimals (1 becomes 1.00%)
value_format: "0%"            # Convert to percent with 0 decimals (.01 becomes 1%)
value_format: "0.00%"         # Convert to percent with 2 decimals (.01 becomes 1.00%)

Pour obtenir un exemple de mise en forme conditionnelle plus avancée avec le paramètre value_format, consultez la page Bonnes pratiques concernant la mise en forme conditionnelle à l'aide de value_format.

Difficultés courantes

Perte de décimales lors d'une division

L'une des particularités courantes de SQL qui se présente lors de l'utilisation de value_format est la façon dont SQL gère les calculs sur les nombres entiers. Si vous divisez 5 par 2, la plupart des gens s'attendent à obtenir 2,5. Toutefois, de nombreux dialectes SQL renverront le résultat 2, car lorsqu'il divise deux entiers, il renvoie également le résultat sous forme d'entier. Pour résoudre ce problème, vous pouvez multiplier le numérateur par un nombre décimal (comme 1,0 ou 100,0) pour forcer SQL à renvoyer un résultat décimal. Exemple :

measure: active_users_percent {
  type: number
  sql: 100.000 * ${active_users} / ${users} ;;
  value_format: "0.000"
}

Utiliser value_format avec l'attribut utilisateur number_format

Si vous utilisez value_format 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 appliqué avec value_format. Pour obtenir un exemple et en savoir plus, consultez la page de documentation Localiser la mise en forme des nombres.