Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Math.atan2: ângulo a partir de duas componentes

Math.atan2 devolve em radianos o ângulo orientado do ponto (x, y) desde o eixo x positivo, preservando o quadrante.

Versão: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaxe

Math.atan2(y, x)

Math.atan2(y, x) converte primeiro y e depois x com ToNumber e devolve um ângulo em [-π, π]. A componente vertical vem antes da horizontal. Os sinais escolhem o quadrante, distinguindo pontos com o mesmo quociente y / x.

Um argumento NaN dá NaN. Zeros com sinal escolhem a fronteira: atan2(+0, -1) é +π, atan2(-0, -1) é -π e atan2(-0, +1) é -0. Combinações com ±Infinity também são definidas. Symbol ou BigInt lança TypeError; objetos podem executar conversão e a aproximação depender da implementação.

Não é construtor e é padrão desde ECMAScript 1. Use-o para direção vetorial, rotação de ponteiro ou rumo, pois lida com x zero e quadrantes melhor que Math.atan(y / x). Graus = angle * 180 / Math.PI. Em (0, 0), os sinais dos zeros decidem o resultado, não uma direção geométrica única.

Exemplos

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

Resultado

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

Fontes