Skip to main content

Subtrair data

Decrementa uma data subtraindo uma quantidade de tempo em uma unidade definida, retornando a nova data resultante. Ideal para calcular datas passadas, períodos anteriores ou janelas de tempo retroativas — como "há 30 dias" ou "no mês passado". Pode considerar feriados no cálculo quando vinculado a uma ação Configurações de data e hora.


Opções

Usar data relativa à execução do robô?

Define se a data base será a data atual no momento da execução. Selecione Sim para usar a data atual automaticamente, ou Não para informar uma data específica.

Formato de entrada

Selecione o formato da data base informada. Este campo é exibido apenas quando Usar data relativa estiver definido como Não e a data a ser formatada for do tipo Texto livre.

Informe a data

Informe a data base da qual o tempo será subtraído. Este campo é exibido apenas quando Usar data relativa estiver definido como Não.

Quantidade

Informe a quantidade de tempo que será subtraída da data base.

Unidade de tempo

Selecione a unidade da quantidade informada. As opções incluem dias, semanas, meses, anos, horas, minutos e segundos.

Formato de saída

Selecione o formato no qual a data resultante será retornada.

Idioma de Saída

Escolher o idioma da data de saída, por exemplo Português Brasil gerando uma saída como 17 de abril de 2026.

Configurações de data

Selecione uma ação Configurações de data e hora para que feriados sejam considerados no cálculo. Este campo é opcional.

Retornos

Código customizado

actions["id-da-acao"].value // data resultante após a subtração do tempo (Texto)

Seleção de campos

  • value — nova data com o tempo subtraído, no formato de saída selecionado (Texto)

Regras e Condições

  • Os campos Quantidade, Unidade de tempo e Formato de saída são obrigatórios.
  • Quando Usar data relativa for Não, os campos Formato de entrada e Data também são obrigatórios.
  • O campo Configurações de data é opcional — use-o para excluir feriados do cálculo.