$add（集計）

定義

$add

数値を加算するか、数値と日付を加算します。引数の 1 つが日付の場合、 $add は他の引数を日付に追加するミリ秒として扱います。

$add式の構文は次のとおりです。

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

引数は、すべて数値か、数値と日付に変換できるかぎり、どのような有効な 式でも使用できます。式の詳細については「式演算子」を参照してください。

MongoDB 6.1 以降では、 $add 操作を最適化できます。パフォーマンスを向上させるには、参照を引数リストの最後にグループ化します。たとえば、

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

動作

入力型が混在している場合、$add は小さい入力型を 2 つのうち大きい方に昇格させます。型が大きいとみなされるのは、より広い範囲の値を表す場合です。数値型の最小値から最大値の順は、integer → long → double → decimal です。

演算がオーバーフローして、大きい方のデータ型で表される範囲を超えない限り、大きい方の入力型によって結果型も決まります。オーバーフローの場合、$add は以下の順序に従って結果を昇格させます。

• より大きな入力型が integer の場合、結果型は long に昇格します。

• より大きな入力型が long の場合、結果型は double に昇格します。

• 大きい方の型が double または decimal の場合、オーバーフロー結果は正または負の無限大として表されます。結果型の昇格は行われません。

Date と非整数のオペランドを混在させる場合、$add は演算を実行する前に非整数の値を最も近い整数に四捨五入します。

例

次の例では、次のドキュメントを含むsalesコレクションを使用します。

{ "_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") }