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 você quiser aplicar um formato no estilo do Excel diretamente a um campo único, 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 até 16 dígitos. Acima disso,idpode arredondar os resultados. Para números com mais de 16 dígitos, converta-os 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.