--- title: Math.asin() slug: Web/JavaScript/Reference/Global_Objects/Math/asin tags: - JavaScript - Math - Method - Método(2) - Reference - Referência(2) translation_of: Web/JavaScript/Reference/Global_Objects/Math/asin ---
{{JSRef}}

 

A função Math.asin() retorna o arco seno (em radianos) de um número, onde

x[-1;1],Math.asin(x)=arcsin(x)=o único valor y[-π2;π2]tal que sin(y)=x\forall x \in [{-1};1],\;\mathtt{\operatorname{Math.asin}(x)} = \arcsin(x) = \text{ the unique } \; y \in \left[-\frac{\pi}{2}; \frac{\pi}{2}\right] \, \text{such that} \; \sin(y) = x

Sintaxe

Math.asin(x)

Parâmetros

x
Um número.

Valor retornado

O arco seno (em radianos) do parâmetro recebido se o parâmetro estiver entre -1 e 1; senão, {{jsxref("NaN")}}.

Descrição

O método Math.asin() retorna um valor numérico entre -π2-\frac{\pi}{2} e π2\frac{\pi}{2} radianos para todo x entre -1 e 1. Se o valor de x estiver fora deste intervalo {{jsxref("NaN")}} é retornado.

Por asin() ser um método estático de Math, deve-se sempre usá-lo como Math.asin(), e não como um método de um objeto Math que você criou.

Exemplos

Usando Math.asin()

Math.asin(-2);  // NaN
Math.asin(-1);  // -1.5707963267948966 (-pi/2)
Math.asin(0);   // 0
Math.asin(0.5); // 0.5235987755982989
Math.asin(1);   // 1.5707963267948966 (pi/2)
Math.asin(2);   // NaN

Para valores menores que -1 ou maiores que 1, Math.asin() retorna {{jsxref("NaN")}}.

Especificações

Specification Status Comment
{{SpecName('ES1')}} {{Spec2('ES1')}} Definição inicial. Implementado no JavaScript 1.0.
{{SpecName('ES5.1', '#sec-15.8.2.3', 'Math.asin')}} {{Spec2('ES5.1')}}  
{{SpecName('ES6', '#sec-math.asin', 'Math.asin')}} {{Spec2('ES6')}}  
{{SpecName('ESDraft', '#sec-math.asin', 'Math.asin')}} {{Spec2('ESDraft')}}  

Compatibilidade com navegadores

{{Compat("javascript.builtins.Math.asin")}}

Veja também