Cómo usar Liquid para dar formato a las fechas

En algunas situaciones, es posible que quieras cambiar la forma en que Looker formatea las fechas.

Por ejemplo, si creas exploraciones y paneles para usuarios de Europa, las fechas que estén en un formato solo numérico deberían aparecer en el orden Día-Mes-Año. Por ejemplo, el 7 de junio de 2019 debe tener el formato 07/06/2019 o Jun 07, 2019. El formato predeterminado de Looker renderiza la fecha como 2019-06-07. Si bien puedes usar funciones de SQL como DATE_FORMAT() para cambiar un formato de fecha, es posible que no quieras escribir todo en SQL simple.

Usa Liquid en el parámetro html

Puedes utilizar Formato líquido en el parámetro html de una dimensión para cambiar el formato de cualquier campo que utilice un formato de fecha válido. Dado que Liquid espera una fecha válida, es mejor usar los períodos de un grupo de dimensiones existente. No puedes cambiar los números de la semana o el mes, ya que se muestran como números enteros.

Por ejemplo, puedes dar formato a ${created_date} para renderizarlo como Aug 23 22 en lugar del 2022-08-23 predeterminado de Looker:

  dimension: date_formatted {
    sql: ${created_date} ;;
    html:{{ rendered_value | date: "%b %d, %y" }};;
  }

El formato para la sintaxis de cadena "%b %d, %y" es el mismo que strftime.

Como el parámetro html usa formato líquido, el valor original del período no se cambia, solo la forma en que se renderiza el valor para el usuario. Esto garantiza que no cambie el orden en que aparecen las fechas en una consulta.

A continuación, se incluyen otros ejemplos que puedes usar. La referencia más grande de los formatos disponibles se encuentra al final de esta página.

Ejemplo

En el siguiente ejemplo de una consulta de exploración, se muestran las opciones Order Items Date y Orders Items Week con un formato diferente y organizadas en una etiqueta de grupo Created date para simular un grupo de dimensiones de fecha en el selector de campos Explore.

El formato personalizado les muestra a los usuarios qué fecha y número de semana del año corresponden a los valores más altos de Recuento de artículos en orden descendente.

Consulta la página de documentación de group_label para obtener más información sobre el uso del parámetro group_label.

LookML

En el ejemplo de Explorar, se usa el siguiente LookML:

# The original dimension group - hidden so that users can only choose from the formatted dates date and week timeframes
  dimension_group: created {
    hidden: yes
    type: time
    timeframes: [
      raw,
      time,
      date,
      hour,
      hour_of_day,
      time_of_day,
      week,
      month,
      quarter,
      year
    ]
    sql: ${TABLE}.created_at ;;
  }

# The customized timeframes, organized in the Explore field picker under the group label Created date
  dimension: date_formatted {
    group_label: "Created date"
    label: "Date"
    type: date_raw
    sql: ${created_date} ;;
    html: {{ rendered_value | date: "%b %d, %y" }};;
  }

  dimension: week_formatted {
    group_label: "Created date"
    label: "Week"
    type: date_raw
    sql: ${created_week} ;;
    html: {{ rendered_value | date: "Week %U (%b %d)" }};;
  }

strftime Reference

En la siguiente tabla, se enumeran varios formatos strftime. Ten en cuenta que es posible que no todos los formatos se rendericen como se espera en Looker.