База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Math.atan2: ъгъл от две компоненти

Math.atan2 връща в радиани насочения ъгъл на точка (x, y) от положителната ос x, като запазва квадранта.

Версия: ECMAScript 1 onward; example target: Node.js 24.22.2

Синтаксис

Math.atan2(y, x)

Math.atan2(y, x) преобразува първо y, после x чрез ToNumber и връща ъгъл в [-π, π]. Вертикалната компонента е преди хоризонталната. Знаците избират квадранта и различават точки с еднакво частно y / x.

Аргумент NaN дава NaN. Нулите със знак избират границата: atan2(+0, -1) е +π, atan2(-0, -1) е -π, а atan2(-0, +1) е -0. Дефинирани са и комбинации с ±Infinity. Symbol или BigInt хвърля TypeError; обекти могат да изпълнят преобразуване, а приближението да зависи от реализацията.

Не е конструктор и е стандартна от ECMAScript 1. Използвайте за посока на вектор, въртене на показалец или азимут, защото обработва нулево x и квадранти по-добре от Math.atan(y / x). Градуси = angle * 180 / Math.PI. При (0, 0) знаците на нулите решават резултата, не еднозначна геометрична посока.

Примери

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

Резултат

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

Източници