value_format_name

Uso

view: view_name {
  dimension: field_name {
    value_format_name: format_name
  }
}

Jerarquía Ver archivo view Tipo de campo value_format_name

Tipos de campos posibles Dimensión, medida Acepta Uno de los formatos de valor predeterminado que se indican en esta página de documentación o el nombre de un formato que creaste con el parámetro named_value_format

Definición

El parámetro value_format_name te permite dar formato a los valores de datos con formatos integrados en Looker o con tus propios formatos personalizados y reutilizables. Si deseas aplicar un formato de Excel directamente a un campo único, usa value_format en su lugar.

El parámetro value_format_name se puede usar en dimensiones y medidas. Por ejemplo:

measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format_name: usd
}

Nota: value_format_name solo afecta la forma en que se muestran los valores de los campos en el contenido de Looker. value_format_name no cambia ni afecta el valor en la base de datos.

Nombres de formato predeterminados

Looker tiene los formatos predeterminados que se muestran en las siguientes tablas. Cuando se usa uno de los formatos predeterminados, Looker redondea hacia arriba o hacia abajo para quitar dígitos, en lugar de truncar valores. Cuando se usa un nombre de formato predeterminado en una métrica, el redondeo se produce después de que se agregan los datos de la métrica.

También puedes crear tus propios formatos con nombre usando el parámetro named_value_format.

Formatos numéricos

En la siguiente tabla, se muestran los formatos predeterminados para los tipos de campos numéricos. Comienzan con el valor subyacente "1234.56789":

Nombre	Ejemplo
decimal_0	1,235
decimal_1	1,234.6
decimal_2	1,234.57
decimal_3	1,234.568
decimal_4	1,234.5679
usd_0	USD 1,235
usd	$1,234.57
gbp_0	1,235 GBP
gbp	GBP 1,234.57
eur_0	EUR 1,235
eur	EUR 1,234.57
id	1235

En el caso de los tipos de campos numéricos, id solo se debe usar en números que tengan 16 dígitos o menos. Más allá de 16 dígitos, id puede redondear los resultados. Para los números con más de 16 dígitos, conviértelos en una cadena y usa id en el tipo de campo de cadena.

Formatos de porcentaje

En el caso de los formatos de porcentaje, Looker toma el valor decimal subyacente y lo multiplica por 100 para obtener un porcentaje. Los siguientes ejemplos comienzan con el valor subyacente "0.123456":

Nombre	Ejemplo
percent_0	12%
percent_1	12.3%
percent_2	12.35%
percent_3	12.346%
percent_4	12.3456%

Información importante

Para aplicar value_format_name a un campo, se debe definir el parámetro type para ese campo.

Desafíos habituales

Cómo usar value_format_name con el atributo de usuario number_format

Si usas value_format_name 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 proporcionado con value_format_name. Para ver un ejemplo y obtener más información, consulta la página de documentación Localización del formato de números.