Menu Docs

Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB

$degreesToRadians (agregação)

Nesta página

  • Definição
  • Comportamento
  • Exemplo

Definição

$degreesToRadians

Novidades na versão 4.2.

Converte um valor de entrada medido em graus para radianos.

$degreesToRadians tem a seguinte sintaxe:

{ $degreesToRadians: <expression> }

$degreesToRadians usa qualquer expressão válida que resolva para um número.

Por padrão , $degreesToRadians retorna valores como double. $degreesToRadians também pode retornar valores como um decimal128bits , desde que o <expression> resolva para um valor decimal 128bits.

Para mais informações sobre expressões, consulte Operadores de Expressão.

Comportamento

null, NaN e +/- Infinity

Se o argumento for resolvido para um valor de null ou se referir a um campo ausente, $degreesToRadians retornará null. Se o argumento se resolve em NaN, $degreesToRadians retorna NaN. Se o argumento resolver para infinito negativo ou positivo, $degreesToRadians infinito negativo ou positivo respectivamente.

Exemplo
Resultados
{ $degreesToRadians: NaN }
NaN
{ $degreesToRadians: null }
null
{ $degreesToRadians : Infinity}
Infinity
{ $degreesToRadians : -Infinity }
-Infinity

Exemplo

A coleção trigonometry contém um documento que contém três ângulos medidos em graus:

{
  "angle_a" : NumberDecimal("53.13010235415597870314438744090659"),
  "angle_b" : NumberDecimal("36.86989764584402129685561255909341"),
  "angle_c" : NumberDecimal("90")
}

A seguinte operação de agregação utiliza a expressão $degreesToRadians para converter cada valor para seu equivalente em radianos e adicioná-los ao documento de entrada utilizando o estágio de pipeline $addFields .

db.trigonometry.aggregate([
  {
    $addFields: {
      "angle_a_rad" : { $degreesToRadians : "$angle_a"},
      "angle_b_rad" : { $degreesToRadians : "$angle_b"},
      "angle_c_rad" : { $degreesToRadians : "$angle_c"}
    }
  }
])

A operação retorna o seguinte documento:

{
  "_id" : ObjectId("5c50aec71c75c59232b3ede4"),
  "angle_a" : NumberDecimal("53.13010235415597870314438744090660"),
  "angle_b" : NumberDecimal("36.86989764584402129685561255909341"),
  "angle_c" : NumberDecimal("90"),
  "angle_a_rad" : NumberDecimal("0.9272952180016122324285124629224290"),
  "angle_b_rad" : NumberDecimal("0.6435011087932843868028092287173227"),
  "angle_c_rad" : NumberDecimal("1.570796326794896619231321691639752")
}

Como angle_a, angle_b e angle_c são armazenados como 128decimais de bits, a saída de $degreesToRadians é um decimal 128bits.

← $dayOfYear (agregação)
$denseRank (agregação) →

Nesta página