Aller au contenu
Docs
Ouvrir l'application

Date et heure

n8n : Date & TimeToutes les offres1 entrée · 1 sortie

Calcule, met en forme, arrondit ou compare des dates, dans le fuseau choisi.

Éléments reçusDate et heureÉléments produits

Fonctionnement

Une opération par élément ; le résultat est écrit dans le champ de sortie. Les calculs en jours, mois et années suivent le calendrier du fuseau choisi : ajouter 1 jour garde la même heure locale, même au changement d'heure.

Paramètres

ParamètreTypeDétail
OpérationchoixValeurs : Date actuelle, Ajouter une durée, Soustraire une durée, Mettre en forme une date, Arrondir une date, Durée entre deux dates, Extraire une partie (année, mois…).
Dateobligatoire · selon les autres paramètrestexteISO 8601, horodatage Unix (secondes ou millisecondes) ou date RFC 2822. Sans fuseau, la date est lue dans le fuseau du bloc.
Inclure l'heureselon les autres paramètresoui / non—
Duréeobligatoire · selon les autres paramètrestexte—
Unitéselon les autres paramètreschoixValeurs : secondes, minutes, heures, jours, semaines, mois, trimestres, années.
Date de finobligatoire · selon les autres paramètrestexte—
Unités du résultatselon les autres paramètreschoix multipleValeurs : secondes, minutes, heures, jours, semaines, mois, années.
Arrondirselon les autres paramètreschoixValeurs : Au début de, À la fin de.
Périodeselon les autres paramètreschoixValeurs : la minute, l'heure, la journée, la semaine (lundi), le mois, le trimestre, l'année.
Partieselon les autres paramètreschoixValeurs : Année, Trimestre, Mois, Semaine ISO, Jour du mois, Jour de la semaine (1 = lundi), Heure, Minute, Seconde.
Format du résultatselon les autres paramètreschoixValeurs : ISO 8601 (2026-11-08T14:30:00.000+01:00), Date (08/11/2026), Date et heure (08/11/2026 14:30), Date longue (8 novembre 2026), Heure (14:30), Horodatage Unix (secondes), Horodatage Unix (millisecondes), Format personnalisé.
Format personnaliséobligatoire · selon les autres paramètrestexteJetons : yyyy année, MM mois, dd jour, HH heure, mm minute, ss seconde, EEEE jour en lettres, MMMM mois en lettres. Texte littéral entre apostrophes ('le').
Langue des noms de jours et de moisselon les autres paramètreschoixValeurs : Français, Anglais, Allemand, Espagnol, Italien.
Fuseau horaireobligatoirefuseau horaire—
Champ de sortieobligatoiretexteNotation pointée acceptée (resultat.valeur). Les autres champs de l'élément sont conservés.

Données reçues et renvoyées

  • EntréeListe d'éléments.
  • SortieChaque élément, avec le champ de sortie. Durée entre deux dates : { years, months, days… } selon les unités choisies.

Erreurs

Date illisible (élément et valeur indiqués), durée non numérique, format personnalisé vide.

À savoir. Ajouter un mois au 31 janvier donne le dernier jour de février.

À savoir. Les formats ISO et Unix ignorent la langue.

Exemple

Paramètres d'un bloc prêt à l'emploi. Dans l'éditeur, l'onglet Aide du bloc applique cet exemple en un clic.

Paramètres de l'exemple (JSON)Ouvrir l'éditeur
{
  "operation": "add",
  "date": "{{ $json.commande_le }}",
  "amount": "30",
  "unit": "days",
  "format": "date",
  "timezone": "Europe/Paris",
  "outputField": "echeance"
}

Voir aussi