Math.atan2()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Сводка

Метод Math.atan2() возвращает арктангенс от частного своих аргументов.

Синтаксис

Math.atan2(y, x)

Параметры

y

Первое число.

x

Второе число.

Описание

Метод Math.atan2() возвращает числовое значение от -π до π, представляющее угол тета точки (x, y). Это выраженный в радианах угол, отсчитываемый против часовой стрелки от положительного направления оси X до точки (x, y). Обратите внимание, что первым в метод передаётся координата y, а только вторым — координата x.

В метод Math.atan2() аргументы x и y передаются по отдельности, в то время, как в метод Math.atan() передаётся отношение этих двух аргументов.

Поскольку метод atan2() является статическим методом объекта Math, вы всегда должны использовать его как Math.atan2(), а не пытаться вызывать метод на созданном экземпляре объекта Math (поскольку объект Math не является конструктором).

Примеры

Пример: использование метода Math.atan2()

js
Math.atan2(90, 15); // 1.4056476493802699
Math.atan2(15, 90); // 0.16514867741462683

Math.atan2(±0, -0);               // ±PI.
Math.atan2(±0, +0);               // ±0.
Math.atan2(±0, -x);               // ±PI для x > 0.
Math.atan2(±0, x);                // ±0 для x > 0.
Math.atan2(-y, ±0);               // -PI/2 для y > 0.
Math.atan2(y, ±0);                // PI/2 для y > 0.
Math.atan2(±y, -Infinity);        // ±PI для конечного y > 0.
Math.atan2(±y, +Infinity);        // ±0 для конечного y > 0.
Math.atan2(±Infinity, x);         // ±PI/2 для конечного x.
Math.atan2(±Infinity, -Infinity); // ±3*PI/4.
Math.atan2(±Infinity, +Infinity); // ±PI/4.

Спецификации

Specification
ECMAScript Language Specification
# sec-math.atan2

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также