该 ROUND 函数返回一个数值舍入到最接近的整数值或可选的第二个参数指示的精度。
一个 Azure Cosmos DB 系统函数,返回舍入到最接近整数的数字。
Syntax
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。