format_valeur

Utilisation

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 type Excel. Vous pouvez utiliser value_format de différentes manières:

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

Application directe de value_format 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 l'un des formats répertoriés dans la section Noms de format par défaut de la page de documentation du paramètre value_format_name. Pour savoir comment appliquer des formats intégrés, consultez value_format_name.

Chaînes de mise en forme courantes

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

Le format utilisé avec le paramètre value_format est identique à celui utilisé dans le champ Format de la valeur dans les visualisations, sauf 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 valeur utilisés dans les visualisations, consultez la page de documentation Options des graphiques à colonnes.

Vous pouvez lire le guide complet d'Excel pour savoir comment spécifier ces formats 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.

Les options de mise en forme les plus courantes sont présentées ici. Notez que certains caractères spéciaux (comme les symboles de devise internationale) 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 l'article Mise en forme conditionnelle avec value_format dans le centre d'aide.

Difficultés courantes

Perte de décimales lors de la division

L'une des particularités SQL courantes dans l'utilisation de value_format est la manière dont SQL gère les mathématiques entières. Si vous divisez 5 par 2, la plupart des utilisateurs s'attendent à ce que le résultat soit 2,5. Cependant, de nombreux dialectes SQL renvoient le résultat avec une valeur de 2 seulement, car lorsqu'il divise deux entiers, il donne é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 (1,0 ou 100,0, par exemple) afin d'obliger 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 des champs dans vos modèles, le format numérique sélectionné dans l'attribut utilisateur number_format est appliqué au format appliqué avec value_format. Pour obtenir un exemple et obtenir plus d'informations, consultez la page de documentation sur la localisation des nombres.