$asin (Arco Seno)
Última atualização: 2026-10-09
$asin (Arco Seno)
$asin retorna o arco seno de um número, com o resultado expresso em radianos. A entrada deve estar entre -1 e 1. É usado para recuperar um ângulo a partir de um valor de seno ou em transformações de coordenadas. Um argumento nulo ou ausente resulta em null; entrada fora de [-1, 1] gera erro porque não existe ângulo real para ela. Converta o resultado em radianos para graus com $radiansToDegrees. $asin é a inversa de $sin: $sin($asin(x)) é igual a x.
| Categoria | Matemática |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $asin: <expressão-numérica> }⚙️ Parâmetros
| valor numérico | Uma expressão numérica entre -1 e 1. |
|---|
Retorno：O arco seno 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):
// $asin: recuperar um ângulo (radianos) a partir de um valor de seno
db.trig.aggregate([
{ $project: {
angleRad: { $asin: '$sinValue' }
} }
])Saída：
{ '_id': 1, 'angleRad': 1.5707963267948966 }
{ '_id': 2, 'angleRad': 0.5235987755982989 }📌 Notas
- A entrada deve estar entre -1 e 1; fora desse intervalo, gera erro
- O resultado é em radianos; converta com $radiansToDegrees
- É a inversa de $sin
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QQual é o intervalo de entrada de $asin?
ADeve estar entre -1 e 1; valores fora desse intervalo geram erro.
QO $asin retorna radianos ou graus?
ARadianos; use $radiansToDegrees para graus.
QQuanto é $asin(1)?
AÉ π/2, a medida em radianos de 90 graus, cerca de 1.5708.
