named_value_format

Utilizzo

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

Gerarchia File del modello named_value_format

Valore predefinito Nessuno Accetta Un nome per il formato personalizzato più una stringa di formattazione in stile Excel che definisce il formato e un valore booleano per il sottoparametro facoltativo strict_value_format

Definizione

Il parametro named_value_format consente di creare e salvare un formato personalizzato che può essere applicato a più dimensioni e misure.

I formati personalizzati in Looker vengono creati e utilizzati in diversi passaggi:

1. Innanzitutto, utilizza named_value_format nel file del modello per dichiarare un nome per il nuovo formato personalizzato. Questo nome deve essere una stringa senza spazi.
2. Poi, utilizza il value_format sottoparametro in named_value_format per definire la formattazione desiderata fornendo una stringa di formato in stile Excel.
3. Infine, applica questo formato personalizzato a dimensioni e misure facendo riferimento al parametro value_format_name a livello di campo.

Puoi definire più di un formato personalizzato in un modello, come mostrato negli esempi seguenti.

Stringhe di formattazione value_format comuni

La formattazione utilizzata con il parametro value_format è la stessa utilizzata nel campo Formato valore nelle visualizzazioni, tranne per il fatto che il parametlo value_format richiede che la stringa di formattazione sia racchiusa tra virgolette doppie. Per informazioni sui formati dei valori nelle visualizzazioni, consulta la pagina della documentazione Opzioni del grafico a colonne.

Puoi leggere la guida completa di Excel su come specificare questi formati nella documentazione. Tuttavia, al momento, la formattazione della data, la formattazione del colore e la conversione esadecimale non sono supportate in Looker.

Di seguito sono riportate alcune delle opzioni di formattazione più comuni. Alcuni caratteri speciali, come i simboli di valuta internazionali, devono essere racchiusi tra virgolette doppie.

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 esegue l'override dell'attributo utente number_format

In genere, la formattazione dei numeri impostata nell'attributo utente number_format viene applicata in aggiunta al formato creato con named_value_format. Tuttavia, se imposti il sottoparametro facoltativo strict_number_format su yes, la formattazione di number_format non verrà applicata e i campi manterranno la formattazione di named_value_format. Per un esempio e per saperne di più, consulta la pagina della documentazione Localizzazione della formattazione dei numeri.

Opzioni di formattazione predefinite

Se preferisci applicare uno dei formati dei valori integrati di Looker, puoi scegliere tra i formati elencati nella sezione Nomi dei formati predefiniti della pagina della documentazione del parametro value_format_name. Consulta questa pagina per istruzioni sull'utilizzo di value_format_name per applicare i formati integrati.

Esempi

Crea un formato personalizzato denominato euro_in_thousands che abbia l'aspetto di €1.23K:

named_value_format: euro_in_thousands {
  value_format: "\"€\"0.000,\" K\""
}

Impedisci all'attributo utente number_formatting di influire sul formato euro_in_thousands:

named_value_format: euro_in_thousands {
  value_format: "\"€\"0.000,\" K\""
  strict_value_format: yes
}

Per un altro esempio, consulta anche la pagina della documentazione Localizzazione della formattazione dei numeri.

Crea un formato personalizzato denominato usd_in_millions che abbia l'aspetto di $1.23M e un formato denominato phone_number che abbia l'aspetto di [phone]:

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