CKTIS / JavaScript
Math.atan2: kot iz dveh komponent
Math.atan2 vrne v radianih usmerjeni kot točke (x, y) od pozitivne osi x in ohrani informacijo o kvadrantu.
Različica: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintaksa
Math.atan2(y, x)Math.atan2(y, x) najprej pretvori y, nato x s ToNumber in vrne kot v [-π, π]. Navpična komponenta je pred vodoravno. Predznaka izbereta kvadrant, zato loči točke z istim količnikom y / x.
Argument NaN da NaN. Ničle s predznakom izberejo mejo: atan2(+0, -1) je +π, atan2(-0, -1) je -π in atan2(-0, +1) je -0. Določene so tudi kombinacije z ±Infinity. Symbol ali BigInt sproži TypeError; objekti lahko izvedejo pretvorbo, približek pa je odvisen od izvedbe.
Ni konstruktor in je standardna od ECMAScript 1. Primerna za smer vektorja, vrtenje kazalca ali azimut, saj ničelni x in kvadrante obravnava bolje kot Math.atan(y / x). Stopinje = angle * 180 / Math.PI. Pri (0, 0) odločajo predznaki ničel, ne enolična geometrijska smer.
Primeri
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); }Rezultat
45,135,-135,-45 3.141593 -3.141593 true true true