Compartilhar via

NumberBin (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Arredonda o valor da expressão numérica para baixo para um múltiplo de tamanho de compartimento especificado.

Sintaxe

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

Argumentos

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

Tipos de retorno

Retorna um valor numérico.

Exemplos

Este primeiro exemplo compartimentaliza um único número estático com 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
  }
]

Este próximo exemplo usa um campo de um item existente.

[
  {
    "name": "Ignis Cooking System",
    "price": 155.23478,
    "category": "portable-cooking"
  }
]

Essa consulta arredonda o campo anterior usando a função.

SELECT
    p.name,
    NumberBin(p.price, 0.01) AS price
FROM
    products p
WHERE
    p.category = "portable-cooking"

[
  {
    "name": "Ignis Cooking System",
    "price": 155.23
  }
]

Comentários

  • Essa função retorna undefined se o tamanho do compartimento especificado for 0.
  • O tamanho do compartimento padrão é 1. Esse tamanho de compartimento retorna efetivamente um valor numérico arredondado para o próximo inteiro.

Confira também