Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez également contribuer en rejoignant la communauté francophone sur MDN Web Docs.

Math.acos()

La fonction Math.acos() renvoie l'arc cosinus d'une valeur exprimée en radians. Cela est défini par :

∀ x ∊ [ - 1 ; 1 ] , Math.acos ( x ) = arccos ( x ) = le seul y ∊ [ 0 ; π ] tel que cos ( 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

Exemple interactif

Syntaxe

Math.acos(x)

Paramètres

x

Un nombre (représentant un angle exprimé en radians).

Valeur de retour

L'arc cosinus du nombre passé en argument si celui est compris entre -1 et 1. La méthode renvoie NaN sinon.

Description

La méthode acos renvoie une valeur numérique comprise entre 0 et Pi pour x compris entre -1 et 1. Si la valeur de x est hors de cet intervalle, la méthode renverra NaN.

acos est une méhode statique de Math et doit toujours être utilisée avec la syntaxe Math.acos(), elle ne doit pas être appelée depuis un autre objet qui aurait été créé (Math n'est pas un constructeur).

Exemples

Utiliser 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

Pour les valeurs (strictement) inférieures à -1 ou supérieures à 1, Math.acos renvoie NaN.

Spécifications

Spécification Statut Commentaires
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
La définition de 'Math.acos' dans cette spécification.		 Standard
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Math.acos' dans cette spécification.		 Standard
ECMAScript (ECMA-262)
La définition de 'Math.acos' dans cette spécification.		 Standard évolutif

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi