Diferença entre duas datas
O robô «Diferença entre duas datas» calcula quanto tempo passou entre a data 1 e a data 2 na unidade escolhida: dias, horas, minutos ou meses completos (dias por padrão). Retorna a diferença com sinal (negativa se a data 2 for anterior à data 1), seu valor absoluto e a quantidade de dias completos. É usado em processos de negócios e robôs do Bitrix24 para calcular prazos.
O robô calcula a diferença entre duas datas e retorna imediatamente três valores para verificações e cálculos posteriores. As entradas são data 1 (início), data 2 (fim) e a unidade: days, horas, minutos ou months (meses completos); se a unidade não for definida, são usados dias. As saídas são: diff — a diferença com sinal na unidade escolhida (negativa se a data 2 for anterior à data 1), diff_absolute — a mesma diferença como valor absoluto, sempre positivo, e days — a quantidade de dias completos entre as datas. Use para calcular quantos dias um negócio está em uma etapa, a idade de um lead desde a data de criação ou quantas horas faltam para o prazo de uma tarefa. Se uma das datas não puder ser interpretada, o robô retorna zeros. O valor diff é prático de comparar com um limite na condição da próxima etapa do processo de negócios.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Data 1 (início) | date | sim | |
| Data 2 (fim) | date | sim | |
| Unidade: days / hours / minutes / months (padrão: days) | string | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Diferença (pode ser negativa se data2 < data1) | int |
| Diferença (sempre positiva) | int |
| Dias completos (sempre) | int |
Cenário: controle do tempo de um negócio em uma etapa
- Um negócio entra na etapa «Em andamento»
- O robô calcula a diferença entre a data de criação e a data atual em dias
- Se diff for maior que 7, o processo cria uma tarefa de lembrete para o responsável