Skip to main content

Manipulação de Data e Hora

Aplica uma ou mais operações de adição ou subtração de unidades de tempo a uma data base, retornando a data resultante. Ideal para calcular prazos, datas de vencimento, períodos de competência ou qualquer situação que exija navegar no calendário a partir de uma data conhecida.


Opções

Formato de Entrada da Data

Selecione o formato no qual a data de entrada está escrita. O formato deve corresponder exatamente à data informada.

Usar data relativa?

Define se a data base será a data atual no momento da execução do robô. Selecione Sim para usar a data atual automaticamente, ou Não para informar uma data manualmente.

Informe a data

Informe a data base sobre a qual as operações serão aplicadas. Este campo é exibido apenas quando Usar data relativa estiver definido como Não.

Funções de manipulação disponíveis

Adicione uma ou mais operações a serem aplicadas à data. Cada operação contém:

  • Função — escolha entre Adicionar Data (avançar no tempo), Subtrair Data (recuar no tempo), Começar a data com ou Terminar a data com
  • Quantidade — informe o valor numérico da operação
  • Unidade — selecione a unidade de tempo: anos, meses, semanas, dias, horas, minutos ou segundos

As operações são executadas em sequência, na ordem em que foram adicionadas.

Retornos

Código customizado

actions["id-da-acao"].value // data resultante após todas as operações aplicadas (Texto)

Seleção de campos

  • value — data resultante no mesmo formato da entrada, após as manipulações (Texto)

Regras e Condições

  • O campo Formato de Entrada da Data é obrigatório.
  • Quando Usar data relativa for Não, o campo Data também é obrigatório.
  • Ao menos uma operação deve ser adicionada para que a ação tenha efeito.
  • As operações são aplicadas em cascata — o resultado de uma é a base da próxima.