WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Math.atan: Arkustangens

Math.atan liefert den Arkustangens einer Zahl im Bogenmaß mit Ergebnis -π/2 bis π/2 für die ganze reelle Achse.

Version: ECMAScript 1 onward; example target: Node.js 24.22.2

Syntax

Math.atan(x)

Math.atan(x) wendet ToNumber an und berechnet den Hauptwert des inversen Tangens. Jede endliche reelle Zahl wird nach (-π/2, π/2) abgebildet. +Infinity ergibt etwa +π/2, -Infinity etwa -π/2 und das Vorzeichen von Null bleibt: atan(-0) ist -0.

NaN oder fehlendes Argument ergibt NaN. Numerische Zeichenketten werden umgewandelt, Symbol und BigInt lösen TypeError aus; Objekte können valueOf oder toString ausführen. Die Number-Näherung darf implementierungsabhängig sein.

Kein Konstruktor, seit ECMAScript 1 Standard. Grad sind radians * 180 / Math.PI. Math.atan(rise / run) kennt nur die Steigung, verliert aber die Quadranteninformation und ist bei Nenner null problematisch; für zwei Komponenten meist Math.atan2(y, x) verwenden.

Beispiele

const slope = 1;
const angle = Math.atan(slope);
console.log(angle.toFixed(6), (angle * 180 / Math.PI).toFixed(1));
console.log(Math.atan(Infinity).toFixed(6), Math.atan(-Infinity).toFixed(6));
console.log(Object.is(Math.atan(-0), -0));
console.log(Number.isNaN(Math.atan()), Number.isNaN(Math.atan(NaN)));
try { Math.atan(1n); } catch (error) { console.log(error instanceof TypeError); }

Ergebnis

0.785398 45.0
1.570796 -1.570796
true
true true
true

Quellen