Como usar o Liquid para formatar datas

Em algumas situações, talvez você queira mudar a forma como o Looker formata as datas.

Por exemplo, se você estiver criando análises e painéis para usuários na Europa, todas as datas em formato numérico vão aparecer na ordem dia-mês-ano. Por exemplo, 7 de junho de 2019 deve ser formatado como 07/06/2019 ou Jun 07, 2019. O formato padrão do Looker renderiza a data como 2019-06-07. Embora seja possível usar funções SQL como DATE_FORMAT() para alterar um formato de data, talvez você não queira escrever tudo em SQL simples.

Como usar o Liquid no parâmetro html

Você pode usar a formatação líquida no parâmetro html de uma dimensão para mudar o formato de qualquer campo que use um formato de data válido. Como o Liquid espera uma data válida, é melhor usar os períodos de um grupo de dimensão existente. Não é possível alterar os números de semana ou mês porque eles são retornados como números inteiros.

Por exemplo, é possível formatar ${created_date} para renderizar como Aug 23 22 em vez do 2022-08-23 padrão do Looker:

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

O formato da sintaxe da string "%b %d, %y" é igual ao strftime.

Como o parâmetro html usa formatação líquida, o valor original do período não muda, apenas a forma como o valor é renderizado para o usuário. Isso garante que a ordem em que as datas aparecem em uma consulta não será alterada.

Confira abaixo outros exemplos que podem ser usados. A referência maior dos formatos disponíveis está na parte inferior desta página.

Exemplo

O exemplo a seguir de uma consulta de Análise mostra Data dos itens do pedido e Semana dos itens dos pedidos formatados de forma diferente e organizados em um rótulo de grupo Data de criação para simular um grupo de dimensões de data no seletor de campo "Explorar".

A formatação personalizada mostra aos usuários qual data e número de semana do ano correspondem aos maiores valores de Contagem de itens em ordem decrescente.

Consulte a página de documentação de group_label para saber mais sobre como usar o parâmetro group_label.

O LookML

O exemplo da Análise usa o seguinte 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

A tabela abaixo lista vários formatos strftime. Nem todos os formatos podem ser renderizados como esperado no Looker.