Utilisation
format_valeur: "chaîne de mise en forme excel"
strict_valeur_format: oui | non
}
Hiérarchie
named_value_format |
Valeur par défaut
AucunAcceptation
Nom du format personnalisé, chaîne de mise en forme de type Excel définissant le format et valeur booléenne pour le sous-paramètre facultatif strict_value_format
|
Définition
Le paramètre named_value_format
vous permet de créer et d'enregistrer un format personnalisé qui peut être appliqué à plusieurs dimensions et mesures.
Les formats personnalisés dans Looker sont créés et utilisés en plusieurs étapes:
- Tout d'abord, utilisez
named_value_format
dans le fichier de modèle pour déclarer un nom pour votre nouveau format personnalisé. Ce nom doit être une chaîne sans espaces. - Ensuite, utilisez le sous-paramètre
value_format
sousnamed_value_format
pour définir la mise en forme souhaitée en fournissant une chaîne de format de type Excel. - Enfin, appliquez ce format personnalisé aux dimensions et aux mesures en le référençant dans le paramètre
value_format_name
au niveau du champ.
Vous pouvez définir plusieurs formats personnalisés dans un modèle, comme illustré dans les exemples ci-dessous.
Chaînes de mise en forme value_format
courantes
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ètrevalue_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.
Certaines des options de mise en forme les plus courantes sont affichées ci-dessous. Certains caractères spéciaux, tels que les symboles 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)
# Please 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)
# Please note division by 1 million happens automatically
value_format: "0.000,\" K\"" # Number in thousands with 3 decimals (1.234 K)
# Please 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%)
strict_value_format
remplace l'attribut utilisateur number_format
En général, le format numérique défini dans l'attribut utilisateur number_format
est appliqué au format créé avec named_value_format
. Toutefois, si vous définissez le sous-paramètre facultatif strict_number_format
sur yes
, la mise en forme de number_format
ne sera pas appliquée et les champs conserveront la mise en forme de named_value_format
. Pour obtenir un exemple et obtenir plus d'informations, consultez la page de documentation sur la localisation des nombres.
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
.
Examples
Créez un format personnalisé appelé euro_in_thousands
qui ressemble à 1,23 €:
named_value_format: euro_in_thousands {
value_format: "\"€\"0.000,\" K\""
}
Empêchez l'attribut utilisateur number_formatting
d'affecter le format euro_in_thousands
:
named_value_format: euro_in_thousands {
value_format: "\"€\"0.000,\" K\""
strict_value_format: yes
}
Pour voir un autre exemple, consultez la page sur la localisation de la mise en forme des nombres.
Créez un format personnalisé appelé usd_in_millions
(1,23 M$) et un format phone_number
((123) 456 7890) :
named_value_format: usd_in_millions {
value_format: "$0.000,,\" M\""
}
named_value_format: phone_number {
value_format: "(###) ###-####"
}