RPAData e Hora

Calcular distância entre datas

Calcular distância entre datas

Calcula a diferença entre duas datas e retorna o resultado na unidade de tempo desejada. Ideal para medir prazos, calcular idades, contabilizar dias em atraso ou verificar há quanto tempo um evento ocorreu — sem precisar realizar cálculos manuais.

Opções

Data inicial

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

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

Formato de entrada de data

Selecione o formato da data inicial 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 de início do intervalo. Este campo é exibido apenas quando Usar uma data relativa à execução do robô? estiver definido como Não.

Data final

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

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

Formato de entrada de data

Selecione o formato da data final informada. 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 de fim do intervalo. Este campo é exibido apenas quando Usar uma data relativa à execução do robô? estiver definido como Não.

Unidade de tempo

Selecione a unidade na qual a diferença entre as datas será calculada: Dia, Semana, Mês ou Ano.

Retornos

Código Javascript

js

actions["id-da-acao"].value // diferença entre as datas na unidade selecionada (Número)

Seleção de campos

• value — valor numérico da distância entre as duas datas (Número)

Regras e Condições

• O resultado é calculado como a data final menos a data inicial, em unidades completas. Se a data inicial for posterior à data final, o valor retornado será negativo.
• Para cada data, 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.