CKTIS / JavaScript
Math.atan2: hoek uit twee componenten
Math.atan2 geeft in radialen de gerichte hoek van punt (x, y) vanaf de positieve x-as terug en bewaart kwadrantinformatie.
Versie: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
Math.atan2(y, x)Math.atan2(y, x) converteert eerst y en daarna x met ToNumber en geeft een hoek in [-π, π]. De verticale component staat vóór de horizontale. De tekens kiezen het kwadrant, zodat punten met hetzelfde quotiënt y / x worden onderscheiden.
Een NaN-argument geeft NaN. Getekende nullen kiezen de grens: atan2(+0, -1) is +π, atan2(-0, -1) is -π en atan2(-0, +1) is -0. Combinaties met ±Infinity zijn ook bepaald. Symbol of BigInt werpt TypeError; objecten kunnen conversiecode uitvoeren en de benadering mag implementatieafhankelijk zijn.
Geen constructor, standaard sinds ECMAScript 1. Gebruik voor vectorrichting, aanwijzerrotatie of koers, want nul-x en kwadranten werken beter dan bij Math.atan(y / x). Graden = angle * 180 / Math.PI. Bij (0, 0) bepalen nultekens het resultaat, niet een unieke geometrische richting.
Voorbeelden
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); }Resultaat
45,135,-135,-45 3.141593 -3.141593 true true true