formato do valor

Uso

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

Aceita
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âmetro value_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.