/ /

$round（表达式操作符）

定义

$round

$round 将数字四舍五入为整数或到指定的小数位数。

$round 通过以下语法实现：

{ $round : [ <number>, <place> ] }

字段	类型	说明
`<number>`	数字	可以是解析为数字的任何有效表达式。具体而言，该表达式必须解析为整数、double、`decimal` 或 `long`。 `$round` 如果表达式解析为非数字数据类型，则返回错误。
`<place>`	整型	可选可为能解析为 -20 到 100（不含）之间的整数的任意有效表达式。例如 `-20 < place < 100`。如果未指定，则默认为 `0`。如果 `<place>` 解析为正整数，`$round` 会四舍五入到 `<place>` 位小数。例如，`$round : [1234.5678, 2]` 四舍五入到小数点后两位并返回 `1234.57`。如果 `<place>` 解析为负整数，`$round` 使用小数点左边的数字 `<place>` 进行四舍五入。例如，`$round : [1234.5678, -2]` 使用小数点左边的第二位数字 (`3`) 并返回 `1200`。如果 `<place>` 的绝对值等于或超过小数点左边的位数，`$round` 将返回 `0`。例如，`$round : [ 1234.5678, -4]` 指定小数点左边的第四位数字。这等于小数点左边的位数，返回 `0`。如果 `<place>` 解析为 `0`，`$round` 使用小数点右边的第一位数字进行四舍五入，并返回四舍五入后的整数值。例如，`$round : [1234.5678, 0]` 会返回 `1235`

行为

向偶数舍入

在对 5 值进行舍入时，$round 舍入到最接近的偶数值。例如，考虑以下示例文档：

{_id : 1, "value" : 10.5},
{_id : 2, "value" : 11.5},
{_id : 3, "value" : 12.5},
{_id : 4, "value" : 13.5}

$round : [ "$value", 0] 将返回以下内容：

{_id : 1, "value" : 10},
{_id : 2, "value" : 12},
{_id : 3, "value" : 12},
{_id : 4, "value" : 14}

值 10.5 最接近偶数值10，而值 11.5 和 12.5 最接近偶数值 12。与总是向上或向下舍入相比，舍入到最接近的偶数值可让舍入数据分布更加均匀。

浮点数的舍入精度

如果在小数点分隔符后打印一个具有 20 位的双精度点0.05，您将看到 0.05000000000000000278，它略大于 0.05，并四舍五入为 0.1。

MongoDB使用 IEEE 754 标准进行点计算，其行为与该标准一致。

如果精度要求较高的应用程序需要浮点数，请考虑使用 Decimal128 值。有关详细信息，请参阅BSON.Decimal128。

如果需要存储货币值，请考虑使用最低货币面值单位的整数。示例，使用带分或便士的整数而不是点。

返回的数据类型

返回的数据类型与输入表达式或值的数据类型相匹配。

`null`、`NaN` 和 `+/- Infinity`

如果第一个参数解析为 null 值或引用了缺失的字段，$round 将返回 null。
如果第一个参数解析为 NaN，$round 会返回 NaN。
如果第一个参数解析为负无穷大或正无穷大，$round 则会分别返回负无穷大或正无穷大。

例子	结果
`{ $round: [ NaN, 1] }`	`NaN`
`{ $round: [ null, 1] }`	`null`
`{ $round : [ Infinity, 1 ] }`	`Infinity`
`{ $round : [ -Infinity, 1 ] }`	`-Infinity`

例子

使用以下文档创建名为 samples 的集合：

db.samples.insertMany(
   [
     { _id: 1, value: 19.25 },
     { _id: 2, value: 28.73 },
     { _id: 3, value: 34.32 },
     { _id: 4, value: -45.39 }
   ]
)

以下聚合返回四舍五入到小数点后第一位的 value：
db.samples.aggregate([ { $project: { roundedValue: { $round: [ "$value", 1 ] } } } ])
操作返回以下结果：
{ "_id" : 1, "roundedValue" : 19.2 } { "_id" : 2, "roundedValue" : 28.7 } { "_id" : 3, "roundedValue" : 34.3 } { "_id" : 4, "roundedValue" : -45.4 }
以下聚合返回使用小数点左边第一位数字进行四舍五入的 value：
db.samples.aggregate([ { $project: { roundedValue: { $round: [ "$value", -1 ] } } } ])
操作返回以下结果：
{ "_id" : 1, "roundedValue" : 10 } { "_id" : 2, "roundedValue" : 20 } { "_id" : 3, "roundedValue" : 30 } { "_id" : 4, "roundedValue" : -50 }
以下聚合将返回四舍五入为整数的 value：
db.samples.aggregate([ { $project: { roundedValue: { $round: [ "$value", 0 ] } } } ])
操作返回以下结果：
{ "_id" : 1, "roundedValue" : 19 } { "_id" : 2, "roundedValue" : 29 } { "_id" : 3, "roundedValue" : 34 } { "_id" : 4, "roundedValue" : -45 }

后退

$reverseArray

来年

$rtrim

$round（表达式操作符）

定义

行为

向偶数舍入

浮点数的舍入精度

返回的数据类型

null、NaN 和 +/- Infinity

例子

`null`、`NaN` 和 `+/- Infinity`