--- title: Math.acosh() slug: Web/JavaScript/Reference/Global_Objects/Math/acosh tags: - JavaScript - Math - Method - Reference translation_of: Web/JavaScript/Reference/Global_Objects/Math/acosh ---
{{JSRef}}

Die Funktion Math.acosh() gibt den hyperbolischen Arkuskosinus einer Zahl zurück:

x1,Math.acosh(x)=arcosh(x)= das Ergebnis y0so  dasscosh(y)=x\forall x \geq 1, \mathtt{\operatorname{Math.acosh}(x)} = \operatorname{arcosh}(x) = \text{ the unique } \; y \geq 0 \; \text{such that} \; \cosh(y) = x

{{EmbedInteractiveExample("pages/js/math-acosh.html")}}

Syntax

Math.acosh(x)

Parameter

x
Eine Zahl.

Rückgabewert

Der hyperbolische Arkuskosinus der übergebenen Zahl. Wenn die Zahl kleiner als 1 ist, wird {{jsxref("NaN")}} zurückgegeben.

Beschreibung

Weil acosh() eine statische Methode von Math ist, muss diese immer mit Math.acosh() genutzt werden, ohne dass ein Objekt von Math erstellt wird (Math ist kein Konstruktor).

Beispiele

Verwendung von Math.acosh()

Math.acosh(-1); // NaN
Math.acosh(0);  // NaN
Math.acosh(0.5) // NaN
Math.acosh(1);  // 0
Math.acosh(2);  // 1.3169578969248166

Für Werte kleiner 1 Math.acosh() gibt Math.acosh {{jsxref("NaN")}} zurück.

Polyfill

Für x1x \geq 1 gilt: arcosh(x)=ln(x+x2-1)\operatorname {arcosh} (x) = \ln \left(x + \sqrt{x^{2} - 1} \right), daher kann dieses mit der folgenden Funktion emuliert werden:

Math.acosh = Math.acosh || function(x) {
  return Math.log(x + Math.sqrt(x * x - 1));
};

Spezifikationen

Spezifikation Status Kommentar
{{SpecName('ES6', '#sec-math.acosh', 'Math.acosh')}} {{Spec2('ES6')}} Initiale Definition.
{{SpecName('ESDraft', '#sec-math.acosh', 'Math.acosh')}} {{Spec2('ESDraft')}}  

Browserkompatibilität

{{Compat("javascript.builtins.Math.acosh")}}

Siehe auch