Nome do formato do valor

Uso

view: view_name {
dimensão: field_name {
value_format_name: format_name
}
}
Hierarquia
view
Tipo de campo
value_format_name
Tipos de campo possíveis
Dimensão, medida

Aceita
Um dos formatos de valor padrão listados abaixo ou o nome de um formato que você criou com o parâmetro named_value_format

Definição

O parâmetro value_format_name permite formatar valores de dados usando formatos integrados ao Looker ou seus próprios formatos personalizados e reutilizáveis. Para aplicar um formato do Excel diretamente a um campo exclusivo, use value_format.

O parâmetro value_format_name pode ser usado em dimensões e medidas. Exemplo:

measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format_name: usd
}

Nomes de formato padrão

O Looker tem os formatos padrão mostrados nas tabelas a seguir. Ao usar um dos formatos padrão, o Looker arredonda para cima ou para baixo para remover dígitos, em vez de truncar os valores. Quando um nome de formato padrão é usado em uma medida, o arredondamento ocorre depois da agregação.

Também é possível criar seus próprios formatos nomeados usando o parâmetro named_value_format.

Formatos numéricos

Os formatos padrão para tipos de campos numéricos são mostrados abaixo. Elas começam com o valor "0.123456789":

Nome Exemplo
decimal_0 1.234
decimal_1 1.234,6
decimal_2 1.234,57
decimal_3 1.234,568
decimal_4 1.234,5679
usd_0 US$ 1.234
usd US$ 1.234,57
gbp_0 £ 1.234
gbp £ 1.234,57
eur_0 € 1.234
eur € 1.234,57
id 1234

Para tipos de campo numérico, id só pode ser usado em números com 16 dígitos ou menos. Além de 16 dígitos, id pode arredondar os resultados. Para números com mais de 16 dígitos, faça a conversão deles como uma string e use id no tipo de campo de string.

Formatos de porcentagem

Para formatos de porcentagem, o Looker multiplica o valor decimal por 100 para chegar a uma porcentagem. Os exemplos abaixo começam com o valor "0.123456":

Nome Exemplo
percent_0 12%
percent_1 12,3%
percent_2 12,35%
percent_3 12,346%
percent_4 12,3456%

Informações úteis

Para aplicar value_format_name a um campo, o parâmetro type precisa ser definido para esse campo.

Desafios comuns

Como usar value_format_name com o atributo number_format

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