From 92cb1877c9f29de25ba271fbe5c25aff39412157 Mon Sep 17 00:00:00 2001
From: "Dr.XYZ" <121708493+Dr-XYZ@users.noreply.github.com>
Date: Sun, 22 Dec 2024 15:10:20 +0800
Subject: [PATCH] [zh-TW]: create `Math.atan()` (#25124)

---
 .../global_objects/math/atan/index.md         | 69 +++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 files/zh-tw/web/javascript/reference/global_objects/math/atan/index.md

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()`** 靜態方法回傳數字的反正切值（單位為弧度），也就是說：
+
+<math display="block">
+  <semantics><mrow><mrow><mo lspace="0em" rspace="0.16666666666666666em">𝙼𝚊𝚝𝚑.𝚊𝚝𝚊𝚗</mo><mo stretchy="false">(</mo><mi>𝚡</mi><mo stretchy="false">)</mo></mrow><mo>=</mo><mo lspace="0em" rspace="0em">arctan</mo><mo stretchy="false">(</mo><mi>x</mi><mo stretchy="false">)</mo><mo>=</mo><mtext>the unique&nbsp;</mtext><mi>y</mi><mo>∊</mo><mrow><mo>[</mo><mrow><mo>−</mo><mfrac><mi>π</mi><mn>2</mn></mfrac><mo>,</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><mo>]</mo></mrow><mtext>&nbsp;such that&nbsp;</mtext><mo lspace="0em" rspace="0em">tan</mo><mo stretchy="false">(</mo><mi>y</mi><mo stretchy="false">)</mo><mo>=</mo><mi>x</mi></mrow><annotation encoding="TeX">\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</annotation></semantics>
+</math>
+
+{{EmbedInteractiveExample("pages/js/math-atan.html")}}
+
+## 語法
+
+```js-nolint
+Math.atan(x)
+```
+
+### 參數
+
+- `x`
+  - : 一個數字。
+
+### 回傳值
+
+`x` 的反正切值（單位為弧度，範圍包含 <math><semantics><mrow><mo>-</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><annotation encoding="TeX">-\frac{\pi}{2}</annotation></semantics></math> 到 <math><semantics><mfrac><mi>π</mi><mn>2</mn></mfrac><annotation encoding="TeX">\frac{\pi}{2}</annotation></semantics></math>）。如果 `x` 是 {{jsxref("Infinity")}}，則回傳 <math><semantics><mfrac><mi>π</mi><mn>2</mn></mfrac><annotation encoding="TeX">\frac{\pi}{2}</annotation></semantics></math>。如果 `x` 是 `-Infinity`，則回傳 <math><semantics><mrow><mo>-</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><annotation encoding="TeX">-\frac{\pi}{2}</annotation></semantics></math>。
+
+## 描述
+
+由於 `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()")}}