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