$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 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") }