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 style 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 :

  • Seul, 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 named_value_format paramètre, au niveau du modèle, pour créer un format personnalisé réutilisable qui peut être appliqué à plusieurs champs

Application de value_format directement aux dimensions et aux mesures

Le paramètre value_format peut être utilisé à la fois sur 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 de 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)"
}

Utilisation de value_format pour définir un format personnalisé réutilisable

Pour en savoir plus sur l'utilisation de 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 obtenir des instructions sur l'utilisation de 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 style 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 valeur des visualisations, sauf que le paramètre value_format nécessite que la chaîne de mise en forme soit placée entre guillemets doubles. Pour en savoir plus sur les formats de valeur dans les visualisations, consultez la page de documentation Options des graphiques en colonnes.

Vous pouvez lire le guide complet d'Excel qui explique comment utiliser ces mises en forme dans leur 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.

Voici quelques-unes des options de mise en forme les plus courantes. Notez que certains caractères spéciaux, tels que les symboles monétaires internationaux, doivent être placés entre guillemets doubles.

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 produit lors de l'utilisation de value_format est la façon dont SQL gère les calculs d'entiers. Si vous divisez 5 par 2, la plupart des gens s'attendent à ce que le résultat soit 2,5. Toutefois, de nombreux dialectes SQL ne renvoient que 2, car lorsqu'ils divisent deux entiers, ils donnent é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) afin de 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"
}

Utilisation de value_format avec l'attribut utilisateur number_format

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