--- title: Math.acos() slug: Web/JavaScript/Reference/Global_Objects/Math/acos tags: - JavaScript - Math - Métodos - Referências translation_of: Web/JavaScript/Reference/Global_Objects/Math/acos original_slug: Web/JavaScript/Referencia/Objetos_globales/Math/acos ---
{{JSRef}}

La función Math.acos() devuelve el arco coseno (en radianes) de un número que es

x[-1;1],Math.acos(x)=arccos(x)= the unique y[0;π]such thatcos(y)=x\forall x \in [{-1};1],\;\mathtt{\operatorname{Math.acos}(x)} = \arccos(x) = \text{ the unique } \; y \in [0; \pi] \, \text{such that} \; \cos(y) = x

Sintaxis

Math.acos(x)

Parámetros

x
Un número.

Valor devuelto

El arco coseno (en radianes) de un número dado si se encuentra entre -1 y 1; de otro modo, {{jsxref("NaN")}}.

Descripción

El método Math.acos() devuelve un valor numérico entre 0 y π radianes para x entre -1 y 1. Si el valor de x está fuera de este rango, devuelve {{jsxref("NaN")}}.

Debido a que acos() es un método estático de Math, siempre debe usarse como Math.acos(), en vez de como un método de un objeto Math creado (Math no es un constructor).

Ejemplos

Usando Math.acos()

Math.acos(-2);  // NaN
Math.acos(-1);  // 3.141592653589793
Math.acos(0);   // 1.5707963267948966
Math.acos(0.5); // 1.0471975511965979
Math.acos(1);   // 0
Math.acos(2);   // NaN

Para valores menores que  -1 o mayores que 1, Math.acos() devuelve {{jsxref("NaN")}}.

Especificaciones

Especificación Estado Comentarios
{{SpecName('ES1')}} {{Spec2('ES1')}} Definición inicial. Implementado en JavaScript 1.0.
{{SpecName('ES5.1', '#sec-15.8.2.2', 'Math.acos')}} {{Spec2('ES5.1')}}  
{{SpecName('ES6', '#sec-math.acos', 'Math.acos')}} {{Spec2('ES6')}}  
{{SpecName('ESDraft', '#sec-math.acos', 'Math.acos')}} {{Spec2('ESDraft')}}  

Compatibilidad con navegador

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

Ver también