$add (agregaçã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.
Exemplos
Os exemplos a seguir utilizam uma coleção sales
com os seguintes documentos:
{ "_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") }
Adicionar números
A seguinte agregação utiliza a expressão $add
no pipeline do $project
para calcular o custo total:
db.sales.aggregate( [ { $project: { item: 1, total: { $add: [ "$price", "$fee" ] } } } ] )
A operação retorna os seguintes resultados:
{ "_id" : 1, "item" : "abc", "total" : 12 } { "_id" : 2, "item" : "jkl", "total" : 21 } { "_id" : 3, "item" : "xyz", "total" : 5 }
Executar adição em uma data
A agregação a seguir usa a expressão $add
para calcular o billing_date
adicionando 3*24*60*60000
milissegundos (ou seja, 3 dias) para o campo date
:
db.sales.aggregate( [ { $project: { item: 1, billing_date: { $add: [ "$date", 3*24*60*60000 ] } } } ] )
A operação retorna os seguintes resultados:
{ "_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") }