Math.Atan2(Double, Double) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve el ángulo cuya tangente es el cociente de dos números especificados.
public:
static double Atan2(double y, double x);
public static double Atan2 (double y, double x);
static member Atan2 : double * double -> double
Public Shared Function Atan2 (y As Double, x As Double) As Double
Parámetros
- y
- Double
Coordenada Y de un punto.
- x
- Double
Coordenada X de un punto.
Devoluciones
Ángulo, θ, medido en radianes, de modo que tan(θ) = y
/ x
, donde (x
, y
) es un punto en el plano cartesiano. Observe lo siguiente:
Para (
x
,y
) en el cuadrante 1, 0 < θ < π/2.Para (
x
,y
) en el cuadrante 2, π/2 < θ ≤ π.Para (
x
,y
) en el cuadrante 3, -π ≤ θ < -π/2.Para (
x
,y
) en el cuadrante 4, -π/2 < θ < 0.
Para los puntos en los límites de los cuadrantes, el valor devuelto es el siguiente:
Si y es 0 y x no es negativo, θ = 0.
Si y es 0 y x es negativo, θ = π.
Si y es positivo y x es 0, θ = π/2.
Si y es negativo y el valor de x es 0, θ = -π/2.
Si y es 0 y x es 0, θ = 0.
Si x
o y
es NaN o si x
y y
son PositiveInfinity o NegativeInfinity, el método devuelve NaN.
Ejemplos
En el ejemplo siguiente se muestra cómo calcular la arcotangente de un ángulo y un vector. El valor resultante se muestra en la consola.
// This example demonstrates Math.Atan()
// Math.Atan2()
// Math.Tan()
using namespace System;
int main()
{
double x = 1.0;
double y = 2.0;
double angle;
double radians;
double result;
// Calculate the tangent of 30 degrees.
angle = 30;
radians = angle * (Math::PI / 180);
result = Math::Tan( radians );
Console::WriteLine( "The tangent of 30 degrees is {0}.", result );
// Calculate the arctangent of the previous tangent.
radians = Math::Atan( result );
angle = radians * (180 / Math::PI);
Console::WriteLine( "The previous tangent is equivalent to {0} degrees.", angle );
// Calculate the arctangent of an angle.
String^ line1 = "{0}The arctangent of the angle formed by the x-axis and ";
String^ line2 = "a vector to point ({0},{1}) is {2}, ";
String^ line3 = "which is equivalent to {0} degrees.";
radians = Math::Atan2( y, x );
angle = radians * (180 / Math::PI);
Console::WriteLine( line1, Environment::NewLine );
Console::WriteLine( line2, x, y, radians );
Console::WriteLine( line3, angle );
}
/*
This example produces the following results:
The tangent of 30 degrees is 0.577350269189626.
The previous tangent is equivalent to 30 degrees.
The arctangent of the angle formed by the x-axis and
a vector to point (1,2) is 1.10714871779409,
which is equivalent to 63.434948822922 degrees.
*/
// This example demonstrates Math.Atan()
// Math.Atan2()
// Math.Tan()
using System;
class Sample
{
public static void Main()
{
double x = 1.0;
double y = 2.0;
double angle;
double radians;
double result;
// Calculate the tangent of 30 degrees.
angle = 30;
radians = angle * (Math.PI/180);
result = Math.Tan(radians);
Console.WriteLine("The tangent of 30 degrees is {0}.", result);
// Calculate the arctangent of the previous tangent.
radians = Math.Atan(result);
angle = radians * (180/Math.PI);
Console.WriteLine("The previous tangent is equivalent to {0} degrees.", angle);
// Calculate the arctangent of an angle.
String line1 = "{0}The arctangent of the angle formed by the x-axis and ";
String line2 = "a vector to point ({0},{1}) is {2}, ";
String line3 = "which is equivalent to {0} degrees.";
radians = Math.Atan2(y, x);
angle = radians * (180/Math.PI);
Console.WriteLine(line1, Environment.NewLine);
Console.WriteLine(line2, x, y, radians);
Console.WriteLine(line3, angle);
}
}
/*
This example produces the following results:
The tangent of 30 degrees is 0.577350269189626.
The previous tangent is equivalent to 30 degrees.
The arctangent of the angle formed by the x-axis and
a vector to point (1,2) is 1.10714871779409,
which is equivalent to 63.434948822922 degrees.
*/
// This example demonstrates Math.Atan()
// Math.Atan2()
// Math.Tan()
// Functions 'atan', 'atan2', and 'tan' may be used instead.
open System
[<EntryPoint>]
let main _ =
let x = 1.
let y = 2.
// Calculate the tangent of 30 degrees.
let angle = 30.
let radians = angle * (Math.PI / 180.)
let result = Math.Tan radians
printfn $"The tangent of 30 degrees is {result}."
// Calculate the arctangent of the previous tangent.
let radians = Math.Atan result
let angle = radians * (180. / Math.PI)
printfn $"The previous tangent is equivalent to {angle} degrees."
// Calculate the arctangent of an angle.
let radians = Math.Atan2(y, x)
let angle = radians * (180. / Math.PI)
printfn
$"""The arctangent of the angle formed by the x-axis and
a vector to point ({x},{y}) is {radians},
which is equivalent to {angle} degrees."""
0
//This example produces the following results:
// The tangent of 30 degrees is 0.577350269189626.
// The previous tangent is equivalent to 30 degrees.
//
// The arctangent of the angle formed by the x-axis and
// a vector to point (1,2) is 1.10714871779409,
// which is equivalent to 63.434948822922 degrees.
' This example demonstrates Math.Atan()
' Math.Atan2()
' Math.Tan()
Class Sample
Public Shared Sub Main()
Dim x As Double = 1.0
Dim y As Double = 2.0
Dim angle As Double
Dim radians As Double
Dim result As Double
' Calculate the tangent of 30 degrees.
angle = 30
radians = angle *(Math.PI / 180)
result = Math.Tan(radians)
Console.WriteLine("The tangent of 30 degrees is {0}.", result)
' Calculate the arctangent of the previous tangent.
radians = Math.Atan(result)
angle = radians *(180 / Math.PI)
Console.WriteLine("The previous tangent is equivalent to {0} degrees.", angle)
' Calculate the arctangent of an angle.
Dim line1 As [String] = "{0}The arctangent of the angle formed by the x-axis and "
Dim line2 As [String] = "a vector to point ({0},{1}) is {2}, "
Dim line3 As [String] = "which is equivalent to {0} degrees."
radians = Math.Atan2(y, x)
angle = radians *(180 / Math.PI)
Console.WriteLine(line1, Environment.NewLine)
Console.WriteLine(line2, x, y, radians)
Console.WriteLine(line3, angle)
End Sub
End Class
'
'This example produces the following results:
'
'The tangent of 30 degrees is 0.577350269189626.
'The previous tangent is equivalent to 30 degrees.
'
'The arctangent of the angle formed by the x-axis and
'a vector to point (1,2) is 1.10714871779409,
'which is equivalent to 63.434948822922 degrees.
'
Comentarios
El valor devuelto es el ángulo del plano cartesiano formado por el eje X y un vector que comienza desde el origen (0,0) y termina en el punto (x,y).
Este método llama al entorno de ejecución de C subyacente y el resultado exacto o el intervalo de entrada válido pueden diferir entre diferentes sistemas operativos o arquitecturas.