value_format

Uso

view: view_name {
  dimension: field_name {
    value_format:"$#.00;($#.00)"
  }
}
Hierarquia
view
Tipo de campo
value_format
Tipos de campo possíveis
Dimensão, métrica

Aceita
Uma string que contém formatação no estilo do Excel

Definição

Com o parâmetro value_format, é possível formatar valores de dados no Looker usando formatos no estilo do Excel. É possível usar o value_format das seguintes maneiras:

  • Sozinha, no nível do campo, para aplicar a formatação no estilo do Excel diretamente a uma dimensão ou métrica específica
  • Como um subparâmetro do parâmetro named_value_format, no nível do modelo, para criar um formato personalizado reutilizável que pode ser aplicado a vários campos

Aplicar value_format diretamente a dimensões e métricas

O parâmetro value_format pode ser usado em dimensões e medidas. Para aplicar a formatação do Excel às dimensões usando value_format, o tipo de dimensão precisa ser number. Para aplicar a formatação do Excel às medidas usando value_format, verifique se a medida é numérica e não do tipo type: string. Exemplo:

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)"
}

Como usar value_format para definir um formato personalizado reutilizável

Para informações sobre como usar value_format com named_value_format para definir formatos reutilizáveis, consulte a página de documentação do parâmetro named_value_format.

Opções de formatação padrão

Se preferir aplicar um dos formatos de valor integrados do Looker, escolha entre os formatos listados na seção Nomes de formato padrão da página de documentação do parâmetro value_format_name. Consulte essa página para instruções sobre como usar value_format_name para aplicar formatos integrados.

Strings de formatação comuns

A função value_format aceita uma string de formatação no estilo do Excel.

A formatação usada com o parâmetro value_format é a mesma usada no campo Formato do valor em visualizações, exceto que o parâmetro value_format exige que a string de formatação seja colocada entre aspas duplas. Consulte a página de documentação Opções de gráfico de colunas para informações sobre formatos de valores em visualizações.

Leia o guia completo do Excel sobre como especificar esses formatos na documentação. No entanto, no momento, a formatação de data e cor e a conversão hexadecimal não são compatíveis com o Looker.

Confira algumas das opções de formatação mais comuns. Alguns caracteres especiais, como símbolos de moedas internacionais, precisam ser colocados entre aspas duplas.

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%)

Para um exemplo de formatação condicional mais avançada com o parâmetro value_format, consulte a página de práticas recomendadas Formatação condicional usando value_format.

Desafios comuns

Perda de casas decimais ao dividir

Uma peculiaridade comum do SQL que surge ao usar value_format é a maneira como o SQL processa cálculos com números inteiros. Se você dividir 5 por 2, a maioria das pessoas espera que o resultado seja 2,5. No entanto, muitos dialetos SQL retornam o resultado como apenas 2, porque, ao dividir dois números inteiros, o resultado também é um número inteiro. Para resolver isso, multiplique o numerador por um número decimal (como 1,0 ou 100,0) para forçar o SQL a retornar um resultado decimal. Exemplo:

measure: active_users_percent {
  type: number
  sql: 100.000 * ${active_users} / ${users} ;;
  value_format: "0.000"
}

Usar value_format com o atributo de usuário number_format

Se você usar value_format para formatar campos nos seus modelos, o formato de número selecionado no atributo de usuário number_format será aplicado sobre o formato aplicado com value_format. Para ver um exemplo e saber mais, acesse a página de documentação Localizar formatação de números.