Uso
view: view_name {
dimension: field_name {
value_format_name: format_name
}
}
|
Hierarquia
value_format_name |
Tipos de campo possíveis
Dimensão, medida
Aceita
Um dos formatos de valor padrão listados nesta página de documentação ou o nome de um formato criado com o named_value_format parâmetro
|
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. Se você quiser aplicar um formato no estilo Excel diretamente a um campo exclusivo, use value_format em vez disso.
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 medida, o arredondamento ocorre depois que a medida é agregada.
Você também pode criar seus próprios formatos nomeados usando o named_value_format parâmetro.
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 subjacente "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 |
$1.235 |
usd |
$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 que tenham 16 dígitos ou menos. Além de 16 dígitos,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 gerar uma porcentagem. Os exemplos a seguir começam com o valor subjacente "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 esse campo.
Desafios comuns
Como 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 de usuário number_format será aplicado ao formato fornecido com value_format_name. Para conferir um exemplo e saber mais, consulte a página de documentação Localizar a formatação de números.