Data: Formatta

Descrizione

Formatter enterprise multi-locale per date e timestamp con focus sul formato italiano standard usato in fatturazione, comunicazioni cliente, generazione documenti contrattuali. Accetta input in formati eterogenei (la realtà dei sistemi business mai puliti): timestamp ISO 8601 strict ("2026-05-23T10:30:00Z" con timezone esplicita, formato preferito dei DB modern + REST API), Date object JavaScript nativo (passato da nodi upstream come $date.now), formato italiano comune "23/05/2026" o "23-05-2026" anche con ora "23/05/2026 10:30:00" (formato che arriva da spreadsheet Excel italiani con configurazione locale default), formato US "05/23/2026" (rilevato per separator e contesto), stringa speciale "now" per la data corrente al momento dell'esecuzione del nodo. Parsing fallback intelligente: se nessun pattern matcha, prova ad usare new Date(input) di JavaScript come last resort (parser permissivo che gestisce casi inattesi come "May 23 2026 10:30 AM"). Output con doppia struttura per massima flessibilità downstream: { formatted (stringa nel formato target configurato), iso (sempre ISO 8601 normalizzato per audit + storage DB), components: { day, month, year, hour, minute, second, dayOfWeek (1-7), dayOfWeekName ("lunedì", "martedì", ...), monthName ("gennaio", "febbraio", ...), quarter (1-4), weekIso (settimana ISO 1-53) }, timezone (IANA tz database), isWeekend, isPast, isFuture, daysFromNow (signed integer per ordering + ranking) }. Locale-aware Intl.DateTimeFormat: supporto pieno per "it-IT" (default — "23 maggio 2026", "lunedì 23 maggio"), "en-US", "en-GB", "de-DE", "fr-FR", "es-ES". Custom format string via tokens stile Moment.js (DD/MM/YYYY, dddd D MMMM YYYY, HH:mm:ss, ecc.) per pattern specifici di documento legale o corrispondenza istituzionale. Use case classici della pipeline italiana: convertire timestamp DB (created_at UTC) in stringa italiana "23 maggio 2026" per generazione email transazionale "Il suo ordine del {{date}}"; calcolare scadenze fatturazione enterprise da emissione +30/60/90 giorni con verifica weekend (sposta a lunedì successivo in alcuni casi); raggruppare eventi per giorno/settimana/mese in summary cron per dashboard analytics; generare nomi file con data per backup quotidiani ("backup-2026-05-23.tar.gz"); estrazione campi separati (year, quarter) per fiscalizzazione (esercizio amministrativo italiano 1/1-31/12 ma con lookback 18 mesi per dichiarazioni IVA).

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

⬆️ Output del nodo

Campi disponibili nei nodi successivi via $node.<alias>.json.<field>:

• formatted
• iso
• unix
• year
• month
• day
• weekday
• hour
• minute

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-action_date_format-1",
  "defId": "action_date_format",
  "label": "Data: Formatta",
  "config": {
    "input": "{{$node.trigger.json.date}}",
    "preset": "it_long",
    "timezone": "Europe/Rome"
  }
}

🔗 Nodi correlati nella stessa categoria