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 = 1 2 ln ( 1 + x 1 − x ) \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

関連情報