Math.atanh()

Baseline Widely available

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

Math.atanh() は静的メソッドで、数値の双曲線逆正接 (ハイパーボリックアークタンジェント) を返します。

x(1,1),𝙼𝚊𝚝𝚑.𝚊𝚝𝚊𝚗𝚑(𝚡)=artanh(x)=the unique y such that tanh(y)=x=12ln(1+x1x)\begin{aligned}\forall x \in ({-1}, 1),\;\mathtt{\operatorname{Math.atanh}(x)} &= \operatorname{artanh}(x) = \text{the unique } y \text{ such that } \tanh(y) = x \\&= \frac{1}{2}\,\ln\left(\frac{1+x}{1-x}\right)\end{aligned}

試してみましょう

構文

js
Math.atanh(x)

引数

x

-1 ~ 1 の間で両端を含む数値です。

返値

x の双曲線逆正接 (ハイパーボリックアークタンジェント) です。 x が 1 の場合、 Infinity を返します。 x が -1 の場合、 -Infinity を返します。 x が -1 未満であるか 1 より大きな場合は、 NaN を返します。

解説

atanh()Math の静的メソッドであるため、生成した Math オブジェクトのメソッドとしてではなく、常に Math.atanh() として使用するようにしてください (Math はコンストラクターではありません)。

Math.atanh() の使用

js
Math.atanh(-2); // NaN
Math.atanh(-1); // -Infinity
Math.atanh(-0); // -0
Math.atanh(0); // 0
Math.atanh(0.5); // 0.5493061443340548
Math.atanh(1); // Infinity
Math.atanh(2); // NaN

仕様書

Specification
ECMAScript Language Specification
# sec-math.atanh

ブラウザーの互換性

BCD tables only load in the browser

関連情報