WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Math.acos: Arkuskosinus

Math.acos liefert den Arkuskosinus einer Zahl im Bogenmaß mit reeller Domäne -1 bis 1 und Ergebnis 0 bis π.

Version: ECMAScript 1 onward; example target: Node.js 24.22.2

Syntax

Math.acos(x)

Math.acos(x) wendet ToNumber an und berechnet den Hauptwert des inversen Kosinus. Für x in [-1, 1] liegt das Ergebnis in [0, π]: acos(1) ist +0, acos(0) etwa π/2 und acos(-1) etwa π. Das Number-Ergebnis ist meist eine Näherung.

Endliche Werte außerhalb [-1, 1], ±Infinity, NaN oder fehlendes Argument ergeben NaN. Numerische Zeichenketten werden umgewandelt, Symbol und BigInt lösen TypeError aus; Objekte können valueOf oder toString ausführen. Die Näherung darf implementierungsabhängig sein.

Kein Konstruktor, seit ECMAScript 1 Standard. Das Ergebnis ist im Bogenmaß; Grad sind radians * 180 / Math.PI. Bei Winkeln aus einem Skalarprodukt den Quotienten auf [-1, 1] begrenzen, damit Rundungsfehler kein NaN erzeugen.

Beispiele

function angleBetween([ax, ay], [bx, by]) {
  const quotient = (ax * bx + ay * by) / (Math.hypot(ax, ay) * Math.hypot(bx, by));
  return Math.acos(Math.max(-1, Math.min(1, quotient)));
}
const angle = angleBetween([1, 0], [0, 1]);
console.log(angle.toFixed(6), (angle * 180 / Math.PI).toFixed(1));
console.log(Math.acos(1), Math.acos(-1).toFixed(6));
console.log(Number.isNaN(Math.acos(1.1)), Number.isNaN(Math.acos()));
try { Math.acos(1n); } catch (error) { console.log(error instanceof TypeError); }

Ergebnis

1.570796 90.0
0 3.141593
true true
true

Quellen