No MongoDB, o
$round
o operador de pipeline de agregação arredonda um número para um inteiro inteiro ou para uma casa decimal especificada. Você tem a opção de especificar quantas casas decimais para arredondar o número. Para fazer isso, passe um segundo argumento. O primeiro argumento é o número a ser arredondado e o segundo argumento (opcional) é o número de casas decimais para arredondar.
Exemplo
Suponha que tenhamos uma coleção chamada
test
com os seguintes documentos:{ "_id" : 1, "data" : 8.99 } { "_id" : 2, "data" : 8.45 } { "_id" : 3, "data" : 8.451 } { "_id" : 4, "data" : -8.99 } { "_id" : 5, "data" : -8.45 } { "_id" : 6, "data" : -8.451 } { "_id" : 7, "data" : 8 } { "_id" : 8, "data" : 0 }
Podemos usar o
$round
operador para arredondar os valores no data
campo:db.test.aggregate(
[
{
$project:
{
_id: 0,
data: 1,
rounded: { $round: [ "$data" ] }
}
}
]
)
Resultado:
{ "data" : 8.99, "rounded" : 9 } { "data" : 8.45, "rounded" : 8 } { "data" : 8.451, "rounded" : 8 } { "data" : -8.99, "rounded" : -9 } { "data" : -8.45, "rounded" : -8 } { "data" : -8.451, "rounded" : -8 } { "data" : 8, "rounded" : 8 } { "data" : 0, "rounded" : 0 }
Especifique uma casa decimal
Temos a opção de usar um segundo argumento para especificar quantas casas decimais para arredondar o número.
Exemplo:
db.test.aggregate(
[
{
$project:
{
_id: 0,
data: 1,
rounded: { $round: [ "$data", 1 ] }
}
}
]
)
Resultado:
{ "data" : 8.99, "rounded" : 9 } { "data" : 8.45, "rounded" : 8.4 } { "data" : 8.451, "rounded" : 8.5 } { "data" : -8.99, "rounded" : -9 } { "data" : -8.45, "rounded" : -8.4 } { "data" : -8.451, "rounded" : -8.5 } { "data" : 8, "rounded" : 8 } { "data" : 0, "rounded" : 0 }
Casas decimais negativas
O segundo argumento pode ser qualquer expressão válida que resolva um número inteiro entre -20 e 100, exclusivo. Portanto, você pode especificar uma casa decimal negativa.
Ao fazer isso, o número é arredondado para a esquerda da casa decimal. Se o valor absoluto do inteiro negativo for maior que o número, o resultado será
0
. Suponha que adicionamos os seguintes documentos à nossa coleção:
{ "_id" : 9, "data" : 8111.32 } { "_id" : 10, "data" : 8514.321 } { "_id" : 11, "data" : 8999.454 }
Aqui está um exemplo de uso de várias casas decimais negativas ao aplicar
$round
a esses documentos:db.test.aggregate(
[
{ $match: { _id: { $in: [ 9, 10, 11 ] } } },
{
$project:
{
_id: 0,
data: 1,
a: { $round: [ "$data", -1 ] },
b: { $round: [ "$data", -2 ] },
c: { $round: [ "$data", -3 ] },
d: { $round: [ "$data", -4 ] },
e: { $round: [ "$data", -5 ] }
}
}
]
).pretty()
Resultado:
{ "data" : 8111.32, "a" : 8110, "b" : 8100, "c" : 8000, "d" : 10000, "e" : 0 } { "data" : 8514.321, "a" : 8510, "b" : 8500, "c" : 9000, "d" : 10000, "e" : 0 } { "data" : 8999.454, "a" : 9000, "b" : 9000, "c" : 9000, "d" : 10000, "e" : 0 }
Lugar decimal de zero
Quando você fornece uma casa decimal de
0
, o $round
O operador arredonda usando o primeiro dígito à direita do decimal e retorna o valor inteiro arredondado. Exemplo:
db.test.aggregate(
[
{
$project:
{
_id: 0,
data: 1,
rounded: { $round: [ "$data", 0 ] }
}
}
]
)
Resultado:
{ "data" : 8.99, "rounded" : 9 } { "data" : 8.45, "rounded" : 8 } { "data" : 8.451, "rounded" : 8 } { "data" : -8.99, "rounded" : -9 } { "data" : -8.45, "rounded" : -8 } { "data" : -8.451, "rounded" : -8 } { "data" : 8, "rounded" : 8 } { "data" : 0, "rounded" : 0 } { "data" : 8111.32, "rounded" : 8111 } { "data" : 8514.321, "rounded" : 8514 } { "data" : 8999.454, "rounded" : 8999 }
Tipos de número
O número a ser arredondado pode ser qualquer expressão válida que resolva um número inteiro, duplo, decimal ou longo. O valor de retorno corresponde ao tipo de dados do valor de entrada.
Então, se adicionarmos os seguintes documentos à nossa coleção:
{ "_id" : 12, "data" : NumberDecimal("128.4585") } { "_id" : 13, "data" : NumberDecimal("128.12345678912") }
Podemos aplicar
$round
para os data
campo:db.test.aggregate(
[
{ $match: { _id: { $in: [ 12, 13 ] } } },
{
$project:
{
_id: 0,
data: 1,
a: { $round: [ "$data", -1 ] },
b: { $round: [ "$data", 0 ] },
c: { $round: [ "$data", 3 ] },
d: { $round: [ "$data", 4 ] },
e: { $round: [ "$data", 5 ] }
}
}
]
).pretty()
Resultado:
{ "data" : NumberDecimal("128.4585"), "a" : NumberDecimal("1.3E+2"), "b" : NumberDecimal("128"), "c" : NumberDecimal("128.458"), "d" : NumberDecimal("128.4585"), "e" : NumberDecimal("128.45850") } { "data" : NumberDecimal("128.12345678912"), "a" : NumberDecimal("1.3E+2"), "b" : NumberDecimal("128"), "c" : NumberDecimal("128.123"), "d" : NumberDecimal("128.1235"), "e" : NumberDecimal("128.12346") }
Arredondamento para casas decimais nulas
Se o segundo argumento for
null
, o resultado é null
. Exemplo:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
data: 1,
rounded: { $round: [ "$data", null ] }
}
}
]
)
Resultado:
{ "data" : 8.99, "rounded" : null } { "data" : 8.45, "rounded" : null } { "data" : 8.451, "rounded" : null }
Arredondando um valor nulo
Se o valor a ser arredondado for
null
, o resultado é null
. Suponha que adicionamos o seguinte documento à coleção:
{ "_id" : 14, "data" : null }
E usamos
$round
para arredondar o valor nulo:db.test.aggregate(
[
{ $match: { _id: { $in: [ 14 ] } } },
{
$project:
{
_id: 0,
data: 1,
rounded: { $round: [ "$data", null ] }
}
}
]
)
Resultado:
{ "data" : null, "rounded" : null }
Infinito Arredondado
Se o número a ser arredondado for
Infinity
, o resultado é Infinity
. Da mesma forma, se for -Infinity
, o resultado é -Infinity
. Vamos adicionar dois documentos com esses valores:
{ "_id" : 15, "data" : Infinity } { "_id" : 16, "data" : -Infinity }
E vamos contorná-los:
db.test.aggregate(
[
{ $match: { _id: { $in: [ 15, 16 ] } } },
{
$project:
{
_id: 0,
data: 1,
rounded: { $round: [ "$data", 2 ] }
}
}
]
)
Resultado:
{ "data" : Infinity, "rounded" : Infinity } { "data" : -Infinity, "rounded" : -Infinity }
Arredondamento NaN
Arredondando
NaN
resulta em NaN
. db.test.aggregate(
[
{ $match: { _id: { $in: [ 1, 2 ] } } },
{
$project:
{
_id: 0,
data: 1,
rounded: { $round: [ "$data" * 2 ] }
}
}
]
)
Resultado:
{ "data" : 8.99, "rounded" : NaN } { "data" : 8.45, "rounded" : NaN }
Tipos não numéricos
Se você tentar arredondar um valor que é o tipo de dados errado (ou seja, não é um número inteiro, duplo, decimal ou longo), um erro será retornado.
Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 17, "data" : "Thirty five" }
E agora tentamos arredondar os
data
campo:db.test.aggregate(
[
{ $match: { _id: { $in: [ 17 ] } } },
{
$project:
{
_id: 0,
data: 1,
rounded: { $round: [ "$data" ] }
}
}
]
)
Resultado:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "$round only supports numeric types, not string", "code" : 51081, "codeName" : "Location51081" } : aggregate failed : [email protected]/mongo/shell/utils.js:25:13 [email protected]/mongo/shell/assert.js:18:14 [email protected]/mongo/shell/assert.js:639:17 [email protected]/mongo/shell/assert.js:729:16 [email protected]/mongo/shell/db.js:266:5 [email protected]/mongo/shell/collection.js:1058:12 @(shell):1:1