> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.medemerge.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# datetimeDiff

> Quanto tempo vai de uma data a outra, em minutos, horas, dias, meses ou anos inteiros.

`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

```text theme={null}
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.

## Exemplos

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 |

### Tempo de espera, em minutos

```text theme={null}
datetimeDiff([chegada], [inicio_atendimento], "minute")
```

Resultado: **42**.

### Tempo de permanência, em dias

```text theme={null}
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.

### Idade, em anos

```text theme={null}
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.

### Espera longa, num filtro

```text theme={null}
datetimeDiff([chegada], [inicio_atendimento], "minute") > 30
```

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

## Limitações

* 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.

## Relacionadas

* [datetimeAdd](/expressoes/funcoes#datetimeadd) e [datetimeSubtract](/expressoes/funcoes#datetimesubtract): somar ou tirar tempo de uma data.
* [interval](/expressoes/funcoes#interval): um filtro dos últimos dias, semanas ou meses.
* Na planilha, `DATADIF`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.