diff --git a/files/zh-tw/web/javascript/reference/global_objects/math/asin/index.md b/files/zh-tw/web/javascript/reference/global_objects/math/asin/index.md new file mode 100644 index 00000000000000..9aab854103a1d0 --- /dev/null +++ b/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()`** 靜態方法回傳數字的反正弦值(單位為弧度)。也就是說, + + + x[1,1],𝙼𝚊𝚝𝚑.𝚊𝚜𝚒𝚗(𝚡)=arcsin(x)=the unique y[π2,π2] such that sin(y)=x\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 + + +{{EmbedInteractiveExample("pages/js/math-asin.html")}} + +## 語法 + +```js-nolint +Math.asin(x) +``` + +### 參數 + +- `x` + - : 一個介於 -1 到 1 之間(包含邊界)的數字,表示角度的正弦值。 + +### 回傳值 + +`x` 的反正弦值(單位為弧度,範圍介於 -π2-\frac{\pi}{2}π2\frac{\pi}{2} 之間,包含邊界)。如果 `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()")}}