$add ( operador de expressão )

Definição

$add

Adiciona números ou adiciona números e uma data. Se um dos argumentos for uma data, $add trata os outros argumentos como milissegundos a serem adicionados à data.

A expressão $add tem a seguinte sintaxe:

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

Os argumentos podem ser qualquerexpressão válida, desde que sejam produzidos todos os números ou números e uma data. Para mais informações sobre expressões, consulte Expressões.

A partir do MongoDB 6.1 você pode otimizar a operação $add . Para melhorar o desempenho, agrupe as referências no final da lista de argumentos. Por exemplo,

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

Comportamento

Quando os tipos de entrada são misturados, $add promove o tipo de entrada menor para o maior dos dois. Um tipo é considerado maior quando representa uma faixa mais ampla de valores. A ordem dos tipos numéricos do menor para o maior é: inteiro → longo → double → decimal

O maior dos tipos de entrada também determina o tipo de resultado, a menos que a operação se exceda e esteja além da faixa representada por esse tipo de dados maior. Em casos de excesso, $add promove o resultado de acordo com a seguinte ordem:

• Se o tipo de entrada maior for integer, o tipo de resultado será promovido para long.

• Se o tipo de entrada maior for long, o tipo de resultado será promovido para double.

• Se o tipo maior for double ou decimal, o resultado do excesso será representado como + ou - infinito. Não há nenhum tipo de promoção do resultado.

Ao misturar operandos de Data e não inteiros, o $add operador avalia a array de expressões da esquerda para a direita e arredonda os valores numéricos antes de adicioná-los ao Date valor. Para obter mais informações, consulte Adicionar valores não inteiros a uma data.

Exemplos

Os exemplos a seguir utilizam uma coleção sales com os seguintes documentos:

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