value_format

Utilizzo

view: view_name {
  dimension: field_name {
    value_format:"$#.00;($#.00)"
  }
}
Gerarchia
view
Tipo di campo
value_format
Tipi di campi possibili
Dimensione, Misura

Accetta
Una stringa contenente la formattazione in stile Excel

Definizione

Il parametro value_format consente di formattare i valori dei dati in Looker utilizzando formati in stile Excel. Puoi utilizzare value_format nei seguenti modi:

  • Da sola, a livello di campo, per applicare la formattazione in stile Excel direttamente a una dimensione o una misura specifica
  • Come sottoparametro del parametro named_value_format, a livello di modello, per creare un formato personalizzato riutilizzabile che può essere applicato a più campi

Applicazione di value_format direttamente a dimensioni e misure

Il parametro value_format può essere utilizzato sia per le dimensioni sia per le 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 metriche tramite value_format, assicurati che la metrica sia numerica e non di tipo 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)"
}

Utilizzo di value_format per definire un formato personalizzato riutilizzabile

Per informazioni sull'utilizzo di value_format con named_value_format per definire formati riutilizzabili, consulta la pagina della documentazione del parametro named_value_format.

Opzioni di formattazione predefinite

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

Stringhe di formattazione comuni

value_format accetta una stringa di formattazione in stile Excel.

La formattazione utilizzata con il parametro value_format è la stessa utilizzata nel campo Formato valore nelle visualizzazioni, tranne per il fatto che il parametro 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. Tieni presente che 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)
                              #   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 la pagina delle best practice Formattazione condizionale con value_format.

Sfide comuni

Perdita di decimali durante la divisione

Una particolarità comune di SQL che si verifica quando si utilizza value_format è il modo in cui SQL gestisce la matematica degli interi. Se dividi 5 per 2, la maggior parte delle persone si aspetta che il risultato sia 2,5. Tuttavia, molti dialetti SQL restituiscono il risultato come 2, perché quando divide due numeri interi, il risultato è un numero intero. Per risolvere questo problema, puoi moltiplicare il numeratore per un numero decimale (ad esempio 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 sopra il formato applicato con value_format. Per un esempio e per saperne di più, visita la pagina della documentazione Localizzazione della formattazione dei numeri.