Utilizzo
dimension: field_name {
value_format:"$#.00;($#.00)"
}
}
Gerarchia
value_format |
Tipi di campi possibili
Dimensione, misuraAccetta
Una stringa contenente una formattazione di tipo Excel |
Definizione
Il parametro value_format
consente di formattare i valori dei dati in Looker utilizzando formati di stile Excel. Puoi utilizzare value_format
nei seguenti modi:
- A livello di campo, per applicare automaticamente la formattazione in stile Excel a una dimensione o a una misurazione specifica
- Come parametro secondario del parametro
named_value_format
, a livello di modello, per creare un formato personalizzato riutilizzabile applicabile a più campi
Applicazione diretta di value_format
a dimensioni e misure
Il parametro value_format
può essere utilizzato sia nelle dimensioni che nelle misure. Per applicare la formattazione in stile Excel alle dimensioni tramite value_format
, il tipo di dimensione deve essere number
. Per applicare la formattazione in stile Excel alle misure tramite value_format
, assicurati che la misura sia numerica e non sia type: string
. Ad esempio:
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)"
}
value_format
per definire un formato personalizzato riutilizzabile
Per informazioni sull'utilizzo di value_format
con named_value_format
per definire i formati riutilizzabili, consulta la pagina della documentazione del parametro named_value_format
.
Opzioni di formattazione predefinite
Se preferisci applicare uno dei formati di valori integrati di Looker, puoi scegliere uno dei formati elencati nella sezione Default Format Names (Nomi formati predefiniti) della pagina della documentazione del parametro value_format_name
. Consulta la pagina per le istruzioni sull'utilizzo di value_format_name
per applicare i formati integrati.
Stringhe di formattazione comuni
value_format
accetta una stringa di formattazione di tipo Excel.
La formattazione utilizzata con il parametro
value_format
è la stessa utilizzata nel campo Formato valore nelle visualizzazioni, tranne per il fatto che il parametrovalue_format
richiede che la stringa di formattazione sia racchiusa tra virgolette doppie. Per informazioni sui formati di 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 loro documentazione. Tuttavia, al momento, la formattazione della data, la formattazione del colore e la conversione esadecimale non sono supportate in Looker.
Alcune delle opzioni di formattazione più comuni sono mostrate qui. Tieni presente che alcuni caratteri speciali, come i simboli di valuta internazionale, 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)
# 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%)
Per un esempio di formattazione condizionale più avanzata con il parametro value_format
, consulta l'articolo del Centro assistenza Formattazione condizionale con value_format
.
Sfide comuni
Perdita di decimali durante la divisione
Un'eccentricità comune che si verifica quando si utilizza value_format
è il modo in cui SQL gestisce la matematica insieme a un numero intero. Se dividi 5 per 2, la maggior parte delle persone si aspetta che il risultato sia 2,5. Tuttavia, molti dialetti SQL restituiranno il risultato come solo 2, perché quando divide due numeri interi, viene restituito anche un numero intero. Per risolvere questo problema, puoi moltiplicare il numeratore per un numero decimale (come 1,0 o 100,0) per forzare SQL a restituire un risultato decimale. Ad esempio:
measure: active_users_percent {
type: number
sql: 100.000 * ${active_users} / ${users} ;;
value_format: "0.000"
}
Utilizzare value_format
con l'attributo utente number_format
Se utilizzi value_format
per formattare i campi nei modelli, il formato numerico selezionato nell'attributo utente number_format
viene applicato al formato applicato con value_format
. Per un esempio, per saperne di più, consulta la pagina Documentazione di Formattazione della localizzazione.