$add (애그리게이션)

정의

$add

숫자를 합산하거나 숫자와 날짜를 추가합니다. 인수 중 하나가 날짜이면$add는 다른 인수를 날짜에 추가할 밀리초로 처리합니다.

$add 표현식의 구문은 다음과 같습니다.

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

인수는 모든 숫자 또는 숫자와 날짜로 해석되는 한 유효한 표현식 이 될 수 있습니다. 표현식에 대한 자세한 내용은 표현식 연산자를 참조하세요.

MongoDB 6.1부터 $add 작업을 최적화할 수 있습니다. 성능을 향상시키려면 인수 목록 끝에 참조를 그룹화하세요. 예를 들면 다음과 같습니다.

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

행동

입력 유형이 혼합되어 있는 경우 $add 는 더 작은 입력 유형을 둘 중 더 큰 입력 유형으로 승격시킵니다. 유형은 더 넓은 범위 의 값을 나타낼 때 더 큰 것으로 간주됩니다. 숫자 유형의 순서는 가장 작은 것부터 큰 것 순으로 다음과 같습니다: 정수 → 긴 → 이중 → 십진수

연산이 오버플로되어 더 큰 데이터 유형 이 나타내는 범위 를 벗어나지 않는 한, 입력 유형 중 더 큰 값에 따라 결과 유형도 결정됩니다. 오버플로의 경우 $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") }