CKTIS / JavaScript
Math.atan2: kąt z dwóch składowych
Math.atan2 zwraca w radianach skierowany kąt punktu (x, y) od dodatniej osi x, zachowując informację o ćwiartce.
Wersja: ECMAScript 1 onward; example target: Node.js 24.22.2
Składnia
Math.atan2(y, x)Math.atan2(y, x) konwertuje najpierw y, potem x przez ToNumber i zwraca kąt w przedziale [-π, π]. Kolejność argumentów to pionowa składowa przed poziomą. Znaki obu liczb wybierają właściwą ćwiartkę, dlatego wynik odróżnia punkty, które mają ten sam iloraz y / x.
NaN w dowolnym argumencie daje NaN. Zera ze znakiem określają brzeg: atan2(+0, -1) daje +π, atan2(-0, -1) daje -π, a atan2(-0, +1) daje -0. Specyfikacja definiuje także kombinacje z ±Infinity. Symbol lub BigInt powoduje TypeError; obiekty mogą uruchomić konwersję, a przybliżenie może zależeć od implementacji.
Funkcja nie jest konstruktorem i jest standardowa od ECMAScript 1. Nadaje się do kierunku wektora, obrotu kursora lub namiaru, ponieważ obsługuje zerowe x i ćwiartki lepiej niż Math.atan(y / x). Wynik jest w radianach; stopnie to angle * 180 / Math.PI. Dla punktu (0, 0) znak zer decyduje o wyniku, więc nie traktuj go automatycznie jako zdefiniowanego kierunku geometrycznego.
Przykłady
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); }Wynik
45,135,-135,-45 3.141593 -3.141593 true true true