CKTIS / JavaScript
Math.asin: arkussinus
Math.asin vrátí arkussinus čísla v radiánech s reálným oborem -1 až 1 a výsledkem -π/2 až π/2.
Verze: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntaxe
Math.asin(x)Math.asin(x) použije ToNumber a vypočte hlavní hodnotu inverzního sinu. Pro x v [-1, 1] je výsledek v [-π/2, π/2]: asin(1) je asi π/2 a asin(-1) asi -π/2. Znaménko nuly se zachová: +0 dá +0 a -0 dá -0.
Konečná hodnota mimo [-1, 1], ±Infinity, NaN nebo chybějící argument dá NaN. Číselný řetězec se převede, ale Symbol či BigInt vyvolá TypeError; objekt může spustit valueOf nebo toString. Aproximace Number může záviset na implementaci.
Není konstruktor a je standardní od ECMAScript 1. Výsledek je v radiánech; stupně = radians * 180 / Math.PI. Vypočtenou normalizovanou složku omezte na [-1, 1], aby chyba zaokrouhlení nezměnila platný úhel v NaN.
Příklady
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); }Výsledek
0.523599 30.0 1.570796 -1.570796 true true true true