value_format

Uso

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

Acepta
Una cadena que contiene formato al estilo de Excel

Definición

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

  • Por sí solo, a nivel del campo, para aplicar el formato al estilo de Excel directamente a una dimensión o medición específica
  • Como un 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

Cómo aplicar value_format directamente a dimensiones y mediciones

El parámetro value_format se puede usar en dimensiones y mediciones. Para aplicar el formato al estilo de Excel a las dimensiones a través de value_format, el tipo de dimensión debe ser number. Para aplicar el formato al estilo de Excel a las mediciones a través de value_format, asegúrate de que la medición 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)"
}

Cómo usar 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 valor integrados de Looker, puedes elegir entre los formatos que se enumeran en la sección Nombres de formatos predeterminados de la página de documentación del parámetro value_format_name. Consulta esa página para obtener instrucciones sobre el uso de value_format_name para aplicar formatos integrados.

Cadenas de formato habituales

value_format acepta una cadena de formato al estilo de Excel.

El formato que se usa con el value_format parámetro es el mismo que el formato que se usa en el campo Formato de valor en las visualizaciones, excepto que el value_format parámetro requiere que la cadena de formato esté entre comillas dobles. Consulta la página de documentación Opciones de gráfico de columnas para obtener información sobre los formatos de valor 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, el formato de fecha, el formato de color y la conversión hexadecimal no son compatibles con Looker.

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 obtener un ejemplo de formato condicional más avanzado con el parámetro value_format, consulta la página Prácticas recomendadas para el formato condicional con value_format.

Desafíos habituales

Pérdida de decimales cuando se divide

Una peculiaridad común de SQL que surge cuando se usa value_format es la forma en que SQL controla las operaciones matemáticas de números enteros. Si divides 5 por 2, la mayoría de las personas esperan que el resultado sea 2.5. Sin embargo, muchos dialectos de SQL mostrarán el resultado como 2, ya que, cuando divide dos números enteros, también 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 a SQL a mostrar 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 obtener un ejemplo y obtener más información, visita la página de documentación Cómo localizar el formato de números.