[zh-TW]: create Math.asin()

files/zh-tw/web/javascript/reference/global_objects/math/asin/index.md

@@ -0,0 +1,66 @@
+---
+title: Math.asin()
+slug: Web/JavaScript/Reference/Global_Objects/Math/asin
+l10n:
+  sourceCommit: 761b9047d78876cbd153be811efb1aa77b419877
+---
+
+{{JSRef}}
+
+**`Math.asin()`** 靜態方法回傳數字的反正弦值（單位為弧度）。也就是說，
+
+<math display="block">
+  <semantics><mrow><mo>∀</mo><mi>x</mi><mo>∊</mo><mo stretchy="false">[</mo><mrow><mo>−</mo><mn>1</mn></mrow><mo>,</mo><mn>1</mn><mo stretchy="false">]</mo><mo>,</mo><mspace width="0.2777777777777778em"></mspace><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">arcsin</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">sin</mo><mo stretchy="false">(</mo><mi>y</mi><mo stretchy="false">)</mo><mo>=</mo><mi>x</mi></mrow><annotation encoding="TeX">\forall x \in [{-1}, 1],\;\mathtt{\operatorname{Math.asin}(x)} = \arcsin(x) = \text{the unique } y \in \left[-\frac{\pi}{2}, \frac{\pi}{2}\right] \text{ such that } \sin(y) = x</annotation></semantics>
+</math>
+
+{{EmbedInteractiveExample("pages/js/math-asin.html")}}
+
+## 語法
+
+```js-nolint
+Math.asin(x)
+```
+
+### 參數
+
+- `x`
+  - : 一個介於 -1 到 1 之間（包含邊界）的數字，表示角度的正弦值。
+
+### 回傳值
+
+`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` 小於 -1 或大於 1，則回傳 {{jsxref("NaN")}}。
+
+## 描述
+
+由於 `asin()` 是 `Math` 的靜態方法，你必須使用 `Math.asin()` 來呼叫它，而非呼叫你建立的 `Math` 物件的方法（`Math` 並非建構子）。
+
+## 範例
+
+### 使用 Math.asin()
+
+```js
+Math.asin(-2); // NaN
+Math.asin(-1); // -1.5707963267948966 (-π/2)
+Math.asin(-0); // -0
+Math.asin(0); // 0
+Math.asin(0.5); // 0.5235987755982989 (π/6)
+Math.asin(1); // 1.5707963267948966 (π/2)
+Math.asin(2); // NaN
+```
+
+## 規範
+
+{{Specifications}}
+
+## 瀏覽器相容性
+
+{{Compat}}
+
+## 參見
+
+- {{jsxref("Math.acos()")}}
+- {{jsxref("Math.atan()")}}
+- {{jsxref("Math.atan2()")}}
+- {{jsxref("Math.cos()")}}
+- {{jsxref("Math.sin()")}}
+- {{jsxref("Math.tan()")}}