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

# Offset

> O valor de uma linha anterior ou seguinte do resultado agrupado: crescimento e variação entre períodos.

`Offset` devolve o valor de uma medida numa linha anterior ou seguinte do resultado. Serve para calcular a diferença entre um período e o anterior.

## Sintaxe

```text theme={null}
Offset(medida, deslocamento)
```

| Argumento | O que é |
| - | - |
| `medida` | Uma agregação, como `Sum([valor])` ou `Count()`. |
| `deslocamento` | Um número inteiro escrito, diferente de zero. `-1` é a linha de cima; `1`, a de baixo. |

`Offset` entra numa métrica de **Resumir**, e precisa de um agrupamento: é ele que define a ordem das linhas.

## Exemplos

Agrupado por mês de `[chegada]`, com uma métrica `Count()`:

| Mês | Count |
| - | - |
| janeiro | 1.240 |
| fevereiro | 1.098 |
| março | 1.310 |

### O período anterior

```text theme={null}
Offset(Count(), -1)
```

| Mês | resultado |
| - | - |
| janeiro | *vazio* |
| fevereiro | 1.240 |
| março | 1.098 |

A primeira linha não tem linha anterior, e fica vazia.

### Diferença para o período anterior

```text theme={null}
Count() - Offset(Count(), -1)
```

Em fevereiro, 1.098 − 1.240 = **−142**.

### Variação percentual

```text theme={null}
(Count() - Offset(Count(), -1)) / Offset(Count(), -1)
```

Em março: (1.310 − 1.098) / 1.098 = **0,193**, ou 19,3% com o formato **Percentual (× 100)**.

## Limitações

* Sem agrupamento, `Offset` é recusado: não há linha anterior.
* A linha anterior é a de cima **no resultado**, e não a data anterior. Se um mês não tem nenhuma linha, ele some do resultado, e o mês seguinte passa a ser comparado com dois meses antes.
* O filtro de data do indicador ou do painel vale antes do `Offset`: com o filtro de janeiro a março, janeiro não tem com o que comparar.
* Com mais de um agrupamento, como setor e mês, as linhas seguem a ordem de todos eles, e a linha de cima do primeiro mês de um setor é o último mês do setor anterior.

<Tip>
  Para comparar com o **ano anterior**, use [SamePeriodLastYear](/expressoes/funcoes/sameperiodlastyear). Ele recua a data, e não a linha, e acompanha o filtro de data do painel.
</Tip>

## Relacionadas

* [SamePeriodLastYear](/expressoes/funcoes/sameperiodlastyear): o mesmo período do ano anterior.
* [CumulativeSum](/expressoes/funcoes#cumulativesum) e [CumulativeCount](/expressoes/funcoes#cumulativecount): o acumulado até cada linha.
* Em SQL, `LAG` e `LEAD`.


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