Uso
dimensão: field_name {
value_format:"$#.00;($#.00)"
}
}
Hierarquia
value_format |
Tipos de campo possíveis
Dimensão, medidaAceita
Uma string que contém formatação do Excel |
Definição
O parâmetro value_format
permite formatar valores de dados no Looker usando formatos Excel. É possível usar value_format
das seguintes maneiras:
- Por conta própria, no nível do campo, para aplicar a formatação no estilo Excel diretamente a uma dimensão ou medida 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
Aplicando value_format
diretamente às dimensões e medidas
O parâmetro value_format
pode ser usado em dimensões e medidas. Para aplicar a formatação no estilo Excel às dimensões por value_format
, o tipo de dimensão precisa ser number
. Para aplicar a formatação no estilo Excel às medidas por value_format
, verifique se a medida é numérica e não 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 você 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 esta página para ver instruções sobre como usar o value_format_name
para aplicar formatos integrados.
Strings de formatação comuns
value_format
aceita uma string de formatação no estilo Excel.
A formatação usada com o parâmetro
value_format
é a mesma usada no campo Formato de valor das visualizações, mas o parâmetrovalue_format
exige que a string de formatação esteja entre aspas duplas. Consulte a página de documentação Opções do 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 momento, o formato de data, a formatação de cores e a conversão hexadecimal não são compatíveis com o Looker.
Algumas das opções de formatação mais comuns são mostradas aqui. Alguns caracteres especiais, como símbolos de moeda 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 ver um exemplo de formatação condicional mais avançada com o parâmetro value_format
, consulte o artigo Formatação condicional usando value_format
da Central de Ajuda.
Desafios comuns
Decimais perdidos na divisão
Uma característica SQL comum que surge ao usar o value_format
é a maneira como o SQL lida com matemática de números inteiros. Se você dividir 5 por 2, a maioria das pessoas esperará que o resultado seja 2,5. No entanto, muitos dialetos SQL retornam o resultado como apenas dois, porque quando ele divide dois números inteiros, ele também fornece o resultado como um número inteiro. Para resolver isso, você pode multiplicar 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"
}
Como usar value_format
com o atributo 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 Como formatar a formatação de números.