Math.asin()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

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

試してみましょう

// 直角三角形の角度をラジアンで計算する
function calcAngle(opposite, hypotenuse) {
  return Math.asin(opposite / hypotenuse);
}

console.log(calcAngle(6, 10));
// 予想される結果: 0.6435011087932844

console.log(calcAngle(5, 3));
// 予想される結果: NaN

構文

Math.asin(x)

引数

-1 ～ 1 の間で両端を含む数値であり、角度の正弦値（サイン）を表します。

返値

x の逆正弦（アークサイン）（両端を含む -π2-\frac{\pi}{2} ～ π2\frac{\pi}{2}）です。 x が -1 未満または 1 を超える場合は NaN を返します。

解説

asin() は Math の静的メソッドであるため、生成した Math オブジェクトのメソッドとしてではなく、常に Math.asin() として使用するようにしてください (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