Retorna o ângulo em radianos entre o eixo x positivo e o raio que parte da origem até o ponto (x, y). Esta é a função arco tangente com dois argumentos, equivalente a atan(y/x) quando x > 0, mas trata corretamente todos os quatro quadrantes.
Sintaxe
double atan2(<y>, <x>)Parâmetros
y: Obrigatório. Coordenada y do ponto. Aceita DOUBLE. Valores STRING, BIGINT e DECIMAL são convertidos implicitamente para DOUBLE antes do cálculo.
x: Obrigatório. Coordenada x do ponto. Aceita DOUBLE. Valores STRING, BIGINT e DECIMAL são convertidos implicitamente para DOUBLE antes do cálculo.
O primeiro argumento é a coordenada y, não a coordenada x. Essa ordem inverte a convenção usual (x, y) e é uma fonte comum de erros.
Valor de retorno
Retorna um valor DOUBLE no intervalo [-π, π], em radianos. Se y ou x for null, retorna null.
Observações de uso
Valores STRING, BIGINT e DECIMAL são convertidos implicitamente para DOUBLE.
Se qualquer argumento for null, o retorno será null.
O valor retornado está em radianos, não em graus.
Exemplos
-- Returns 0.0, the angle for the origin point (x=0, y=0)
select atan2(0, 0);
-- Returns 0.7853981633974483 (π/4), the angle for the point (x=1, y=1)
select atan2(1, 1);
-- Returns 0.0, the angle for a point on the positive x-axis (x=1, y=0)
select atan2(0, 1);Funções relacionadas
ATAN2 é uma função matemática. Para obter mais informações sobre funções de computação e conversão de dados, consulte Funções matemáticas.