named_value_format

Utilisation

named_value_format: desired_name {
  value_format: "excel formatting string"
  strict_value_format: yes | no
}

Hiérarchie Fichier de modèle named_value_format

Valeur par défaut Aucun Acceptation Nom de votre format personnalisé, plus une chaîne de mise en forme de style Excel qui définit le format et une 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 :

1. Tout d'abord, vous utilisez named_value_format dans votre fichier de modèle pour déclarer un nom pour votre nouveau format personnalisé. Ce nom doit être une chaîne sans espace.
2. Ensuite, vous utilisez le value_format sous-paramètre sous named_value_format pour définir la mise en forme souhaitée en fournissant une chaîne de format de style Excel.
3. Enfin, appliquez ce format personnalisé aux dimensions et aux mesures en le référençant dans le value_format_name paramètre au niveau du champ.

Vous pouvez définir plusieurs formats personnalisés dans un modèle, comme illustré dans les exemples suivants.

Chaînes de mise en forme value_format courantes

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 de graphique 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.

Vous trouverez ci-dessous quelques-unes des options de mise en forme les plus courantes. 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)
                              #   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 règle générale, la mise en forme des nombres définie dans l'attribut utilisateur number_format est appliquée en plus du 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 en savoir plus, consultez la page de documentation Localiser la mise en forme 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 parmi les formats listés dans la section Noms de format 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.

Exemples

Créez un format personnalisé appelé euro_in_thousands qui ressemble à 1,23 K € :

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
}

Consultez également la page de documentation Localiser la mise en forme des nombres pour obtenir un autre exemple.

Créez un format personnalisé appelé usd_in_millions qui ressemble à 1,23 M$ et un format appelé phone_number qui ressemble à [phone] :

named_value_format: usd_in_millions {
  value_format: "$0.000,,\" M\""
}
named_value_format: phone_number {
  value_format: "(###) ###-####"
}