NUMBERBIN – Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A NUMBERBIN função calcula o valor de entrada arredondado para um múltiplo do tamanho especificado.

Sintaxe

NUMBERBIN(<numeric_expr> [, <bin_size>])

Arguments

	Description
numeric_expr	Uma expressão numérica, que é avaliada e, em seguida, o valor resultante é arredondado para um múltiplo do tamanho da lixeira especificado.
bin_size	Um valor numérico que especifica o tamanho da lixeira a ser usado ao arredondar o valor. Esse valor numérico usa como padrão se 1 não for especificado.

Tipos de retorno

Retorna um valor numérico.

Exemplos

Esta seção contém exemplos de como usar este constructo de linguagem de consulta.

Bin um número com vários tamanhos de compartimento

Neste exemplo, a NUMBERBIN função é usada para arredondar um número para vários tamanhos de compartimento.

SELECT VALUE {
  roundToNegativeHundreds: NUMBERBIN(37.752, -100),
  roundToTens: NUMBERBIN(37.752, 10),
  roundToOnes: NUMBERBIN(37.752, 1),
  roundToZeroes: NUMBERBIN(37.752, 0),
  roundToOneTenths: NUMBERBIN(37.752, 0.1),
  roundToOneHundreds: NUMBERBIN(37.752, 0.01)
}

[
  {
    "roundToNegativeHundreds": 100,
    "roundToTens": 30,
    "roundToOnes": 37,
    "roundToOneTenths": 37.7,
    "roundToOneHundreds": 37.75
  }
]