ROUND- Linguaggio di query in Cosmos DB (in Azure e Fabric)

La ROUND funzione restituisce un valore numerico arrotondato al valore intero più vicino o alla precisione indicata dal secondo argomento facoltativo.

Funzione di sistema di Azure Cosmos DB che restituisce il numero arrotondato al numero intero più vicino.

Sintassi

ROUND(<numeric_expr1> [, <numeric_expr2>])

Arguments

Description
numeric_expr1 Espressione numerica da arrotondare.
numeric_expr2 (Facoltativo) Espressione numerica che imposta la precisione su cui arrotondare. Un valore positivo arrotonda a tale numero di cifre a destra del separatore decimale, 0 arrotonda all'intero più vicino e un valore negativo arrotonda a sinistra del separatore decimale. Se omesso, il valore viene arrotondato all'intero più vicino.

Tipi restituiti

Restituisce un'espressione numerica.

Esempi

Questa sezione contiene esempi di come usare questo costrutto di linguaggio di query.

Arrotondare i numeri al numero intero più vicino

In questo esempio, i numeri positivi e negativi vengono arrotondati all'intero più vicino.

SELECT VALUE {
  roundTwoPointFour: ROUND(2.4),
  roundTwoPointSix: ROUND(2.6),
  roundTwoPointFive: ROUND(2.5),
  roundNegativeTwoPointFour: ROUND(-2.4),
  roundNegativeTwoPointSix: ROUND(-2.6)
}
[
  {
    "roundTwoPointFour": 2,
    "roundTwoPointSix": 3,
    "roundTwoPointFive": 3,
    "roundNegativeTwoPointFour": -2,
    "roundNegativeTwoPointSix": -3
  }
]

Arrotondare a una precisione specificata

Nell'esempio seguente viene utilizzato il secondo argomento facoltativo per controllare la precisione di arrotondamento.

SELECT VALUE {
    case1: ROUND(1234567, -2),
    case2: ROUND(1234567, 0),
    case3: ROUND(1234567, 2),
    case4: ROUND(1234.567, -2),
    case5: ROUND(1234.567, 0),
    case6: ROUND(1234.567, 2)
}
[
  {
    "case1": 1234600,
    "case2": 1234567,
    "case3": 1234567,
    "case4": 1200,
    "case5": 1235,
    "case6": 1234.57
  }
]

Osservazioni:

  • Questa funzione trae vantaggio dall'uso di un indice di intervallo. Per altre informazioni, vedere Indici di intervallo.
  • L'operazione di arrotondamento eseguita effettua l’arrotondamento nel punto medio allontanandosi da zero. Se l'input è un'espressione numerica che cade esattamente tra due interi, il risultato è il valore intero più vicino a 0. Ad esempio, -6.5 to -7, -0.5 to -1, 0.5 to 1, 6.5 to 7.