ATN

Syntaxe

Paramètres

Description

Cette fonction trigonométrique retourne l'«ArcTangente».

Remarques

• La fonction calcule l'arc tangente d'un nombre : La fonction Atn retourne l'angle dont la tangente est égale à la valeur numérique fournie en paramètre. Il s'agit donc de la fonction inverse de la tangente (Tan). Cette fonction est principalement utilisée dans les calculs trigonométriques, scientifiques et géométriques.
• Le résultat est exprimé en radians et non en degrés : Comme la majorité des fonctions trigonométriques de Microsoft Access, Atn retourne un angle en radians. Si un résultat en degrés est souhaité, il est nécessaire d'effectuer une conversion, par exemple en multipliant le résultat par 180 /π. Cette particularité est importante afin d'éviter des erreurs lors de l'affichage ou de l'interprétation des résultats.
• La fonction accepte aussi bien les valeurs positives que négatives : Le paramètre peut être un nombre positif, négatif ou nul. Lorsque le nombre est positif, l'angle retourné est positif; lorsqu'il est négatif, l'angle obtenu est également négatif. Cette symétrie respecte les propriétés mathématiques de la fonction arc tangente.
• La valeur zéro produit un résultat nul : Si l'on appelle Atn(0), la fonction retourne exactement 0. En effet, la tangente d'un angle nul est égale à zéro. Cette propriété constitue un bon moyen de vérifier rapidement que la fonction se comporte correctement lors de tests ou de validations.
• Le résultat est toujours compris entre -π/2 et π/2 : Contrairement à certains autres calculs d'angles, Atn retourne toujours une valeur appartenant à l'intervalle compris entre -π/2 et π/2, soit environ -1,5708 et 1,5708 radians. Cette limitation correspond à la définition mathématique de la fonction arc tangente principale.
• La fonction est souvent utilisée avec les autres fonctions trigonométriques : Dans les applications scientifiques ou techniques développées avec Access, Atn est fréquemment combinée avec Sin, Cos, Tan ou Sqr. Ces fonctions permettent de résoudre des problèmes liés aux triangles, aux vecteurs, aux coordonnées cartésiennes ou aux calculs d'angles.
• Elle ne permet pas de déterminer le quadrant d'un point : La fonction Atn ne reçoit qu'un seul paramètre correspondant au rapport entre deux valeurs. Elle ne peut donc pas distinguer les différents quadrants d'un plan cartésien lorsque les coordonnées X et Y sont connues. Pour ce type de calcul, certains langages proposent une fonction Atan2, mais Microsoft Access ne dispose pas d'une telle fonction intégrée.
• Elle peut être utilisée directement dans les requêtes et le code VBA : La fonction Atn est disponible dans les expressions de requêtes, les champs calculés, les formulaires, les états ainsi que dans les modules VBA. Cette polyvalence permet de réaliser des calculs trigonométriques sans devoir créer de fonctions personnalisées, ce qui simplifie le développement des applications.
• La précision dépend du type numérique utilisé : Le calcul de l'arc tangente est réalisé à l'aide des types numériques internes de Microsoft Access et de VBA. Plus la précision du nombre fourni est élevée, plus le résultat sera précis. Pour les applications scientifiques, il est recommandé d'utiliser le type Double afin de limiter les erreurs d'arrondi.
• La fonction est disponible dans toutes les versions modernes de Microsoft Access : La fonction Atn est présente depuis les premières versions de Microsoft Access et demeure compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette compatibilité assure la portabilité des applications qui utilisent des calculs trigonométriques sur différentes générations d'Access.

Exemple

Voyons comment utiliser la fonction Atn dans Microsoft Access :

Exemple de code VBA

La fonction Atn peut être utilisée dans le code VBA de Microsoft Access.

Par exemple :

Dans cet exemple, la variable appelée LNumber contiendrait maintenant la valeur de 1,56603445802574.