Base de Conhecimento

Date & Time no n8n: como formatar e calcular datas

  • n8n, date & time, luxon, fuso horário, formatar data, automação
  • Usuários acharam útil: 0

Aprenda a usar o nó Date & Time no n8n: formate datas, some e subtraia dias, ajuste o fuso horário e use Luxon nas expressões, com um exemplo de fluxo.

Por Redação Eleven Host · @robson.direitodigital · 4 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: Date & Time no n8n: como formatar e calcular datas

Capa da Redação Eleven Host para o guia: Date & Time no n8n: como formatar e calcular datas Arte: Eleven Host

Date & Time no n8n é o nó que formata, soma, subtrai e compara datas dentro do fluxo. Veja cada operação, o fuso horário, as expressões com Luxon e um exemplo de lembrete de vencimento.

Operações do nó Date & Time

Ao adicionar o nó, você escolhe uma operação. Estas são as que aparecem na documentação do n8n:

  • Add to a Date: soma um período a uma data;
  • Subtract From a Date: subtrai um período de uma data;
  • Format a Date: muda o formato de uma data;
  • Get Current Date: devolve a data atual;
  • Get Time Between Dates: calcula o tempo entre duas datas;
  • Extract Part of a Date: extrai uma parte da data, como o mês;
  • Round a Date: arredonda uma data.

As operações têm o campo Output Field Name, onde você dá o nome do campo que vai receber o resultado, e a opção Include Input Fields. Ligue essa opção para que os campos de entrada acompanhem o resultado na saída.

Fuso horário: o ponto de atenção

O nó Date & Time depende da configuração de fuso horário: se você não definir nada, a instância autohospedada usa o horário de Nova York.

Segundo a documentação, o nó usa o fuso do workflow, se ele estiver definido, e, se não estiver, o fuso da instância. O padrão para instâncias autohospedadas é America/New_York. No n8n Cloud, o sistema tenta detectar o fuso de quem criou a conta e, se não conseguir, usa GMT. A própria documentação lembra que GMT serve para o fuso +00:00.

Para quem está no Brasil, isso significa configurar o fuso por conta própria. Existem dois caminhos:

  • No workflow: abra o menu de três pontos, no canto superior direito, entre em Settings e preencha o campo Timezone. A documentação explica que esse campo define o fuso do workflow e é importante para o Schedule Trigger;
  • Na instância: defina a variável de ambiente GENERIC_TIMEZONE. Ela representa o fuso da instância e, segundo a documentação, é importante para nós de agendamento, como o Cron.

Um exemplo para o Brasil é GENERIC_TIMEZONE=America/Sao_Paulo. O formato é o mesmo do valor padrão, America/New_York. Quem hospeda o n8n num servidor próprio encontra no guia Variáveis de ambiente n8n: como configurar no Docker o caminho para definir variáveis no Docker.

Get Current Date: a data de hoje

A operação Get Current Date traz a data atual. Ela tem a opção Include Current Time: ligada, inclui o horário; desligada, define o horário como meia-noite. Também há a opção Timezone, e, se você deixá-la em branco, o nó usa o fuso da instância do n8n.

Dê um nome ao resultado em Output Field Name, por exemplo hoje, e use esse campo nos nós seguintes.

Add to a Date e Subtract From a Date

Para somar, use Add to a Date com estes campos:

  • Date to Add To: a data que você quer alterar;
  • Time Unit to Add: a unidade de tempo do campo Duration;
  • Duration: quantas unidades somar;
  • Output Field Name: o nome do campo que recebe a nova data.

Para subtrair, Subtract From a Date segue a mesma lógica, com Date to Subtract From, Time Unit to Subtract e Duration. Escolha a unidade na lista que o nó mostra na tela.

Seus fluxos do n8n estão em qual servidor? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Format a Date: mudar o formato

Em Format a Date, o campo Date recebe a data e o campo Format traz estas escolhas, aqui com o resultado para 4 de setembro de 1986:

  • MM/DD/YYYY: 09/04/1986;
  • YYYY/MM/DD: 1986/09/04;
  • MMMM DD YYYY: September 04 1986;
  • MM-DD-YYYY: 09-04-1986;
  • YYYY-MM-DD: 1986-09-04;
  • Custom Format: você escreve o seu próprio formato com os tokens do Luxon.

Não há uma escolha pronta para o formato brasileiro, dia/mês/ano. Para ele, use o Custom Format. Um exemplo de formato é dd/MM/yyyy, que mostra 04/09/1986 para a mesma data.

Tokens diferenciam maiúsculas e minúsculas

A documentação avisa que os tokens são sensíveis a maiúsculas e minúsculas. Na prática, isso muda o resultado: MM representa o mês e mm representa o minuto. Se a data sair estranha, confira primeiro essas letras.

Há ainda opções. From Date Format serve para informar o formato de entrada quando o nó não reconhece a data. Use Workflow Timezone, desligada, usa o fuso da própria entrada; ligada, usa o fuso do workflow. A documentação afirma que o n8n aceita os formatos de data aceitos pelo Luxon.

Get Time Between Dates: quanto tempo passou

Com Get Time Between Dates, você informa Start Date, a data mais antiga, e End Date, a mais recente. Em Units, escolha uma ou mais unidades: Year, Month, Week, Day, Hour, Minute, Second e Millisecond.

Com a opção Output as ISO String, o resultado vem como uma única duração no padrão ISO, como P1Y3M13D. Os milissegundos não têm unidade própria e entram como segundos decimais: segundo a documentação, 2,1 milissegundos viram 0.0021S.

Extract Part of a Date e Round a Date

Em Extract Part of a Date, o campo Part aceita Year, Month, Week, Day, Hour, Minute e Second. Use quando só o mês ou só o dia importa para o fluxo.

Em Round a Date, o campo Mode escolhe entre Round Down e Round Up, e o campo To Nearest define a unidade do arredondamento: Year, Month, Week, Day, Hour, Minute ou Second.

Datas em expressões com Luxon

O Luxon é uma biblioteca JavaScript que facilita o trabalho com data e hora, e o n8n passa as datas entre os nós como texto, por isso é preciso interpretá-las. A documentação diz que usar o DateTime() do Luxon é o caminho recomendado no n8n, porque o Date() do JavaScript puro não funciona com alguns recursos da ferramenta.

Duas variáveis prontas valem destaque:

  • $now: a data e a hora do momento, no fuso do workflow;
  • $today: a meia-noite do início do dia atual, no fuso da instância, salvo se o fuso do workflow for definido.

Alguns exemplos da documentação, para usar dentro de {{ }} nos campos:

  • {{ $now.toFormat("yyyy-MM-dd") }}: formata a data atual como texto;
  • {{ $today.minus({days: 7}) }}: sete dias antes de hoje;
  • {{ $now.plus(1, 'day').toRelative() }}: devolve algo como "in 1 day";
  • {{ DateTime.fromFormat("23-06-2019", "dd-MM-yyyy") }}: lê um texto com um formato conhecido;
  • {{ $now.toISO() }}: a data em formato ISO;
  • {{ dt.startOf('month') }}: o início do mês de uma data dt.

O fuso usado pelo Luxon é o do n8n: o padrão, o da variável GENERIC_TIMEZONE ou o definido nas configurações do workflow. Para trocar o fuso de uma data específica, a documentação mostra, como exemplo, dt.setZone('America/Buenos_aires').

No Code node o comportamento é outro

Há duas diferenças a conhecer. A primeira: nas expressões, plus(7, 'days') soma sete dias, mas no Code node o plus aceita só um objeto de duração. Escrever dt.plus(7, 'days') lá não dá erro, mas também não soma os sete dias. O mesmo vale para o minus.

A segunda: o format() é uma extensão do n8n, disponível no editor de expressões. No Code node, ele dá erro de função inexistente, e a saída é o toFormat() nativo do Luxon, por exemplo DateTime.now().toFormat('dd/LL/yyyy'). Quem ainda não definiu onde o n8n vai funcionar pode começar pelo guia O que é servidor VPS.

Exemplo de fluxo: lembrete de vencimento

Um exemplo de fluxo para treinar o que foi visto, com o fuso configurado para America/Sao_Paulo em Settings:

  1. Schedule Trigger, todo dia às 8h;
  2. Date & Time, Get Current Date, com Include Current Time desligado e Output Field Name hoje;
  3. Date & Time, Add to a Date, com Date to Add To igual a {{ $json.hoje }}, a unidade em dias, Duration igual a 3 e Output Field Name vence_em;
  4. Date & Time, Format a Date, com Custom Format dd/MM/yyyy;
  5. um nó de envio de e-mail com a data já formatada.

Um resultado parecido pode sair de uma única expressão, também como exemplo: {{ $now.plus(3, 'days').toFormat('dd/MM/yyyy') }}. E para contar os dias desde o cadastro, use Get Time Between Dates, com Start Date igual à data do cadastro, End Date igual a {{ $now }} e Units em Day.

Se a data de vencimento vem de um formulário, o guia Form Trigger n8n: como criar formulários no fluxo mostra como criá-lo no fluxo, e o guia Ler e-mails no n8n: receber, responder e organizar cobre a parte de e-mails.

Problemas comuns

  • A hora não bate com a esperada: confira o fuso do workflow e a variável GENERIC_TIMEZONE. Sem configuração, o padrão é Nova York;
  • O mês aparece no lugar do minuto, ou o contrário: revise a caixa das letras nos tokens, porque MM e mm são coisas diferentes;
  • O nó não reconhece a data: informe o formato de entrada em From Date Format;
  • O horário não deveria aparecer: em Get Current Date, desligue Include Current Time para obter meia-noite;
  • A soma de dias não funciona no Code node: use o objeto de duração, como em plus({days: 7}), ou faça a conta numa expressão.

Resumo

Configure o fuso, escolha a operação do nó Date & Time e, para o formato brasileiro, use o Custom Format com dd/MM/yyyy.

Como está a máquina que sustenta o seu n8n? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS

Perguntas frequentes

Qual é o fuso padrão do n8n autohospedado?

America/New_York, que é o horário de Nova York. Para mudar, defina o Timezone nas configurações do workflow ou a variável GENERIC_TIMEZONE.

Como formatar a data como dia/mês/ano?

No Format a Date, escolha Custom Format e use o formato dd/MM/yyyy.

Como somar dias a uma data?

Use Add to a Date, informe a data, a unidade e a Duration. Em expressão, use o plus do Luxon.

Qual a diferença entre $now e $today?

O $now é a data e a hora atuais e usa o fuso do workflow. O $today é a meia-noite do dia e usa o fuso da instância, salvo se o workflow definir outro.

Esta resposta lhe foi útil?

Artigos Relacionados