Date & Time no n8n: como formatar e calcular datas
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

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 datadt.
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:
- Schedule Trigger, todo dia às 8h;
- Date & Time, Get Current Date, com Include Current Time desligado e Output Field Name
hoje; - 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 Namevence_em; - Date & Time, Format a Date, com Custom Format
dd/MM/yyyy; - 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
MMemmsã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.