$abs ( operador de expressão )

Definição

$abs

Retorna o valor absoluto de um número.

$abs tem a seguinte sintaxe:

{ $abs: <number> }

A expressão <number> pode ser qualquer expressão válida, desde que seja resolvida como um número. Para mais informações sobre expressões, consulte Expressões.

Comportamento

Se o argumento for resolvido para um valor de null ou se referir a um campo ausente, $abs retornará null. Se o argumento se resolve em NaN, $abs retorna NaN.

Exemplo

Uma coleção temperatureChange contém os seguintes documentos:

db.temperatureChange.insertMany( [   { _id: 1, startTemp: 50, endTemp: 80 },   { _id: 2, startTemp: 40, endTemp: 40 },   { _id: 3, startTemp: 90, endTemp: 70 },   { _id: 4, startTemp: 60, endTemp: 70 }] )

O exemplo a seguir calcula a magnitude da diferença entre as classificações startTemp e endTemp:

db.temperatureChange.aggregate([   {      $project: { delta: { $abs: { $subtract: [ "$startTemp", "$endTemp" ] } } }   }])

A operação retorna os seguintes resultados:

{ "_id" : 1, "delta" : 30 }{ "_id" : 2, "delta" : 0 }{ "_id" : 3, "delta" : 20 }{ "_id" : 4, "delta" : 10 }