datetimeDiff

datetimeDiff mede quanto tempo vai de uma data a outra, numa unidade escolhida. É a função dos tempos de espera, de permanência e das idades.

Sintaxe

datetimeDiff(início, fim, unidade)

Argumento	O que é
`início`	A data de partida: uma coluna ou conta de data.
`fim`	A data de chegada.
`unidade`	Entre aspas: `"year"`, `"quarter"`, `"month"`, `"week"`, `"day"`, `"hour"`, `"minute"` ou `"second"`.

O resultado é fim menos início, em unidades inteiras: 90 minutos são 1 hora. Quando fim vem antes de início, o resultado é negativo.

Os exemplos usam colunas fictícias.

chegada	inicio_atendimento	alta	nascimento
10/03/2026 08:10	10/03/2026 08:52	14/03/2026 11:00	22/07/1980

datetimeDiff([chegada], [inicio_atendimento], "minute")

Resultado: 42.

datetimeDiff([chegada], [alta], "day")

Resultado: 4. De 08:10 do dia 10 a 11:00 do dia 14 são 4 dias e algumas horas, e só os dias inteiros contam.

datetimeDiff([nascimento], today(), "year")

Em 28/09/2026, resultado: 46. Mês e ano contam pelo calendário: o aniversário de 2026 já passou, então o ano conta.

datetimeDiff([chegada], [inicio_atendimento], "minute") > 30

Num filtro por expressão, deixa só os atendimentos com mais de meia hora de espera.

As unidades contam inteiras, truncadas para zero. Para a espera com fração de hora, meça em minutos e divida: datetimeDiff([chegada], [inicio_atendimento], "minute") / 60.
Em algumas fontes de dados, mês, trimestre e ano contam pelo dia, sem olhar a hora.
Data menos data ([alta] - [chegada]) não dá número, e o editor sugere o datetimeDiff no lugar.