$multiplicar (agregação)

Definição

$multiply

Multiplica números juntos e retorna o resultado. Passe os argumentos para $multiply em uma array.

A expressão $multiply tem a seguinte sintaxe:

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

Os argumentos podem ser qualquer expressão válida, desde que produzam números. Para mais informações sobre expressões, consulte Operadores de Expressão.

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

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

Comportamento

Quando os tipos de entrada são misturados, $multiply 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, $multiply 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.

Exemplo

Considere uma collection sales com os seguintes documentos:

{ "_id" : 1, "item" : "abc", "price" : 10, "quantity": 2, date: ISODate("2014-03-01T08:00:00Z") }
{ "_id" : 2, "item" : "jkl", "price" : 20, "quantity": 1, date: ISODate("2014-03-01T09:00:00Z") }
{ "_id" : 3, "item" : "xyz", "price" : 5, "quantity": 10, date: ISODate("2014-03-15T09:00:00Z") }

A agregação a seguir usa a expressão $multiply no pipeline $project para multiplicar os campos price e quantity:

db.sales.aggregate(
   [
     { $project: { date: 1, item: 1, total: { $multiply: [ "$price", "$quantity" ] } } }
   ]
)

A operação retorna os seguintes resultados:

{ "_id" : 1, "item" : "abc", "date" : ISODate("2014-03-01T08:00:00Z"), "total" : 20 }
{ "_id" : 2, "item" : "jkl", "date" : ISODate("2014-03-01T09:00:00Z"), "total" : 20 }
{ "_id" : 3, "item" : "xyz", "date" : ISODate("2014-03-15T09:00:00Z"), "total" : 50 }