Referência de personalização de datas em modelos

O que você vai aprender

Saiba como preencher e formatar datas dinamicamente nos seus modelos do Klaviyo. Você pode inserir datas das Propriedades do perfil (ex.: data de aniversário) em qualquer mensagem, ou metadados de evento (ex.: data de pedido feito) em mensagens de fluxo acionadas por esse evento.

Preencher o dia, a semana, o mês ou o ano atuais

As tags de data oferecem uma maneira rápida de inserir a hora de uma campanha em uma mensagem. A data está no fuso horário da sua conta.

• Dia atual do mês: O dia atual do mês é {% current_day %}.
  O dia atual do mês é 5.
  
• Dia atual da semana: o dia atual da semana é {% current_weekday %}.
  O dia atual da semana é sexta-feira.
  
• Mês atual: O mês atual é {% current_month_name %}.
  O mês atual é setembro.
  
• Ano atual: O ano atual é {% current_year %}.
  O ano atual é 2021.

No momento, só oferecemos suporte a nomes em inglês para meses e dias da semana.

Para adicionar uma data dinâmica a uma mensagem:

1. Em qualquer campo de texto (por exemplo, bloco de texto em um e-mail, editor de SMS, editor de mensagem push), clique no ícone de personalização.
   

2. No menu Todos os tipos, escolha Data.
3. Escolha uma tag de data (por exemplo, data atual, ano atual etc.).

Preencher uma data dinâmica como variável de evento no e-mail do fluxo

Digamos que você esteja enviando um e-mail de agradecimento por meio de um fluxo que é acionado sempre que um cliente faz um pedido. Talvez você queira adicionar uma frase dizendo: "Obrigado pelo seu pedido em _____" e especificar a data em que o pedido foi feito.

Se você analisar os dados que a Klaviyo recebe junto com um evento, como um evento Pedido feito, você deve conseguir encontrar uma variável que represente a data do pedido. Procure uma propriedade chamada "data do pedido" ou algo parecido, pois o nome da propriedade vai variar dependendo da sua fonte de dados.

Depois que você encontrar essa variável, provavelmente notará em seguida que o formato dessa data não é ideal para usar em um modelo — é um registro de data e hora em UTC que não fica muito bom em um e-mail, por exemplo:

Se você quiser preencher essa data em um formato mais amigável para o cliente, será necessário aplicar alguns filtros. O Klaviyo oferece suporte à maioria dos filtros usados pela linguagem de modelos do Django. Para este caso de uso, você precisará usar os seguintes filtros:

• Format_date_string
  Este filtro analisa e converte a cadeia de caracteres fatiada do carimbo de data/hora UTC completo em uma data real; isso é necessário para que você possa usar o filtro de data para formatá-la.
• Data
  Aqui é onde você escolhe como quer que sua data seja formatada; o Django tem um gráfico que descreve como fazer isso.

Para aplicar esses filtros, separe-os com uma barra vertical (|), sem espaços entre eles:

{{ your_variable|format_date_string|date:'F d, o' }}

O exemplo acima transformaria isto em:

2016-02-11T16:46:08-05:00

nisto:

11 de fevereiro de 2016

A seguir estão alguns formatos adicionais comuns de data e hora, junto com a formatação usada para exibi-los.

Para obter uma lista completa de opções de formato de data, consulte a documentação de formato de data do Django.

Usando a variável “hoje”

A variável today permite que você exiba a data de hoje no momento em que uma mensagem é enviada. Para exibir a data de hoje, use este código:

{% today "%Y-%m-%d" as today %} {{ today }}

A data será exibida neste formato: 2021-03-18

Para aplicar uma formatação diferente, aplique os filtros da seção acima à variável {{ today }}. Por exemplo, {% today '%Y-%m-%d' as today %} {{ today|format_date_string|date:'m/d/Y'  }} seria renderizado usando o formato MM/DD/YYYY.

Cálculo de uma data futura

Se você quiser exibir uma data futura em relação ao dia em que uma mensagem é enviada, aplique o filtro days_later à variável today descrita acima, assim:

{% today "%Y-%m-%d" as today %} {{ today|days_later:5 }}

Essa variável vai exibir a data 5 dias após o envio de uma mensagem. Então, se a mensagem foi enviada em 18 de março, a data exibida seria 23-03-2021.

Esse filtro pode ser combinado com os filtros de formatação descritos acima para usar um formato de data diferente. Use este código como exemplo:

{% today '%Y-%m-%d' as today %} {{ today|days_later:5|format_date_string|date:'M  d' }}

Se a mensagem foi enviada em 18 de março, isso seria exibido como 23 de mar.

Recursos adicionais