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 mais 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

O parâmetro named_value_format permite 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 modelo para declarar um nome para o novo formato personalizado. Esse nome precisa ser uma string sem espaços.
2. Em seguida, use o value_format subparâmetro 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 medidas referenciando-o no value_format_name parâmetro 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 nas 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 valor em visualizações.

Você pode ler 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.

A seguir, mostramos 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 do usuário number_format

Normalmente, a formatação de número definida no number_format atributo do usuário é 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 conferir 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 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 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 se pareça com €1,23 mil:

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

Impeça que o atributo do 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 Localizar formatação de números para outro exemplo.

Crie um formato personalizado chamado usd_in_millions que se pareça com US$1,23 milhões 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: "(###) ###-####"
}