$abs (Valor Absoluto)
Última atualização: 2026-10-09
$abs (Valor Absoluto)
$abs retorna o valor absoluto de uma única expressão numérica. É comumente usado para calcular distâncias, desvios ou erros, como a distância entre um valor real e uma meta, ou um deslocamento geográfico. Um argumento null ou ausente resulta em null; infinito positivo permanece infinito positivo e números negativos tornam-se positivos. Combinado com $sign, fornece tanto a magnitude quanto o sinal de um número. $abs suporta inteiros, doubles e Decimals.
| Categoria | Matemática |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $abs: <expressão numérica> }⚙️ Parâmetros
| valor numérico | Um valor numérico ou uma expressão que resolva para um. |
|---|
Retorno：O valor absoluto; null quando o argumento é null ou está ausente
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $abs: calcular a diferença entre o valor real e a meta
db.sales.aggregate([
{ $project: {
gap: { $abs: { $subtract: ['$actual', '$target'] } }
} }
])Saída：
{ '_id': 1, 'gap': 5 }
{ '_id': 2, 'gap': 3 }📌 Notas
- Argumentos null ou ausentes resultam em null
- Infinito negativo torna-se infinito positivo
- O sinal desaparece após o abs; combine com $sign quando o sinal original importar
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QO que $abs retorna para null?
AEle retorna null; envolva com $ifNull quando precisar de um padrão.
QO $abs consegue calcular o valor absoluto de infinito negativo?
ASim, o resultado é Infinity.
QComo obtenho o sinal e o valor absoluto juntos?
AUse $sign para o sinal (1, -1 ou 0) e $abs para a magnitude.
