CKTIS / JavaScript
Math.asin: Arkussinus
Math.asin liefert den Arkussinus einer Zahl im Bogenmaß mit reeller Domäne -1 bis 1 und Ergebnis -π/2 bis π/2.
Version: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
Math.asin(x)Math.asin(x) wendet ToNumber an und berechnet den Hauptwert des inversen Sinus. Für x in [-1, 1] liegt das Ergebnis in [-π/2, π/2]: asin(1) ist etwa π/2 und asin(-1) etwa -π/2. Das Vorzeichen von Null bleibt erhalten: +0 bleibt +0 und -0 bleibt -0.
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 Number-Näherung darf implementierungsabhängig sein.
Kein Konstruktor, seit ECMAScript 1 Standard. Das Ergebnis ist im Bogenmaß; Grad sind radians * 180 / Math.PI. Eine berechnete normierte Komponente auf [-1, 1] begrenzen, damit Rundungsfehler keinen gültigen Winkel in NaN verwandeln.
Beispiele
function pitchFromVerticalComponent(y) {
return Math.asin(Math.max(-1, Math.min(1, y)));
}
const angle = pitchFromVerticalComponent(0.5);
console.log(angle.toFixed(6), (angle * 180 / Math.PI).toFixed(1));
console.log(Math.asin(1).toFixed(6), Math.asin(-1).toFixed(6));
console.log(Object.is(Math.asin(-0), -0));
console.log(Number.isNaN(Math.asin(1.1)), Number.isNaN(Math.asin()));
try { Math.asin(1n); } catch (error) { console.log(error instanceof TypeError); }Ergebnis
0.523599 30.0 1.570796 -1.570796 true true true true