NumberBin (consulta NoSQL)

SE APLICA A: NoSQL

Redondea el valor de la expresión numérica hasta un múltiplo del tamaño de rango especificado.

Sintaxis

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

Argumentos

	Descripción
numeric_expr	Una expresión numérica que se evalúa y, a continuación, el valor resultante se redondea a un múltiplo del tamaño de rango especificado.
bin_size(Opcional)	Un valor numérico que especifica el tamaño del contenedor que se va a usar al redondear el valor. Este valor, si no se especifica, es 1 de manera predeterminada.

Tipos de valores devueltos

Devuelve un valor numérico.

Ejemplos

En este primer ejemplo se discretiza un único número estático con varios tamaños de rango.

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
  }
]

En el ejemplo siguiente, se usa un campo de un elemento existente.

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

Esta consulta redondea el campo anterior mediante la función.

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
  }
]

Comentarios

• Esta función devuelve undefined si el tamaño de rango especificado es 0.
• El tamaño de rango predeterminado es 1. Este tamaño de intervalo devuelve eficazmente un valor numérico redondeado al siguiente entero.

Consulte también

• System functions (Funciones del sistema)
• ROUND