CKTIS / JavaScript
Math.atan2: Winkel aus zwei Komponenten
Math.atan2 liefert den gerichteten Winkel des Punkts (x, y) von der positiven x-Achse im Bogenmaß und erhält die Quadranteninformation.
Version: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
Math.atan2(y, x)Math.atan2(y, x) wandelt zuerst y, dann x mit ToNumber um und liefert einen Winkel in [-π, π]. Die vertikale Komponente steht vor der horizontalen. Die Vorzeichen wählen den Quadranten, sodass Punkte mit gleichem Quotienten y / x unterschieden werden.
NaN in einem Argument ergibt NaN. Vorzeichenbehaftete Nullen bestimmen den Rand: atan2(+0, -1) ist +π, atan2(-0, -1) ist -π und atan2(-0, +1) ist -0. Auch Kombinationen mit ±Infinity sind definiert. Symbol oder BigInt löst TypeError aus; Objekte können Umwandlungscode ausführen, die Näherung darf implementierungsabhängig sein.
Kein Konstruktor, seit ECMAScript 1 Standard. Geeignet für Vektorrichtung, Zeigerrotation oder Peilung, da Null-x und Quadranten besser als Math.atan(y / x) behandelt werden. Grad sind angle * 180 / Math.PI. Bei (0, 0) bestimmen Nullvorzeichen das Ergebnis, nicht eine eindeutige geometrische Richtung.
Beispiele
const points = [[1, 1], [-1, 1], [-1, -1], [1, -1]];
console.log(points.map(([x, y]) => (Math.atan2(y, x) * 180 / Math.PI).toFixed(0)).join(","));
console.log(Math.atan2(+0, -1).toFixed(6), Math.atan2(-0, -1).toFixed(6));
console.log(Object.is(Math.atan2(-0, +1), -0));
console.log(Number.isNaN(Math.atan2(undefined, 1)));
try { Math.atan2(1n, 1); } catch (error) { console.log(error instanceof TypeError); }Ergebnis
45,135,-135,-45 3.141593 -3.141593 true true true