Uso
dimensão: field_name {
value_format_name: format_name
}
}
Hierarquia
value_format_name |
Tipos de campo possíveis
Dimensão, medidaAceita
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 useid
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.