Esta página ha sido traducida del inglés por la comunidad. Aprende más y únete a la comunidad de MDN Web Docs.

View in English Always switch to English

Math.acos()

Baseline
Ampliamente disponible

Esta característica está consolidada y funciona en muchos dispositivos y versiones de navegador. Está disponible en todos los navegadores desde julio de 2015.

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, 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 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()

js
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 NaN.

Especificaciones

Especificación
ECMAScript® 2027 Language Specification
# sec-math.acos

Compatibilidad con navegadores

Ver también