【JavaScript ECMAScript】Math::Math.atan2静的メソッドの使い方
Math.atan2()静的メソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Math.atan2()メソッドは、指定された点のY座標とX座標から、その点と原点 (0,0) を結ぶ線分がX軸の正の方向となす角度をラジアン単位で計算するメソッドです。このメソッドは、atan2(y, x) の形式で、第一引数にY座標、第二引数にX座標の順で2つの数値を指定します。
返される角度は、-π（約-3.14159、すなわち-180度）からπ（約3.14159、すなわち180度）の範囲となり、座標が位置する象限（XY平面のどの領域にあるか）を正確に判断して、適切な角度を返します。これにより、例えば (x, y) = (1, 1) であれば45度、(x, y) = (-1, 1) であれば135度のように、点の位置に応じた正しい角度が求められます。
一般的なアークタンジェント関数である Math.atan() がY/Xの結果から角度を求めるのに対し、Math.atan2() はYとXを個別に受け取るため、Xがゼロの場合や、XとYの符号によって生じる角度の曖昧さを解消し、より正確な結果を提供します。例えば、ゲーム開発でキャラクターの向きを計算したり、科学計算でベクトルの方向を求めたりする際に非常に有用です。
なお、戻り値はラジアン単位であるため、もし度数法（°）で扱いたい場合は、(角度 * 180 / Math.PI) の計算によって変換する必要があります。
公式リファレンス: Math.atan2()
構文(syntax)
1Math.atan2(y, x);
引数(parameters)
y, x
- y: number: y座標を指定する数値
- x: number: x座標を指定する数値
戻り値(return)
number
指定された2つの数値の比率から、X軸との角度をラジアン単位の数値で返します。