Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Math.atan2: angolo da due componenti

Math.atan2 restituisce in radianti l’angolo orientato del punto (x, y) dall’asse x positivo, conservando il quadrante.

Versione: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintassi

Math.atan2(y, x)

Math.atan2(y, x) converte prima y e poi x con ToNumber e restituisce un angolo in [-π, π]. La componente verticale precede quella orizzontale. I segni scelgono il quadrante, distinguendo punti con lo stesso quoziente y / x.

Un argomento NaN dà NaN. Gli zeri con segno selezionano il bordo: atan2(+0, -1) è +π, atan2(-0, -1) è -π e atan2(-0, +1) è -0. Sono definite anche combinazioni con ±Infinity. Symbol o BigInt genera TypeError; gli oggetti possono eseguire conversione e l’approssimazione dipendere dall’implementazione.

Non è costruttore ed è standard da ECMAScript 1. Usarlo per direzione vettoriale, rotazione del puntatore o rilevamento, poiché gestisce x zero e quadranti meglio di Math.atan(y / x). Gradi = angle * 180 / Math.PI. In (0, 0), i segni degli zeri decidono il risultato, non una direzione geometrica unica.

Esempi

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

Risultato

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

Fonti