Método WorksheetFunction.Atan2 (Excel)

Retorna o arco tangente, ou a tangente inversa, das coordenadas x e y especificadas. O arco tangente é o ângulo a partir do eixo x até uma linha contendo a origem (0, 0) e um ponto com as coordenadas (núm_x, núm_y). O ângulo é dado em radianos entre -pi e pi, excluindo -pi.

Sintaxe

expressão. Atan2 (Arg1, Arg2)

Expressão Uma variável que representa um objeto WorksheetFunction .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Arg1 Obrigatório Double A coordenada x do ponto.
Arg2 Obrigatório Double A coordenada y do ponto.

Valor de retorno

Double

Comentários

Um resultado positivo representa um ângulo no sentido anti-horário a partir do eixo x; um resultado negativo representa um ângulo no sentido horário.

A seguintes condições se aplicam:

  • Onde x > 0 ATAN2(x,y) = ATAN(y/x)

  • Onde y >= 0, x < 0 ATAN2(x,y) = ATAN(y/x)+PI()

  • Onde y < 0, x < 0 ATAN2(x,y) = ATAN(y/x) – PI()

  • Onde y > 0, x = 0 ATAN2(x,y) = PI()/2

  • Onde y < 0, x = 0 ATAN2(x,y) = -PI()/2

  • Se x e y forem 0, Atan2 retornará um valor de erro.

Para expressar o arctangent em graus, multiplique o resultado por 180/PI ou use o método Degrees .

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.