Pular para o conteúdo principal
Acessar Studio
Data 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 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​

Selecione o formato da data inicial informada. Este campo é exibido apenas quando Usar data relativa estiver definido como Não.

Informe a data inicial​

Informe a data de início do intervalo. Este campo é exibido apenas quando Usar data relativa estiver definido como Não.

Data final​

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

Selecione o formato da data final informada. Este campo é exibido apenas quando Usar data relativa estiver definido como Não.

Informe a data final​

Informe a data de fim do intervalo. Este campo é exibido apenas quando Usar data relativa estiver definido como Não.

Unidade de tempo​

Selecione a unidade na qual a diferença entre as datas será calculada. As opções incluem dias, semanas, meses, anos, horas, minutos e segundos.

Retornos​

Código customizado​

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 campo Unidade de tempo é obrigatório.
  • Para cada data, quando Usar data relativa for Não, os campos Formato de entrada e Data são obrigatórios.
  • O resultado é sempre um valor positivo — a ordem das datas não afeta o sinal do retorno.