Math.atan() 回傳一個數字的反正切值,以弧度表示,範圍落在 -π/2 到 π/2 之間。
Math.atan(x);
<html>
<head>
<title>JavaScript Math atan() Method</title>
</head>
<body>
<script type="text/javascript">
var value = Math.atan(-1);
document.write("First Test Value : " + value);
var value = Math.atan(.5);
document.write("<br />Second Test Value : " + value);
var value = Math.atan(30);
document.write("<br />Third Test Value : " + value);
var value = Math.atan("string");
document.write("<br />Fourth Test Value : " + value);
</script>
</body>
</html>
First Test Value : -0.7853981633974483
Second Test Value : 0.4636476090008061
Third Test Value : 1.5374753309166493
Fourth Test Value : NaN
第一個例子 -0.7854 就是 -π/4;第三個例子值得留意:輸入 30 時結果是 1.5375,非常接近但不等於 π/2(約 1.5708)。這正是 atan 的特性——它的值域有水平漸近線,輸入越大越靠近 π/2,但永遠不會達到。最後一個例子則示範非數字輸入會得到 NaN。
這是實務上最容易混淆的一點。Math.atan(y / x) 只能給出 -90 度到 90 度之間的角度,因此無法區分「第一象限」與「第三象限」、「第二象限」與「第四象限」——因為相除後的正負號資訊已經被壓縮掉了。
// 只適用於已知 x 為正的情況
var angle1 = Math.atan(y / x);
// 通用做法:保留完整 360 度資訊
var angle2 = Math.atan2(y, x);
同時,atan2 在 x 為 0 時不會產生 Infinity 或 NaN,能正確回傳 ±π/2。因此在做指標指向、物件旋轉、向量角度計算時,幾乎都應該選 Math.atan2(y, x),並注意參數順序是「y 在前、x 在後」。