NumberBin (consulta NoSQL)

Artigo
02/27/2024

APLICA-SE A: NoSQL

Arredonda o valor da expressão numérica para um múltiplo de tamanho de contentor 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 contentor especificado.
`bin_size`(Opcional)	Um valor numérico que especifica o tamanho da classe a utilizar ao arredondar o valor. Este valor numérico é predefinido para `1` se não for especificado.

Tipos de devolução

Devolve um valor numérico.

Exemplos

Este primeiro exemplo bins a single static number with various bin sizes.

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 exemplo seguinte utiliza um campo de um item existente.

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

Esta consulta arredonda o campo anterior com 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
  }
]

Observações

Esta função devolve undefined se o tamanho do contentor especificado for 0.
O tamanho predefinido da caixa é 1. Este tamanho da classe devolve efetivamente um valor numérico arredondado para o número inteiro seguinte.