Pular para o conteúdo principal
Docs
Acessar Studio
Roberty Studio
RPAData e Hora

Subtrair Data

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 uma 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 de data​

Selecione o formato da data base informada: Tradicional (31/12/2024), Por extenso (31 de dezembro de 2024) ou Internacional (2024-12-31). Este campo é exibido apenas quando Usar uma data relativa à execução do robô? estiver definido como Não.

Data a ser formatada​

Informe a data base da qual o tempo será subtraído. Este campo é exibido apenas quando Usar uma data relativa à execução do robô? 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: Dia, Semana, Mês ou Ano.

Formato de saída​

Selecione o formato no qual a data resultante será retornada: Tradicional (31/12/2024), Por extenso (31 de dezembro de 2024) ou Internacional (2024-12-31).

Selecione a configuração de data​

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

Idioma de saída​

Escolha o idioma da data de saída — Português Brasil ou Inglês. Por exemplo, Português Brasil gera uma saída como 17 de abril de 2026.

Retornos​

Código Javascript​

js
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​

  • O campo Quantidade é obrigatório.
  • Quando Usar uma data relativa à execução do robô? for Não, a data informada deve corresponder ao formato selecionado em Formato de entrada de data.
  • O campo Selecione a configuração de data é opcional — quando informado, os dias configurados como feriado são pulados no cálculo.