Jump to content

Documentation/Fonctions Calc/ATAN2

From The Document Foundation Wiki
This page is a translated version of the page Documentation/Calc Functions/ATAN2 and the translation is 100% complete.


Nom de la fonction :

ATAN2

Catégorie :

Mathématique

Résumé :

Calcule la tangente trigonométrique inverse (arctangente ou arctan) pour les coordonnées x et y spécifiées. C'est-à-dire l'angle (en radians) entre l'axe des x et une droite reliant l'origine au point (x, y) spécifié. La valeur renvoyée est la valeur principale et est comprise entre (-π, π] radians.

Syntaxe :

ATAN2(Nombre X; Nombre Y)

Renvoie :

Renvoie un nombre réel dans la plage (-π, π] qui est la tangente trigonométrique inverse en radians pour les coordonnées x et y spécifiées.

Si la fonction renvoie un angle positif, cela représente un angle dans le sens inverse des aiguilles d'une montre par rapport à l'axe des x, tandis qu'un résultat négatif représente un angle dans le sens des aiguilles d'une montre.

Arguments :

Le nombre X est un nombre réel, ou une référence à une cellule contenant ce nombre, qui est la valeur de la coordonnée x.

Le nombre Y est un nombre réel, ou une référence à une cellule contenant ce nombre, qui est la valeur de la coordonnée y.

  • Si Nombre X ou Nombre Y n'est pas numérique, alors ATAN2 renvoie une erreur #VALEUR !.
  • Si Nombre X et Nombre Y sont tous deux égaux à 0, alors ATAN2 renvoie la valeur 0.

Détails complémentaires :

L'illustration suivante montre la géométrie utilisée par ATAN2 (φ étant l'angle calculé).

  • Pour renvoyer l'angle en degrés, utilisez la fonction DEGRES.
  • Alternativement, multipliez par 180/PI() pour convertir le résultat de radians en degrés.
  • Méfiez-vous, les langages de programmation informatique utilisent souvent l'ordre inverse des arguments pour leurs fonctions atan2().

Exemples :

Formule Description Renvoie
=ATAN2(−5; 9)

La fonction calcule l'angle (en radians) entre l'x-axis et une ligne allant de l'origine au point (−5, 9).

2,07789483118723
=DEGRES(ATAN2(12,3; 12,3))

Calculez l'angle (en degrés) entre l'x-axis et une ligne allant de l'origine au point (12,3, 12,3).

45
=ATAN2(D1; D2)

où les cellules D1 et D2 contiennent toutes deux la valeur 0.

La fonction renvoie 0.

0
=ATAN2(−5; −3)*180/PI()

Calcule l'angle (en degrés) entre l'x-axis et une ligne allant de l'origine au point (−5−3).

−149,036243467926
DEGRES(ATAN2(−8; 5))

Calcule l'angle (en degrés) entre l'x-axis et une ligne allant de l'origine au point (−8, 5).

147,994616791916

Fonctions LibreOffice associées :

ACOS

ACOT

ASIN

ATAN

TAN

Standard ODF :

Section 6.16.10, part 2

Fonctions Excel relatives (ou similaires) :

ATAN2