$degreesToRadians (agregação)

Nesta página

Definição

Comportamento
Exemplo

Definição

$degreesToRadians

Converte um valor de entrada medido em graus para radianos.

$degreesToRadians tem a seguinte sintaxe:

{ $degreesToRadians: <expression> }

$degreesToRadians usa qualquerexpressã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 decimal de 128 bits, desde que o <expression> resolva para um valor decimal de 128 bits.

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.

Voltar

$dayOfYear

$denseRank

Definição

Comportamento

null, NaN e +/- Infinity

Exemplo

`null`, `NaN` e `+/- Infinity`