函 ROUND 數會回傳一個數值,並將其四捨五入至最接近的整數值或第二個可選參數所指示的精度。
Azure Cosmos 資料庫系統的函式,回傳四捨五入至最接近整數的數字。
語法
ROUND(<numeric_expr1> [, <numeric_expr2>])
Arguments
| Description | |
|---|---|
numeric_expr1 |
一個數值表達式,用來四捨五入。 |
numeric_expr2 |
(選用) 一個數值表達式,用來設定四捨五入的精度。 正值會四捨五入到小數點右邊的同位數,四 0 捨五入到最接近的整數,負數值則四捨五入到小數點左側。 若省略,該值會四捨五入至最接近的整數。 |
傳回類型
傳回數值運算式。
範例
本節包含如何使用此查詢語言建構的範例。
將數字四捨五入到最接近的整數
在此範例中,正數和負數會四捨五入至最接近的整數。
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
}
]
四捨五入至指定精度
以下範例使用可選的第二個參數來控制四捨五入精度。
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
}
]
備註
- 此功能受益於範圍索引的使用。 如需詳細資訊,請參閱 範圍索引。
- 執行的四捨五入運算會遵循遠離零的中間點四捨五入。 如果輸入是正好介於兩個整數之間的數值運算式,則結果是距離 0 的最接近的整數值。 例如
-6.5 to -7, -0.5 to -1, 0.5 to 1, 6.5 to 7。