La fonction Math.atan2()
renvoie l'arc tangente du quotient de ses arguments.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Syntaxe
Math.atan2(y, x)
Paramètres
x
- La coordonnée en abscisse du point.
y
- La coordonnée en ordonnée du point.
Valeur de retour
L'arc tangente du quotient formé par les deux arguments, c'est-à-dire l'angle, exprimé en radians entre l'axe des abscisses et la droite passant par l'origin (0,0) et le point de coordonnées (x,y).
Description
La méthode Math.atan2()
renvoie une valeur numérique comprise entre -Pi et Pi qui représente l'angle theta d'un point de coordonnées (x,y). Cela correspond à l'angle (dans le sens trigonométrique) entre l'axe des abscisses et le point de coordonnées (x,y
). Attention, le premier argument de la fonction est l'ordonnée (y) et le second est l'abscisse (x).
Math.atan2()
utilise deux arguments x
et y
, alors que la méthode Math.atan()
utilise le ratio de deux nombres comme un seul argument.
atan2()
est une méthode statique de l'objet Math
, elle doit toujours être utilisée avec la syntaxe Math.atan2()
, elle ne doit pas être utilisée comme la méthode d'un autre objet qui aurait été créé (Math
n'est pas un constructeur).
Exemples
Utiliser Math.atan2()
Math.atan2(90, 15); // 1.4056476493802699
Math.atan2(15, 90); // 0.16514867741462683
Math.atan2( ±0, -0 ); // ±PI.
Math.atan2( ±0, +0 ); // ±0.
Math.atan2( ±0, -x ); // ±PI pour x > 0.
Math.atan2( ±0, x ); // ±0 pour x > 0.
Math.atan2( -y, ±0 ); // -PI/2 pour y > 0.
Math.atan2( y, ±0 ); // PI/2 pour y > 0.
Math.atan2( ±y, -Infinity ); // ±PI pour y qui est un nombre fini > 0.
Math.atan2( ±y, +Infinity ); // ±0 pour y qui est un nombre fini > 0.
Math.atan2( ±Infinity, x ); // ±PI/2 pour x qui est un nombre fini.
Math.atan2( ±Infinity, -Infinity ); // ±3*PI/4.
Math.atan2( ±Infinity, +Infinity ); // ±PI/4.
Spécifications
Spécification | État | 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.atan2' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Math.atan2' dans cette spécification. |
Standard | |
ECMAScript (ECMA-262) La définition de 'Math.atan2' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser
Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.