$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

行为

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

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

例子

使用以下文档创建名为 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 }