$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

Quando os tipos de entrada são misturados, $subtract 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, $subtract 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 Date e operandos não inteiros, $subtract arredonda o valor não inteiro para o inteiro mais próximo antes de executar a operação.

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

A operação retorna os seguintes resultados:

{ "_id" : 1, "item" : "abc", "dateDifference" : ISODate("2014-03-01T07:55:00Z") }
{ "_id" : 2, "item" : "jkl", "dateDifference" : ISODate("2014-03-01T08:55:00Z") }

Voltar

$substrCP

$sum