$acos (Arco Cosseno)

Última atualização: 2026-10-09

$acos (Arco Cosseno)

$acos retorna o arco cosseno de um número, com o resultado em radianos e a entrada restrita de -1 a 1. É usado para recuperar um ângulo a partir de um valor de cosseno ou para calcular o ângulo entre dois vetores. Um argumento nulo ou ausente resulta em null; entrada fora de [-1, 1] gera erro. Converta o resultado em radianos para graus com $radiansToDegrees. Como inversa de $cos, retorna valores de 0 a π radianos (0 a 180 graus).

📝 Sintaxe

{ $acos: <expressão-numérica> }

⚙️ Parâmetros

Retorno：O arco cosseno em radianos; null quando null ou ausente, erro fora de [-1, 1]

▶ Exemplo

Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):

// $acos: ângulo (radianos) a partir de um valor de cosseno
db.trig.aggregate([
  { $project: {
      angle: { $acos: '$cosValue' }
  } }
])

Saída：

{ '_id': 1, 'angle': 0 }
{ '_id': 2, 'angle': 1.0471975511965979 }

📌 Notas

• A entrada deve estar entre -1 e 1; fora desse intervalo, gera erro
• O resultado é em radianos, variando de 0 a π
• É a inversa de $cos

🏷️ Tags Relacionados

💡 Casos Relacionados

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós