Formater une date dans n8n : le guide complet ($now, Luxon, formats)

Récupérer une date dans n8n est facile, l’afficher au bon format l’est moins. Entre le format ISO, les fuseaux horaires et la syntaxe Luxon, beaucoup s’y perdent. Ce guide montre, exemples à l’appui, comment formater une date dans n8n proprement : date française, date et heure, jour en toutes lettres, et les erreurs à éviter.

Pourquoi le format de date pose problème dans n8n

Quand vous récupérez une date depuis un formulaire, un mail ou une API, n8n la manipule comme un texte au format ISO 8601. C’est pratique pour la machine, illisible pour un humain, et souvent rejeté par les outils qui attendent un format précis (jj/mm/aaaa pour un tableur français, par exemple). D’où la question qui revient sans cesse : comment formater une date dans n8n.

La bonne nouvelle : n8n embarque la bibliothèque Luxon, qui gère les dates proprement. Pas besoin d’installer quoi que ce soit, tout se fait dans une expression.

Les bases : $now, $today et les objets date

n8n expose deux raccourcis très utiles dans les expressions, à écrire entre doubles accolades :

Pour une date qui vient d’un nœud précédent (un champ date par exemple), enveloppez-la dans DateTime.fromISO() pour obtenir un objet manipulable :

Formater une date avec toFormat()

La méthode .toFormat() transforme la date selon des tokens. Chaque lettre représente un élément de la date :

On combine ces tokens pour obtenir le format voulu.

Exemples concrets

Le .setLocale('fr') est indispensable pour obtenir les noms de jours et de mois en français.

Gérer le fuseau horaire

Par défaut, n8n raisonne souvent en UTC, ce qui décale l’heure affichée. Pour forcer le fuseau français, utilisez setZone :

Pensez aussi à régler le fuseau global de votre instance n8n dans les paramètres, pour éviter de le répéter dans chaque expression.

Le nœud Date & Time (sans expression)

Si vous préférez éviter les expressions, n8n propose un nœud Date & Time : il formate, additionne ou soustrait des dates via une interface visuelle. Pratique pour les débutants, il fait le même travail que toFormat() sans écrire de code. Le nœud Edit Fields (Set) permet ensuite de stocker le résultat dans un champ propre, prêt à être envoyé au nœud suivant.

Les erreurs de format de date les plus courantes

• Confondre les tokens : en Luxon, MM est le mois et mm les minutes. Les inverser est l’erreur numéro un.
• Oublier le fuseau : une heure décalée de deux heures vient presque toujours d’un problème d’UTC.
• Formater un texte qui n’est pas une date : appliquer .toFormat() sur une chaîne quelconque renvoie une erreur. Passez d’abord par DateTime.fromISO() ou fromFormat().
• Mélanger les locales : sans .setLocale('fr'), les mois et les jours sortent en anglais.

Ces points reviennent dans presque tous les workflows. Les maîtriser une fois fait gagner un temps fou ensuite, et c’est exactement le genre de réflexe qu’on installe dans notre formation n8n.