CKTIS / JavaScript
Math.atan2: úhel ze dvou složek
Math.atan2 vrátí v radiánech orientovaný úhel bodu (x, y) od kladné osy x se zachováním kvadrantu.
Verze: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntaxe
Math.atan2(y, x)Math.atan2(y, x) převede nejprve y, potom x přes ToNumber a vrátí úhel v [-π, π]. Svislá složka je před vodorovnou. Znaménka vyberou kvadrant, takže odliší body se stejným podílem y / x.
Argument NaN dá NaN. Nuly se znaménkem volí hranici: atan2(+0, -1) je +π, atan2(-0, -1) je -π a atan2(-0, +1) je -0. Definovány jsou i kombinace s ±Infinity. Symbol či BigInt vyvolá TypeError; objekty mohou spustit převod a aproximace záviset na implementaci.
Není konstruktor a je standardní od ECMAScript 1. Hodí se pro směr vektoru, otočení ukazatele či azimut, protože nulové x a kvadranty řeší lépe než Math.atan(y / x). Stupně = angle * 180 / Math.PI. V (0, 0) rozhodují znaménka nul, ne jedinečný geometrický směr.
Pří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ýsledek
45,135,-135,-45 3.141593 -3.141593 true true true