このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Math.atanh()

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

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}

試してみましょう

console.log(Math.atanh(-1));
// 予想される結果: -Infinity

console.log(Math.atanh(0));
// 予想される結果: 0

console.log(Math.atanh(0.5));
// 予想される結果: 0.549306144334055 (およそ)

console.log(Math.atanh(1));
// 予想される結果: Infinity

構文

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

仕様書

仕様書
ECMAScript® 2027 Language Specification
# sec-math.atanh

ブラウザーの互換性

関連情報