diff --git a/files/zh-tw/web/javascript/reference/global_objects/math/atan/index.md b/files/zh-tw/web/javascript/reference/global_objects/math/atan/index.md new file mode 100644 index 00000000000000..11d8fa332d5639 --- /dev/null +++ b/files/zh-tw/web/javascript/reference/global_objects/math/atan/index.md @@ -0,0 +1,69 @@ +--- +title: Math.atan() +slug: Web/JavaScript/Reference/Global_Objects/Math/atan +l10n: + sourceCommit: 761b9047d78876cbd153be811efb1aa77b419877 +--- + +{{JSRef}} + +**`Math.atan()`** 靜態方法回傳數字的反正切值(單位為弧度),也就是說: + + + 𝙼𝚊𝚝𝚑.𝚊𝚝𝚊𝚗(𝚡)=arctan(x)=the unique y[π2,π2] such that tan(y)=x\mathtt{\operatorname{Math.atan}(x)} = \arctan(x) = \text{the unique } y \in \left[-\frac{\pi}{2}, \frac{\pi}{2}\right] \text{ such that } \tan(y) = x + + +{{EmbedInteractiveExample("pages/js/math-atan.html")}} + +## 語法 + +```js-nolint +Math.atan(x) +``` + +### 參數 + +- `x` + - : 一個數字。 + +### 回傳值 + +`x` 的反正切值(單位為弧度,範圍包含 -π2-\frac{\pi}{2}π2\frac{\pi}{2})。如果 `x` 是 {{jsxref("Infinity")}},則回傳 π2\frac{\pi}{2}。如果 `x` 是 `-Infinity`,則回傳 -π2-\frac{\pi}{2}。 + +## 描述 + +由於 `atan()` 是 `Math` 的靜態方法,你必須使用 `Math.atan()` 來呼叫它,而不是呼叫你所建立的 `Math` 物件的方法(`Math` 不是建構子)。 + +## 範例 + +### 使用 Math.atan() + +```js +Math.atan(-Infinity); // -1.5707963267948966 (-π/2) +Math.atan(-0); // -0 +Math.atan(0); // 0 +Math.atan(1); // 0.7853981633974483 (π/4) +Math.atan(Infinity); // 1.5707963267948966 (π/2) + +// 計算 (0,0) 到 (x,y) 之間的直線與 x 軸的角度 +const theta = (x, y) => Math.atan(y / x); +``` + +注意,在某些情況下(例如 `x` 為 `0` 時),`theta` 函式可能會回傳 `NaN`,因此建議使用 {{jsxref("Math.atan2()")}},因為它的範圍更廣(-π 到 π)且能避免這類問題。 + +## 規範 + +{{Specifications}} + +## 瀏覽器相容性 + +{{Compat}} + +## 參見 + +- {{jsxref("Math.acos()")}} +- {{jsxref("Math.asin()")}} +- {{jsxref("Math.atan2()")}} +- {{jsxref("Math.cos()")}} +- {{jsxref("Math.sin()")}} +- {{jsxref("Math.tan()")}}