Uso
view: view_name {
dimension: field_name {
value_format_name: format_name
}
}
|
Hierarquia
value_format_name |
Tipos de campo possíveis
Dimensão, métrica
Aceita
Um dos formatos de valor padrão listados nesta página de documentação ou o nome de um formato criado com o parâmetro named_value_format.
|
Definição
Com o parâmetro value_format_name, é possível formatar valores de dados usando formatos integrados ao Looker ou seus próprios formatos personalizados e reutilizáveis. Se quiser aplicar um formato no estilo 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 valores. Quando um nome de formato padrão é usado em uma métrica, o arredondamento ocorre depois que a métrica é agregada.
Também é possível criar 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 na tabela a seguir. Eles começam com o valor "1234.56789":
| Nome | Exemplo |
|---|---|
decimal_0 |
1,235 |
decimal_1 |
1.234,6 |
decimal_2 |
1.234,57 |
decimal_3 |
1.234,568 |
decimal_4 |
1.234,5679 |
usd_0 |
US$ 1.235 |
usd |
US$ 1.234,57 |
gbp_0 |
£1.235 |
gbp |
£ 1.234,57 |
eur_0 |
€ 1.235 |
eur |
€ 1.234,57 |
id |
1235 |
Para tipos de campos numéricos,
idsó deve ser usado em números com 16 dígitos ou menos. Além de 16 dígitos, oidpode arredondar os resultados. Para números com mais de 16 dígitos, faça a conversão como uma string e useidno tipo de campo de string.
Formatos de porcentagem
Para formatos de porcentagem, o Looker usa o valor decimal subjacente e o multiplica por 100 para obter uma porcentagem. Os exemplos a seguir 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 importantes
Para aplicar value_format_name a um campo, o parâmetro type precisa ser definido para ele.
Desafios comuns
Usar value_format_name com o atributo de usuário number_format
Se você usar value_format_name para formatar campos nos seus modelos, o formato de número selecionado no atributo do usuário number_format será aplicado sobre o formato fornecido com value_format_name. Para um exemplo e mais informações, consulte a página de documentação Localizar formatação de números.