valor_formato

Uso

view: view_name {
dimension: field_name {
value_format:"$#.00;($#.00)"
}
}
Jerarquía
view
Tipo de campo
value_format
Tipos de campos posibles
Dimensión, Medición

Acepta
Una string que contiene el formato de estilo Excel

Definición

El parámetro value_format te permite formatear valores de datos en Looker mediante formatos de estilo Excel. Puedes usar value_format de las siguientes maneras:

  • Por su cuenta, a nivel de campo, para aplicar el formato de estilo Excel directamente a una dimensión o medida específica
  • Como subparámetro del parámetro named_value_format, a nivel del modelo, para crear un formato personalizado reutilizable que se puede aplicar a varios campos

Aplicando value_format directamente a dimensiones y medidas

El parámetro value_format se puede usar en dimensiones y medidas. Para aplicar formato de Excel a las dimensiones mediante value_format, el tipo de dimensión debe ser number. Para aplicar el formato de estilo Excel a las medidas a través de value_format, asegúrate de que la medida sea numérica y no de type: string. Por ejemplo:

dimension: order_amount {
  type: number
  sql: ${TABLE}.order_amount ;;
  value_format: "$#.00;($#.00)"
}
measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format: "$#.00;($#.00)"
}

Usa value_format para definir un formato personalizado reutilizable

Si deseas obtener información sobre el uso de value_format con named_value_format para definir formatos reutilizables, consulta la página de documentación del parámetro named_value_format.

Opciones de formato predeterminadas

Si prefieres aplicar uno de los formatos de valor 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 a fin de obtener instrucciones para usar value_format_name a fin de aplicar formatos integrados.

Strings de formato comunes

value_format acepta una string de formato de estilo Excel.

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

Puede leer la guía completa de Excel para especificar estos formatos en la documentación. Sin embargo, en este momento, Looker no admite los formatos de fecha, formato de color ni conversiones hexadecimales.

A continuación, se muestran algunas de las opciones de formato más comunes. Tenga en cuenta que 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)
                              #   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)
                              #   Note division by 1 million happens automatically
value_format: "0.000,\" K\""  # Number in thousands with 3 decimals (1.234 K)
                              #   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%)

Para ver un ejemplo de formato condicional más avanzado con el parámetro value_format, consulta el artículo Formato condicional con el value_format artículo del Centro de ayuda.

Desafíos habituales

Pérdida de decimales al dividir

Una peculiar característica de SQL que surge cuando se usa value_format es la forma en que SQL maneja las matemáticas en números enteros. Si se divide en cinco por dos, la mayoría de las personas esperan que el resultado sea 2.5. Sin embargo, muchos dialectos de SQL mostrarán el resultado como solo 2, ya que, cuando se dividen dos números enteros, también se muestra el resultado como un número entero. Para solucionar este problema, puedes multiplicar el numerador por un número decimal (como 1,0 o 100,0) para forzar que SQL muestre un resultado decimal. Por ejemplo:

measure: active_users_percent {
  type: number
  sql: 100.000 * ${active_users} / ${users} ;;
  value_format: "0.000"
}

Usa value_format con el atributo de usuario number_format

Si usas value_format para dar formato a los campos en tus modelos, el formato de número seleccionado en el atributo de usuario number_format se aplica sobre el formato aplicado con value_format. Para ver un ejemplo y más información, visita la página de documentación de localización del formato de número.