Referencia de personalización de fechas en plantillas

Objetivos del artículo

Aprende a completar dinámicamente y dar formato a las fechas en tus plantillas de Klaviyo. Puedes introducir fechas de las propiedades del perfil (p. ej., cumpleaños) en cualquier mensaje, o metadatos de eventos (p. ej., fecha de pedido realizado) en mensajes de flujo activados por ese evento.

Completa el día, la semana, el mes o el año actuales

Las etiquetas de fecha te ofrecen una forma rápida de insertar la hora de una campaña en un mensaje. La fecha está en la zona horaria de la cuenta.

• Día actual del mes: El día actual del mes es {% current_day %}.
  El día actual del mes es 5.
  
• Día actual de la semana: El día actual de la semana es {% current_weekday %}.
  El día actual de la semana es viernes.
  
• Mes actual: El mes actual es {% current_month_name %}.
  El mes actual es septiembre.
  
• Año actual: El año actual es {% current_year %}.
  El año actual es 2021.

Actualmente, solo admitimos nombres en inglés para los meses y los días de la semana.

Para agregar una fecha dinámica a un mensaje:

1. Desde cualquier campo de texto (por ejemplo, un bloque de texto en un correo electrónico, el editor de SMS o el editor de notificaciones push), haz clic en el ícono de personalización.
   

2. En el menú Todos los tipos, selecciona Fecha.
3. Elige una etiqueta de fecha (p. ej., Fecha actual, año actual, etc.).

Completar una fecha dinámica como variable de evento en un correo electrónico de flujo

Supongamos que envías un correo electrónico de agradecimiento a través de un flujo que se activa cada vez que un cliente realiza un pedido. Quizá quieras agregar una oración que diga: "Gracias por tu pedido del _____" y especificar la fecha en que se realizó el pedido.

Si revisas los datos que Klaviyo recibe junto con un evento, como un evento de Pedido realizado, deberías poder encontrar ahí una variable que represente la fecha del pedido. Busca una propiedad llamada "fecha del pedido" o algo similar, ya que el nombre de la propiedad variará según la fuente de datos.

Una vez que encuentres esta variable, es probable que después notes que el formato de esta fecha no es ideal para usarlo en una plantilla; por ejemplo, es una marca de tiempo UTC que no se ve bien en un correo electrónico:

Si quieres completar esta fecha en un formato más amigable para el cliente, tendrás que aplicar algunos filtros. Klaviyo es compatible con la mayoría de los filtros que usa el lenguaje de plantillas de Django. Para este caso de uso, tendrás que usar los siguientes filtros:

• Format_date_string
  Este filtro analiza y convierte la cadena de caracteres segmentada de la marca de tiempo UTC completa en una fecha real; esto es necesario para que puedas usar el filtro de fecha para darle formato.
• Fecha
  Aquí puedes elegir cómo quieres que se muestre la fecha; Django tiene una tabla que explica cómo abordar esto.

Para aplicar estos filtros, sepáralos con una barra vertical (|) y sin espacios entre ellos:

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

Lo anterior convertiría esto en lo siguiente:

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

en esto:

11 de febrero de 2016

A continuación, se muestran algunos formatos comunes adicionales de fecha y hora, junto con el formato que se usa para mostrarlos.

Para ver una lista completa de opciones de formato de fecha, consulta la documentación de formato de fecha de Django.

Usar la variable "today"

La variable today te permite mostrar la fecha de hoy en el momento en que se envía un mensaje. Para mostrar la fecha de hoy, usa este código:

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

La fecha se mostrará en este formato: 2021-03-18

Para aplicar un formato diferente, aplica los filtros de la sección anterior a la variable {{ today }}. Por ejemplo, {% today '%Y-%m-%d' as today %} {{ today|format_date_string|date:'m/d/Y'  }} se mostraría con el formato MM/DD/YYYY.

Calcular una fecha futura

Si quieres mostrar una fecha futura relativa al día en que se envía un mensaje, aplica el filtro days_later a la variable today descrita arriba, así:

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

Esta variable mostrará la fecha 5 días después de que se envíe un mensaje. Así que, si el mensaje se envió el 18 de marzo, la fecha que se mostraría sería 2021-03-23.

Este filtro se puede combinar con los filtros de formato descritos arriba para usar un formato de fecha diferente. Toma este código como ejemplo:

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

Si el mensaje se envió el 18 de marzo, se mostraría como 23 de mar.

Recursos adicionales