formato_de_valor_nomeado

Uso

name_value_format: preferred_name {
value_format: "string de formatação do Excel"
strict_value_format: yes | no
}

Hierarquia Arquivo de modelo named_value_format

Valor padrão Nenhuma Aceita Um nome para o formato personalizado e uma string de formatação no estilo Excel que define o formato e um valor booleano para o subparâmetro opcional strict_value_format.

Definição

Com o parâmetro named_value_format, é possível criar e salvar um formato personalizado que pode ser aplicado a várias dimensões e medidas.

Os formatos personalizados no Looker são criados e usados em várias etapas:

1. Primeiro, use named_value_format no arquivo de modelo para declarar um nome para o novo formato personalizado. Esse nome precisa ser uma string sem espaços.
2. Em seguida, use o subparâmetro value_format em named_value_format para definir a formatação desejada fornecendo uma string de formato no Excel.
3. Por fim, aplique esse formato personalizado às dimensões e medidas referenciando-o no parâmetro value_format_name no nível do campo.

É possível definir mais de um formato personalizado em um modelo, conforme mostrado nos exemplos abaixo.

Strings de formatação comuns do value_format

A formatação usada com o parâmetro value_format é a mesma usada no campo Formato de valor das visualizações, mas o parâmetro value_format exige que a string de formatação esteja entre aspas duplas. Consulte a página de documentação Opções do gráfico de colunas para informações sobre formatos de valores em visualizações.

Leia o guia completo do Excel sobre como especificar esses formatos na documentação. No momento, o formato de data, a formatação de cores e a conversão hexadecimal não são compatíveis com o Looker.

Veja abaixo algumas das opções de formatação mais comuns. Alguns caracteres especiais, como símbolos de moeda internacionais, precisam ser colocados entre aspas duplas.

value_format: "0"             # Integer (123)
value_format: "*00#"          # Integer zero-padded to 3 places (001)
value_format: "0 \" String\"" # Integer followed by a string (123 String)
                              #   Please note "String" can be replaced with any other word

value_format: "0.##"          # Number up to 2 decimals (1. or 1.2 or 1.23)
value_format: "0.00"          # Number with exactly 2 decimals (1.23)
value_format: "*00#.00"       # Number zero-padded to 3 places and exactly 2 decimals (001.23)
value_format: "#,##0"         # Number with comma between thousands (1,234)
value_format: "#,##0.00"      # Number with comma between thousands and 2 decimals (1,234.00)
value_format: "0.000,,\" M\"" # Number in millions with 3 decimals (1.234 M)
                              #   Please note division by 1 million happens automatically
value_format: "0.000,\" K\""  # Number in thousands with 3 decimals (1.234 K)
                              #   Please note division by 1 thousand happens automatically

value_format: "$0"            # Dollars with 0 decimals ($123)
value_format: "$0.00"         # Dollars with 2 decimals ($123.00)
value_format: "\"€\"0"        # Euros with 0 decimals (€123)
value_format: "$#,##0.00"     # Dollars with comma btwn thousands and 2 decimals ($1,234.00)
value_format: "$#.00;($#.00)" # Dollars with 2 decimals, positive values displayed
                              #   normally, negative values wrapped in parenthesis

value_format: "0\%"           # Display as percent with 0 decimals (1 becomes 1%)
value_format: "0.00\%"        # Display as percent with 2 decimals (1 becomes 1.00%)
value_format: "0%"            # Convert to percent with 0 decimals (.01 becomes 1%)
value_format: "0.00%"         # Convert to percent with 2 decimals (.01 becomes 1.00%)

strict_value_format substitui o atributo de usuário number_format.

Normalmente, a formatação de números definida no atributo de usuário number_format é aplicada sobre o formato criado com named_value_format. No entanto, se você definir o subparâmetro strict_number_format opcional como yes, a formatação de number_format não será aplicada e os campos vão manter a formatação de named_value_format. Para ver um exemplo e saber mais, acesse a página de documentação Como formatar a formatação de números.

Opções de formatação padrão

Se você preferir aplicar um dos formatos de valor integrados do Looker, escolha entre os formatos listados na seção Nomes de formato padrão da página de documentação do parâmetro value_format_name. Consulte esta página para ver instruções sobre como usar o value_format_name para aplicar formatos integrados.

Examples

Crie um formato personalizado com o nome euro_in_thousands semelhante a € 1,23 mil:

named_value_format: euro_in_thousands {
  value_format: "\"€\"0.000,\" K\""
}

Evite que o atributo de usuário number_formatting afete o formato euro_in_thousands:

named_value_format: euro_in_thousands {
  value_format: "\"€\"0.000,\" K\""
  strict_value_format: yes
}

Consulte também a página de documentação Como formatar a formatação de números para ver outro exemplo.

Crie um formato personalizado com o nome usd_in_millions, que tem o formato US$1,23 milhão, e um formato chamado phone_number, com aparência de [phone]:

named_value_format: usd_in_millions {
  value_format: "$0.000,,\" M\""
}
named_value_format: phone_number {
  value_format: "(###) ###-####"
}