No MongoDB, o
$radiansToDegrees
operador de pipeline de agregação converte um valor de entrada medido em radianos para graus. $radiansToDegrees
aceita qualquer expressão válida que resolva para um número. O
$radiansToDegrees
O operador foi introduzido no MongoDB 4.2. Exemplo
Suponha que tenhamos uma coleção chamada
test
com o seguinte documento:{ "_id" : 1, "data" : 0.5 }
E vamos supor que o valor do
data
campo está em radianos (ou seja, 0.5
radianos). Podemos usar o
$radiansToDegrees
operador para converter os data
campo em graus:db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
radians: "$data",
degrees: { $radiansToDegrees: "$data" }
}
}
]
)
Resultado:
{ "radians" : 0.5, "degrees" : 28.64788975654116 }
Por padrão, o arquivo
$radiansToDegrees
operador retorna valores como um double
, mas também pode retornar valores como um decimal de 128 bits, desde que a expressão resolva para um valor decimal de 128 bits. Valores decimais de 128 bits
Se a expressão fornecida para
$radiansToDegrees
for decimal de 128 bits, o resultado será retornado em decimal de 128 bits. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 2, "data" : NumberDecimal("0.1301023541559787031443874490659") }
Vamos executar o
$radiansToDegrees
operador contra esse documento:db.test.aggregate(
[
{ $match: { _id: 2 } },
{ $project: {
_id: 0,
radians: "$data",
degrees: { $radiansToDegrees: "$data" }
}
}
]
).pretty()
Resultado:
{ "radians" : NumberDecimal("0.1301023541559787031443874490659"), "degrees" : NumberDecimal("7.454315797853905125952127312900524") }
A saída é decimal de 128 bits.
Valores nulos
Valores nulos retornam
null
ao usar o $radiansToDegrees
operador. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 3, "data" : null }
Vamos executar o
$radiansToDegrees
operador contra esse documento:db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
degrees: { $radiansToDegrees: "$data" }
}
}
]
)
Resultado:
{ "degrees" : null }
Podemos ver que o resultado é
null
. Valores NaN
Se o argumento for resolvido para
NaN
, $radiansToDegrees
retorna NaN
. Exemplo:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
degrees: { $radiansToDegrees: 0 * "$data" }
}
}
]
)
Resultado:
{ "degrees" : NaN }
Infinito
Se o argumento resolver para
Infinity
ou -Infinity
, o $radiansToDegrees
operador retorna Infinity
. Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 4, "data" : Infinity }
Vamos executar
$radiansToDegrees
contra o campo de dados:db.test.aggregate(
[
{ $match: { _id: 4 } },
{ $project: {
_id: 0,
degrees: { $radiansToDegrees: "$data" }
}
}
]
)
Resultado:
{ "degrees" : Infinity }
Campos inexistentes
Se o
$radiansToDegrees
operador é aplicado em um campo que não existe, null
é devolvido. Exemplo:
db.test.aggregate(
[
{ $match: { _id: 4 } },
{ $project: {
_id: 0,
degrees: { $radiansToDegrees: "$name" }
}
}
]
)
Resultado:
{ "degrees" : null }
Combinado com outros operadores
Alguns operadores de pipeline de agregação retornam seu resultado em radianos. Você pode combinar
$radiansToDegrees
com tais operadores para retornar o resultado em graus. Suponha que tenhamos uma coleção chamada
test
com o seguinte documento:{ "_id" : 1, "data" : 0.5 }
E suponha que queremos usar o
$asin
operador para retornar o arcsine do data
campo. O $asin
O operador retorna seu resultado em radianos, mas suponha que queremos o resultado em graus. Neste caso, podemos fazer o seguinte:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
radians: { $asin: "$data" },
degrees: { $radiansToDegrees: { $asin: "$data" } }
}
}
]
)
Resultado:
{ "radians" : 0.5235987755982988, "degrees" : 29.999999999999996 }
Neste exemplo, o primeiro campo apresenta o resultado em radianos e o segundo campo o apresenta em graus.