operador between

  • Artigo

Filtra um conjunto de registros para dados que correspondem aos valores em um intervalo inclusivo.

between pode operar em qualquer expressão numérica, data e hora ou intervalo de tempo.

Syntax

T|whereExprbetween(leftRange..rightRange)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
T string ✔️ A entrada tabular cujos registros devem ser correspondidos. Por exemplo, o nome da tabela.
expr escalar ✔️ A expressão usada para filtrar.
leftRange int, long, real ou datetime ✔️ A expressão do intervalo esquerdo. O intervalo é inclusivo.
rightRange int, long, real, datetime ou timespan ✔️ A expressão do intervalo à direita. O intervalo é inclusivo.

Esse valor só poderá ser do tipo timespan se expr e leftRange forem ambos do tipo datetime. Confira o exemplo.

Retornos

Linhas em T para as quais o predicado de (expr>= leftRange e expr<= rightRange) é avaliado truecomo .

Exemplos

Filtrar valores numéricos

Executar a consulta

range x from 1 to 100 step 1
| where x between (50 .. 55)

Saída

x
50
51
52
53
54
55

Filtrar por data

Executar a consulta

StormEvents
| where StartTime between (datetime(2007-07-27) .. datetime(2007-07-30))
| count

Saída

Contagem
476

Filtrar por data e hora

Executar a consulta

StormEvents
| where StartTime between (datetime(2007-12-01T01:30:00) .. datetime(2007-12-01T08:00:00))
| count

Saída

Contagem
301

Filtrar usando um intervalo de tempo

Executar a consulta

StormEvents
| where StartTime between (datetime(2007-07-27) .. 3d)
| count

Saída

Contagem
476