$cos (Cosseno)
Última atualização: 2026-10-09
$cos (Cosseno)
$cos retorna o cosseno de um valor expresso em radianos. É usado em projeção de vetores, análise de formas de onda e matemática de rotação. Um argumento nulo ou ausente resulta em null, entrada NaN retorna NaN e ±Infinity gera erro. O intervalo do cosseno vai de -1 a 1, e $acos fornece a função inversa. Converta entre graus e radianos com $degreesToRadians e $radiansToDegrees em vez de multiplicar manualmente por pi.
| Categoria | Matemática |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $cos: <expressão-numérica> }
⚙️ Parâmetros
| radianos | Uma expressão numérica em radianos. |
|---|
Retorno:O cosseno dos radianos de entrada; null quando null ou ausente, erro para ±Infinity
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $cos: cosseno após converter graus para radianos
db.trig.aggregate([
{ $project: {
x: { $cos: { $degreesToRadians: '$deg' } }
} }
])
Saída:
{ '_id': 1, 'x': 0.5 }
{ '_id': 2, 'x': 0.8660254037844387 }
📌 Notas
- A entrada é em radianos; converta os ângulos primeiro
- O intervalo está entre -1 e 1
- Com $sin, decompõe coordenadas, e seus quadrados sempre somam 1
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QQual unidade o $cos espera?
ARadianos; converta ângulos com $degreesToRadians primeiro.
QQual é o intervalo dos resultados de $cos?
AOs resultados ficam entre -1 e 1.
QComo $cos e $sin se relacionam?
APara o mesmo ângulo, os quadrados de $cos e $sin somam 1, então podem ser convertidos um no outro.