Guide de personnalisation des dates dans les modèles

Objectif de cet article

Découvrez comment remplir et formater dynamiquement des dates dans vos modèles Klaviyo. Vous pouvez saisir les dates des propriétés de profil (par exemple, un anniversaire) dans n’importe quel message, ou les métadonnées d’un événement (par exemple, la date d’une commande passée) dans les messages de flux déclenchés par cet événement.

Renseigner le jour, la semaine, le mois ou l’année en cours

Les tags de date vous permettent d’insérer rapidement la date actuelle dans les messages de campagne et de flux. La date utilise le fuseau horaire de votre compte.

• Jour du mois actuel: le jour du mois actuel est {% current_day %}.
  Le jour du mois actuel est le 5.
  
• Jour de la semaine actuelle: le jour de la semaine actuelle est {% current_weekday %}.
  Le jour de la semaine actuelle est le vendredi.
  
• Mois actuel: le mois actuel est {% current_month_name %}.
  Le mois actuel est septembre.
  
• Année actuelle: l’année actuelle est {% current_year %}.
  L’année actuelle est 2021.

Actuellement, nous ne prenons en charge que les noms anglais des mois et des jours de la semaine.

Pour ajouter une date dynamique à un message :

1. Dans n’importe quel champ de texte (par exemple, le bloc de texte d’un e-mail, l’éditeur de SMS, l’éditeur de notifications Push), cliquez sur l’icône de personnalisation.
   

2. Dans le menu Tous les types, sélectionnez Date.
3. Choisissez un tag de date, tel que Date actuelle ou Année actuelle.
4. Si vous avez choisi Date actuelle, sélectionnez un Format de date, puis cliquez sur Insérer. D’autres tags de date sont insérés lorsque vous les sélectionnez.

Renseigner une date dynamique à partir d’un événement dans un e-mail de flux

Supposons que vous envoyiez un e-mail de remerciement via un flux qui se déclenche chaque fois qu’un client passe une commande. Vous pouvez ajouter une phrase du type : « Merci de votre commande du _____ » et préciser la date de la commande.

Si vous passez en revue les données que Klaviyo reçoit lors d’un événement, par exemple Commande passée, vous devriez trouver une variable correspondant à la date de la commande. Recherchez la propriété « Date de la commande » ou un libellé approchant, car le nom de la propriété varie en fonction de la source de données.

Les dates d’événement peuvent inclure une heure et un décalage de fuseau horaire. Un horodatage peut ressembler à ceci :

Si vous souhaitez afficher cette date dans un format mieux adapté au client, vous devez appliquer quelques filtres. Klaviyo prend en charge la plupart des filtres utilisés par le langage de modèle de Django. Pour ce cas d’utilisation, vous devrez utiliser les filtres suivants :

• format_date_string
  Ce filtre convertit une chaîne de date compatible en une valeur de date afin que vous puissiez utiliser le filtre de date pour la formater. Vous n’avez pas besoin de découper l’horodatage au préalable.
• Date
  Ce filtre vous permet de sélectionner le format de votre date. Django propose un graphique qui explique comment procéder.

Dans l’exemple ci-dessous, remplacez your_variable par la partie de votre tag de date à l’intérieur de {{ }}. Séparez les filtres par une ligne verticale (|) sans espace entre les deux :

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

L’exemple permet de transformer cette formulation :

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

en ceci :

Février 11, 2016

Vous trouverez ci-dessous d’autres formats de date et d’heure courants, ainsi que le formatage utilisé pour les afficher.

Pour obtenir la liste complète des options de format de date, consultez la documentation de Django sur le format de date.

Utilisation de la variable « today »

La variable « today » (aujourd’hui) permet d’afficher la date du jour au moment de l’envoi d’un message. Pour afficher la date du jour, utilisez ce code :

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

La date s’affiche dans ce format : 2021-03-18

Pour appliquer un formatage différent, appliquez les filtres de la section ci-dessus à la variable {{ today }}. Par exemple, {% today '%Y-%m-%d' as today %} {{ today|format_date_string|date:'m/d/Y'  }} s’afficherait au format MM/DD/YYYY.

Calculer une date ultérieure

Si vous souhaitez afficher une date ultérieure au jour d’envoi du message, appliquez le filtre « days_later » à la variable « today » décrite ci-dessus, comme suit :

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

Cette variable affichera une date 5 jours après l’envoi du message. Ainsi, si le message a été envoyé le 18 mars, la date affichée serait le 2021-03-23.

Ce filtre peut être combiné avec les filtres de formatage décrits ci-dessus pour utiliser un format de date différent. Conservez days_later avant les filtres de mise en forme, comme indiqué ci-dessous :

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

Si le message a été envoyé le 18 mars, la date affichée sera le 23 mars.

Ressources supplémentaires