$subtrair (agregação)

Nesta página

Definição

Comportamento
Exemplos

Definição

$subtract

Subtrai dois números para retornar a diferença ou duas datas para retornar a diferença, em milissegundos, ou uma data e um número, em milissegundos, para retornar a data resultante.

A expressão $subtract tem a seguinte sintaxe:

{ $subtract: [ <expression1>, <expression2> ] }

O segundo argumento é subtraído do primeiro argumento.

Os argumentos podem ser qualquerexpressão válida, desde que sejam números e/ou datas. Para subtrair um número de uma data, a data deve ser o primeiro argumento. Para obter mais informações sobre expressões, consulte Operadores de expressão.

Comportamento

A partir do MongoDB 5.0, o resultado terá o mesmo tipo que a entrada, exceto quando não puder ser representado com precisão nesse tipo. Nesses casos:

Um número inteiro de 32 bits será convertido para um número inteiro de 64 bits se o resultado for representável como um número inteiro de 64 bits.
Um inteiro de 32 bits será convertido em duplo se o resultado não for representável como um inteiro de 64 bits.
Um número inteiro de 64 bits será convertido em dobro se o resultado não for representável como um número inteiro de 64 bits.

Exemplos

Considere uma collection sales com os seguintes documentos:

db.sales.insertMany([
   { "_id" : 1, "item" : "abc", "price" : 10, "fee" : 2, "discount" : 5, "date" : ISODate("2014-03-01T08:00:00Z") },
   { "_id" : 2, "item" : "jkl", "price" : 20, "fee" : 1, "discount" : 2, "date" : ISODate("2014-03-01T09:00:00Z") }
])

Subtrair números

A agregação a seguir usa a expressão $subtract para calcular o total subtraindo o discount do subtotal de price e fee.

db.sales.aggregate( [ { $project: { item: 1, total: { $subtract: [ { $add: [ "$price", "$fee" ] }, "$discount" ] } } } ] )

A operação retorna os seguintes resultados:

{ "_id" : 1, "item" : "abc", "total" : 7 }
{ "_id" : 2, "item" : "jkl", "total" : 19 }

Subtrair duas datas

A seguinte agregação utiliza a expressão $subtract para subtrair $date da data atual, utilizando o sistema NOW e retorna a diferença em milissegundos:

db.sales.aggregate( [ { $project: { item: 1, dateDifference: { $subtract: [ "$$NOW", "$date" ] } } } ] )

Alternativamente, você pode utilizar Date() para a data atual:

db.sales.aggregate( [ { $project: { item: 1, dateDifference: { $subtract: [ new Date(), "$date" ] } } } ] )

Ambas as operações retornam documentos que se parecem com o seguinte:

{ "_id" : 1, "item" : "abc", "dateDifference" : NumberLong("186136746187") }
{ "_id" : 2, "item" : "jkl", "dateDifference" : NumberLong("186133146187") }

Subtrair milissegundos de uma data

A agregação a seguir usa a expressão $subtract para subtrair 5 * 60 * 1000 milissegundos (5 minutos) do campo "$date":

db.sales.aggregate( [ { $project: { item: 1, dateDifference: { $subtract: [ "$date", 5 * 60 * 1000 ] } } } ] )