Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Math.atan2: uhol z dvoch zložiek

Math.atan2 vráti v radiánoch orientovaný uhol bodu (x, y) od kladnej osi x so zachovaním kvadrantu.

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

Syntax

Math.atan2(y, x)

Math.atan2(y, x) prevedie najprv y, potom x cez ToNumber a vráti uhol v [-π, π]. Zvislá zložka je pred vodorovnou. Znamienka vyberú kvadrant, takže odlíšia body s rovnakým podielom y / x.

Argument NaN dá NaN. Nuly so znamienkom volia hranicu: atan2(+0, -1) je +π, atan2(-0, -1) je -π a atan2(-0, +1) je -0. Definované sú aj kombinácie s ±Infinity. Symbol či BigInt vyvolá TypeError; objekty môžu spustiť prevod a aproximácia závisieť od implementácie.

Nie je konštruktor a je štandardná od ECMAScript 1. Hodí sa na smer vektora, otočenie ukazovateľa či azimut, lebo nulové x a kvadranty rieši lepšie než Math.atan(y / x). Stupne = angle * 180 / Math.PI. V (0, 0) rozhodujú znamienka núl, nie jedinečný geometrický smer.

Príklady

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); }

Výsledok

45,135,-135,-45
3.141593 -3.141593
true
true
true

Zdroje