> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Documentação sobre funções de janela de tempo
# Funções de janela de tempo
export const CloudNotSupportedBadge = () => {
return
;
};
As funções de janela de tempo retornam o limite inferior inclusivo e o limite superior exclusivo da janela correspondente.
As funções para trabalhar com [WindowView](/pt-BR/reference/statements/create/view#window-view) estão listadas abaixo:
{/*AUTOGENERATED_START*/}
## hop
Introduzido em: v21.12.0
Uma janela de tempo do tipo hop tem uma duração fixa (`window_interval`) e avança em um intervalo de salto especificado (`hop_interval`). Se o `hop_interval` for menor que o `window_interval`, as janelas hop se sobrepõem. Assim, os registros podem ser atribuídos a várias janelas.
Como um registro pode ser atribuído a várias janelas hop, a função retorna apenas o limite da primeira janela quando a função hop é usada sem WINDOW VIEW.
**Sintaxe**
```sql theme={null}
hop(time_attr, hop_interval, window_interval[, timezone])
```
**Argumentos**
* `time_attr` — Data e hora. [`DateTime`](/pt-BR/reference/data-types/datetime)
* `hop_interval` — Intervalo de hop positivo. [`Interval`](/pt-BR/reference/data-types/int-uint)
* `window_interval` — Intervalo de janela positivo. [`Interval`](/pt-BR/reference/data-types/int-uint)
* `timezone` — Opcional. Nome do fuso horário. [`String`](/pt-BR/reference/data-types/string)
**Valor retornado**
Retorna o limite inferior inclusivo e o limite superior exclusivo da janela hop correspondente. [`Tuple(DateTime, DateTime)`](/pt-BR/reference/data-types/tuple)
**Exemplos**
**Janela hop**
```sql title=Query theme={null}
SELECT hop(now(), INTERVAL '1' DAY, INTERVAL '2' DAY)
```
```response title=Response theme={null}
('2024-07-03 00:00:00','2024-07-05 00:00:00')
```
## hopEnd
Introduzido em: v22.1.0
Retorna o limite superior exclusivo da janela hop correspondente.
Como um registro pode ser atribuído a várias janelas hop, a função retorna apenas o limite da primeira janela quando a função hop é usada sem `WINDOW VIEW`.
**Sintaxe**
```sql theme={null}
hopEnd(time_attr, hop_interval, window_interval[, timezone])
```
**Argumentos**
* `time_attr` — Data e hora. [`DateTime`](/pt-BR/reference/data-types/datetime)
* `hop_interval` — Intervalo de hop positivo. [`Interval`](/pt-BR/reference/data-types/int-uint)
* `window_interval` — Intervalo de janela positivo. [`Interval`](/pt-BR/reference/data-types/int-uint)
* `timezone` — Opcional. Nome do fuso horário. [`String`](/pt-BR/reference/data-types/string)
**Valor retornado**
Retorna o limite superior exclusivo da janela hop correspondente. [`DateTime`](/pt-BR/reference/data-types/datetime)
**Exemplos**
**Fim da janela hop**
```sql title=Query theme={null}
SELECT hopEnd(now(), INTERVAL '1' DAY, INTERVAL '2' DAY)
```
```response title=Response theme={null}
2024-07-05 00:00:00
```
## hopStart
Introduzido em: v22.1.0
Retorna o limite inferior inclusivo da janela hop correspondente.
Como um registro pode ser atribuído a várias janelas hop, a função retorna apenas o limite da primeira janela quando a função hop é usada sem `WINDOW VIEW`.
**Sintaxe**
```sql theme={null}
hopStart(time_attr, hop_interval, window_interval[, timezone])
```
**Argumentos**
* `time_attr` — Data e hora. [`DateTime`](/pt-BR/reference/data-types/datetime)
* `hop_interval` — Intervalo de hop positivo. [`Interval`](/pt-BR/reference/data-types/int-uint)
* `window_interval` — Intervalo de janela positivo. [`Interval`](/pt-BR/reference/data-types/int-uint)
* `timezone` — Opcional. Nome do fuso horário. [`String`](/pt-BR/reference/data-types/string)
**Valor retornado**
Retorna o limite inferior inclusivo da janela hop correspondente. [`DateTime`](/pt-BR/reference/data-types/datetime)
**Exemplos**
**Início da janela hop**
```sql title=Query theme={null}
SELECT hopStart(now(), INTERVAL '1' DAY, INTERVAL '2' DAY)
```
```response title=Response theme={null}
2024-07-03 00:00:00
```
## tumble
Introduzido em: v21.12.0
Uma janela de tempo do tipo tumble atribui registros a janelas contínuas, sem sobreposição, com duração fixa (`interval`).
**Sintaxe**
```sql theme={null}
tumble(time_attr, interval[, timezone])
```
**Argumentos**
* `time_attr` — Data e hora. [`DateTime`](/pt-BR/reference/data-types/datetime)
* `interval` — Intervalo da janela, em Interval. [`Interval`](/pt-BR/reference/data-types/int-uint)
* `timezone` — Opcional. Nome do fuso horário. [`String`](/pt-BR/reference/data-types/string)
**Valor retornado**
Retorna o limite inferior inclusivo e o limite superior exclusivo da janela tumbling correspondente. [`Tuple(DateTime, DateTime)`](/pt-BR/reference/data-types/tuple)
**Exemplos**
**Janela tumbling**
```sql title=Query theme={null}
SELECT tumble(now(), toIntervalDay('1'))
```
```response title=Response theme={null}
('2024-07-04 00:00:00','2024-07-05 00:00:00')
```
## tumbleEnd
Introduzido em: v22.1.0
Retorna o limite superior exclusivo da janela tumbling correspondente.
**Sintaxe**
```sql theme={null}
tumbleEnd(time_attr, interval[, timezone])
```
**Argumentos**
* `time_attr` — Data e hora. [`DateTime`](/pt-BR/reference/data-types/datetime)
* `interval` — Intervalo da janela, em `Interval`. [`Interval`](/pt-BR/reference/data-types/int-uint)
* `timezone` — Opcional. Nome do fuso horário. [`String`](/pt-BR/reference/data-types/string)
**Valor retornado**
Retorna o limite superior exclusivo da janela tumbling correspondente. [`DateTime`](/pt-BR/reference/data-types/datetime)
**Exemplos**
**Fim da janela tumbling**
```sql title=Query theme={null}
SELECT tumbleEnd(now(), toIntervalDay('1'))
```
```response title=Response theme={null}
2024-07-05 00:00:00
```
## tumbleStart
Introduzido em: v22.1.0
Retorna o limite inferior inclusivo da janela tumbling correspondente.
**Sintaxe**
```sql theme={null}
tumbleStart(time_attr, interval[, timezone])
```
**Argumentos**
* `time_attr` — Data e hora. [`DateTime`](/pt-BR/reference/data-types/datetime)
* `interval` — Intervalo da janela, em Interval. [`Interval`](/pt-BR/reference/data-types/int-uint)
* `timezone` — Opcional. Nome do fuso horário. [`String`](/pt-BR/reference/data-types/string)
**Valor retornado**
Retorna o limite inferior inclusivo da janela tumbling correspondente. [`DateTime`](/pt-BR/reference/data-types/datetime)
**Exemplos**
**Início da janela tumbling**
```sql title=Query theme={null}
SELECT tumbleStart(now(), toIntervalDay('1'))
```
```response title=Response theme={null}
2024-07-04 00:00:00
```
## windowID
Introduzido em: v22.1.0
Retorna o identificador da window correspondente do tipo tumbling ou hopping.
Esta função só pode ser usada com `WINDOW VIEW`.
**Sintaxe**
```sql theme={null}
windowID(time_attr, interval[, timezone])
```
**Argumentos**
* `time_attr` — Data e hora. [`DateTime`](/pt-BR/reference/data-types/datetime)
* `interval` — Intervalo da janela, em `Interval`. [`Interval`](/pt-BR/reference/data-types/int-uint)
* `timezone` — Opcional. Nome do fuso horário. [`String`](/pt-BR/reference/data-types/string)
**Valor retornado**
Retorna o identificador da janela correspondente. [`UInt32`](/pt-BR/reference/data-types/int-uint)
**Exemplos**
**ID da janela**
```sql title=Query theme={null}
SELECT windowID(now(), toIntervalDay('1'))
```
```response title=Response theme={null}
```
## Conteúdo relacionado
* [Guias de casos de uso para séries temporais](/pt-BR/guides/use-cases/real-time-analytics/time-series)