A partir do MongoDB 4.0, você pode usar o
$toDecimal
operador de pipeline de agregação para converter um valor em um decimal. A maioria dos tipos pode ser convertida em decimal, mas o ObjectId não pode.
Quando você converte um valor de Data em decimal,
$toDecimal
retorna o número de milissegundos desde a época que corresponde ao valor de data. Quando você converte um booleano em decimal, se o booleano for
true
, então o decimal é 1
. Se o booleano for false
, então o decimal é 0
. Exemplo
Suponha que tenhamos uma coleção chamada
types
e contém os seguintes documentos:{ "_id" : ObjectId("601340eac8eb4369cf6ad9db"), "double" : 123.75, "string" : "123", "boolean" : true, "date" : ISODate("2020-12-31T23:30:15.123Z"), "integer" : 123, "long" : NumberLong(123), "decimal" : NumberDecimal("123.75") }
Podemos usar o
$toDecimal
operador para converter esses tipos (exceto para o ObjectId) em um decimal. Se a entrada já for um decimal, ele simplesmente retornará o decimal. db.types.aggregate(
[
{
$project:
{
_id: 0,
double: { $toDecimal: "$double" },
string: { $toDecimal: "$string" },
boolean: { $toDecimal: "$boolean" },
date: { $toDecimal: "$date" },
integer: { $toDecimal: "$integer" },
long: { $toDecimal: "$long" },
decimal: { $toDecimal: "$decimal" }
}
}
]
).pretty()
Resultado:
{ "double" : NumberDecimal("123.750000000000"), "string" : NumberDecimal("123"), "boolean" : NumberDecimal("1"), "date" : NumberDecimal("1609457415123"), "integer" : NumberDecimal("123.000000000000"), "long" : NumberDecimal("123"), "decimal" : NumberDecimal("123.75") }
Erros
Se você encontrar erros, tente usar o
$convert
operador em vez de $toDecimal
. O $convert
O operador permite que você lide com erros sem afetar toda a operação de agregação. O
$toDecimal
operador é o equivalente a usar o $convert
operador para converter um valor em um decimal. Aqui está um exemplo de como usar
$convert
para tentar converter um ObjectId para um decimal (o que resulta em um erro):db.types.aggregate(
[
{
$project:
{
_id: 0,
result:
{
$convert: {
input: "$_id",
to: "decimal",
onError: "An error occurred",
onNull: "Input was null or empty"
}
}
}
}
]
)
Resultado:
{ "result" : "An error occurred" }
Usando
$convert
nos permitiu especificar a mensagem de erro a ser usada quando o erro ocorreu e não interrompeu toda a operação de agregação. Veja MongoDB
$convert
para mais exemplos.