named_value_format

Uso

named_value_format: desired_name {
  value_format: "excel formatting string"
  strict_value_format: yes | no
}

Hierarquia Arquivo de modelo named_value_format

Valor padrão Nenhum Aceita Um nome para seu formato personalizado, além de uma string de formatação no estilo do 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 métricas.

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. O 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 estilo do Excel.
3. Por fim, aplique esse formato personalizado a dimensões e métricas fazendo referência a ele 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 a seguir.

Strings de formatação value_format comuns

A formatação usada com o parâmetro value_format é a mesma usada no campo Formato do valor em visualizações, exceto que o parâmetro value_format exige que a string de formatação seja colocada entre aspas duplas. Consulte a página de documentação Opções de 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 entanto, no momento, a formatação de data e cor e a conversão hexadecimal não são compatíveis com o Looker.

Confira algumas das opções de formatação mais comuns. Alguns caracteres especiais, como símbolos de moedas internacionais, precisam estar 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 do usuário number_format

Normalmente, a formatação de número 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 opcional strict_number_format 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 Localizar formatação de números.

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

Se 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 essa página para instruções sobre como usar value_format_name para aplicar formatos integrados.

Exemplos

Crie um formato personalizado chamado euro_in_thousands que tenha esta aparência: €1.23K:

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 Localização da formatação de números para outro exemplo.

Crie um formato personalizado chamado usd_in_millions que se pareça com US$1,23M e um formato chamado phone_number que se pareça com [phone]:

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