Pular para o conteúdo principal
Docs
Acessar Studio
Roberty Studio
RPAFunções

Manipulação de Data e Hora

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. As opções disponíveis são: DD/MM/YYYY, DD/MM/YYYY HH:mm:ss, DD [de] MMMM [de] YYYY, HH:mm, HH:mm:ss, HH:mm:ss:SSS, YYYY-MM-DD e YYYY-MM-DD HH:mm:ss.

Informe a data​

Informe a data base sobre a qual as operações serão aplicadas. Pode ser um texto fixo, uma variável, um parâmetro ou o retorno de outra açã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 de manipulação — escolha entre Adicionar à data (avançar no tempo), Subtrair da data (recuar no tempo), Começar a data com (ir para o início da unidade escolhida, por exemplo o primeiro dia do mês) ou Terminar a data com (ir para o fim da unidade escolhida, por exemplo o último dia do mês)
  • Quantidade — informe o valor numérico da operação (mínimo 1). Exibido apenas para Adicionar à data e Subtrair da data
  • Unidade de tempo — selecione a unidade de tempo: dia, semana, mês, ano, hora, minuto ou segundo

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

Retornos​

Código Javascript​

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

Seleção de campos​

  • date — data resultante após as manipulações, no formato DD/MM/YYYY HH:mm:ss (Texto)

Regras e Condições​

  • A data informada deve corresponder ao Formato de Entrada da Data selecionado.
  • Se o campo Informe a data ficar vazio, é usada a data atual.
  • Sem nenhuma operação adicionada, a ação apenas retorna a data informada no formato DD/MM/YYYY HH:mm:ss.
  • As operações são aplicadas em cascata — o resultado de uma é a base da próxima.