En MongoDB, el $add
el operador de canalización de agregación suma valores juntos. Tales valores pueden ser números, o pueden ser números y una fecha.
El $add
El operador acepta los valores como argumentos. Los argumentos pueden ser cualquier expresión válida siempre que se resuelvan en todos los números o en números y una fecha.
Datos de muestra
Supongamos que tenemos una colección llamada data
con los siguientes documentos:
{ "_id" : 1, "a" : 100, "b" : 50, "c" : ISODate("2021-01-03T23:30:15.100Z") } { "_id" : 2, "a" : 20000, "b" : 15, "c" : ISODate("2019-12-08T04:00:20.112Z") } { "_id" : 3, "a" : 1700, "b" : 3, "c" : ISODate("2020-09-24T10:45:01.007Z") }
Añadir números
Podemos usar el $add
operador para agregar el a
y b
campos juntos.
Ejemplo:
db.data.aggregate(
[
{ $project: {
_id: 0,
a: 1,
b: 1,
result: {
$add: [ "$a", "$b" ] } }
}
]
)
Resultado:
{ "a" : 100, "b" : 50, "result" : 150 } { "a" : 20000, "b" : 15, "result" : 20015 } { "a" : 1700, "b" : 3, "result" : 1703 }
Añadir números con fecha
Si uno de los argumentos es una fecha, los otros argumentos se tratan como milisegundos para agregar a la fecha.
Ejemplo:
db.data.aggregate(
[
{ $project: {
_id: 0,
a: 1,
c: 1,
result: {
$add: [ "$a", "$c" ] } }
}
]
).pretty()
Resultado:
{ "a" : 100, "c" : ISODate("2021-01-03T23:30:15.100Z"), "result" : ISODate("2021-01-03T23:30:15.200Z") } { "a" : 20000, "c" : ISODate("2019-12-08T04:00:20.112Z"), "result" : ISODate("2019-12-08T04:00:40.112Z") } { "a" : 1700, "c" : ISODate("2020-09-24T10:45:01.007Z"), "result" : ISODate("2020-09-24T10:45:02.707Z") }
Podemos ver que los valores numéricos en el a
campo se han agregado como milisegundos a la c
campo.
Más argumentos
Los ejemplos anteriores suman dos valores, pero puede agregar más si es necesario.
Este es un ejemplo de cómo sumar los tres campos:
db.data.aggregate(
[
{ $project: {
_id: 0,
a: 1,
b: 1,
c: 1,
result: {
$add: [ "$a", "$b", "$c" ] } }
}
]
).pretty()
Resultado:
{ "a" : 100, "b" : 50, "c" : ISODate("2021-01-03T23:30:15.100Z"), "result" : ISODate("2021-01-03T23:30:15.250Z") } { "a" : 20000, "b" : 15, "c" : ISODate("2019-12-08T04:00:20.112Z"), "result" : ISODate("2019-12-08T04:00:40.127Z") } { "a" : 1700, "b" : 3, "c" : ISODate("2020-09-24T10:45:01.007Z"), "result" : ISODate("2020-09-24T10:45:02.710Z") }
Esta vez, ambos números se agregaron a la fecha.
Solo se permite una fecha
Aunque puede agregar muchas expresiones juntas, solo puede incluir una fecha. Pasar varias fechas da como resultado un error.
Ejemplo:
db.data.aggregate(
[
{ $project: {
_id: 0,
a: 1,
b: 1,
c: 1,
result: {
$add: [ "$c", ISODate("2020-09-24T10:45:01.007Z") ] } }
}
]
).pretty()
Resultado:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "only one date allowed in an $add expression", "code" : 16612, "codeName" : "Location16612" } : aggregate failed : [email protected]/mongo/shell/utils.js:25:13 [email protected]/mongo/shell/assert.js:18:14 [email protected]/mongo/shell/assert.js:618:17 [email protected]/mongo/shell/assert.js:708:16 [email protected]/mongo/shell/db.js:266:5 [email protected]/mongo/shell/collection.js:1046:12 @(shell):1:1
Pasar Sin Argumentos
No pasar argumentos a $add
da como resultado 0
siendo devuelto.
Ejemplo:
db.data.aggregate(
[
{ $project: {
result: {
$add: [ ] } }
}
]
)
Resultado:
{ "_id" : 1, "result" : 0 } { "_id" : 2, "result" : 0 } { "_id" : 3, "result" : 0 }
Pasar valores nulos
Pasando null
da como resultado null
.
Ejemplo:
db.data.aggregate(
[
{ $project: {
result: {
$add: [ null ] } }
}
]
)
Resultado:
{ "_id" : 1, "result" : null } { "_id" : 2, "result" : null } { "_id" : 3, "result" : null }