$add（表达式操作符）

定义

$add

将数字相加或将数字和日期相加。如果其中一个参数是日期，$add 将其他参数视为要添加到日期的毫秒数。

$add 表达式的语法如下：

{ $add: [ <expression1>, <expression2>, ... ] }

参数可以是任何有效的表达式，只要它们解析为所有数字或数字和日期即可。 有关表达式的更多信息，请参阅表达式。

从 MongoDB 6.1 开始，您可以优化 $add 操作。若要提高性能，请在参数列表的末尾对引用进行分组。例如，

$add: [ 1, 2, 3, '$a', '$b', '$c' ]

行为

当混合输入类型时，$add 会将较小的输入类型提升为两者中较大的输入类型。当一个类型表示更广泛的值时，该类型被视为较大。数字类型从小到大的顺序为：integer → long → double → decimal

较大的输入类型也决定了结果类型，除非操作溢出，超出了较大数据类型所代表的范围。在溢出的情况下，$add 按照以下顺序推送结果：

• 如果较大的输入类型为 integer，则结果类型将提升为 long。

• 如果较大的输入类型为 long，则结果类型将提升为 double。

• 如果较大的类型是 double 或 decimal，则溢出结果表示为 + 或 - 无穷大。没有对结果进行类型推送。

混合使用日期和非整数操作数时，$add 操作符会从左到右计算表达式大量的值，并在将数值添加到Date 值之前进行四舍五入。有关详细信息，请参阅向日期添加非整数值。

示例

下面的示例使用包含以下文档的 sales 集合：

db.sales.insertMany( [
   { _id : 1, "item" : "abc", "price" : 10, "fee" : 2, date: ISODate("2014-03-01T08:00:00Z") },
   { _id : 2, "item" : "jkl", "price" : 20, "fee" : 1, date: ISODate("2014-03-01T09:00:00Z") },
   { _id : 3, "item" : "xyz", "price" : 5,  "fee" : 0, date: ISODate("2014-03-15T09:00:00Z") }
] )

db.sales.aggregate(
   [
     { $project: { item: 1, total: { $add: [ "$price", "$fee" ] } } }
   ]
)

{ "_id" : 1, "item" : "abc", "total" : 12 }
{ "_id" : 2, "item" : "jkl", "total" : 21 }
{ "_id" : 3, "item" : "xyz", "total" : 5 }

db.sales.aggregate(
   [
     { $project: { item: 1, billing_date: { $add: [ "$date", 3*24*60*60000 ] } } }
   ]
)

{ "_id" : 1, "item" : "abc", "billing_date" : ISODate("2014-03-04T08:00:00Z") }
{ "_id" : 2, "item" : "jkl", "billing_date" : ISODate("2014-03-04T09:00:00Z") }
{ "_id" : 3, "item" : "xyz", "billing_date" : ISODate("2014-03-18T09:00:00Z") }

db.sales.aggregate(
   [
      { $project: { item: 1, result: { $add: [ 1.5, 1.6, "$date", 1.5, 1.5 ] } } }
   ]
)

{ "_id" : 1, "item" : 'abc', "result" : ISODate("2014-03-01T08:00:00.007Z") }
{ "_id" : 2, "item" : 'jkl', "result" : ISODate("2014-03-01T09:00:00.007Z") }
{ "_id" : 3, "item" : 'xyz', "result" : ISODate("2014-03-15T09:00:00.007Z") }