named_value_format

Uso

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

Jerarquía Archivo del modelo named_value_format

Valor predeterminado Ninguno Acepta Un nombre para tu formato personalizado, además de una cadena de formato de estilo Excel que define el formato y un valor booleano para el subparámetro strict_value_format opcional

Definición

El parámetro named_value_format te permite crear y guardar un formato personalizado que se puede aplicar a varias dimensiones y medidas.

Los formatos personalizados en Looker se crean y usan en varios pasos:

1. Primero, usa named_value_format en tu archivo de modelo para declarar un nombre para tu nuevo formato personalizado. Este nombre debe ser una cadena sin espacios.
2. A continuación, usa el subparámetro value_format en named_value_format para definir el formato que deseas proporcionando una cadena de formato de estilo Excel.
3. Por último, aplica este formato personalizado a las dimensiones y las métricas haciendo referencia a él en el parámetro value_format_name a nivel del campo.

Puedes definir más de un formato personalizado en un modelo, como se muestra en los siguientes ejemplos.

Cadenas de formato value_format comunes

El formato que se usa con el parámetro value_format es el mismo que se usa en el campo Formato de valor de las visualizaciones, excepto que el parámetro value_format requiere que la cadena de formato se incluya entre comillas dobles. Consulta la página de documentación Opciones de gráficos de columnas para obtener información sobre los formatos de valores en las visualizaciones.

Puedes leer la guía completa de Excel sobre cómo especificar estos formatos en su documentación. Sin embargo, en este momento, Looker no admite el formato de fecha, el formato de color ni la conversión hexadecimal.

A continuación, se muestran algunas de las opciones de formato más comunes. Algunos caracteres especiales, como los símbolos de monedas internacionales, deben estar entre comillas dobles.

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 anula el atributo de usuario number_format

Por lo general, el formato de número establecido en el atributo de usuario number_format se aplica sobre el formato creado con named_value_format. Sin embargo, si configuras el subparámetro opcional strict_number_format como yes, no se aplicará el formato de number_format y los campos conservarán el formato de named_value_format. Para ver un ejemplo y obtener más información, visita la página de documentación Localizing number formatting.

Opciones de formato predeterminadas

Si prefieres aplicar uno de los formatos de valores integrados de Looker, puedes elegir entre los formatos que se enumeran en la sección Nombres de formato predeterminados de la página de documentación del parámetro value_format_name. Consulta esa página para obtener instrucciones sobre cómo usar value_format_name para aplicar formatos integrados.

Ejemplos

Crea un formato personalizado llamado euro_in_thousands que se vea como $1,230:

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

Para evitar que el atributo de usuario number_formatting afecte el formato de euro_in_thousands, haz lo siguiente:

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

Consulta también la página de documentación Localización del formato de números para ver otro ejemplo.

Crea un formato personalizado llamado usd_in_millions que se vea como USD 1.23 millones y un formato llamado phone_number que se vea como [phone]:

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