value_format

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, medida

Acepta
Es una cadena que contiene el formato de estilo de Excel.

Definición

El parámetro value_format te permite dar formato a los valores de datos en Looker con formatos de estilo Excel. Puedes usar value_format de las siguientes maneras:

  • Por sí solo, a nivel del campo, para aplicar el formato de 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 pueda aplicar a varios campos

Aplicar value_format directamente a dimensiones y medidas

El parámetro value_format se puede usar en dimensiones y medidas. Para aplicar el formato de estilo Excel a las dimensiones a través de value_format, el tipo de dimensión debe ser number. Para aplicar formato de 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

Para 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 valores integrados de Looker, puedes elegir entre los formatos que se indican 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.

Cadenas de formato comunes

value_format acepta una cadena de formato de estilo Excel.

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.

Aquí se muestran algunas de las opciones de formato más comunes. Ten 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 la página de prácticas recomendadas Formato condicional con value_format.

Desafíos habituales

Pérdida de decimales al dividir

Una peculiaridad común de SQL que surge cuando se usa value_format es la forma en que SQL controla las operaciones matemáticas con números enteros. Si divides 5 entre 2, la mayoría de las personas espera que el resultado sea 2.5. Sin embargo, muchos dialectos de SQL devolverán el resultado como 2, ya que, cuando se dividen dos números enteros, el resultado también es 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 a SQL a que devuelva un resultado decimal. Por ejemplo:

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

Cómo usar value_format con el atributo de usuario number_format

Si usas value_format para dar formato a los campos de 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 obtener más información, visita la página de documentación Localizing number formatting.