1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
---
title: Math.asin()
slug: Web/JavaScript/Reference/Global_Objects/Math/asin
translation_of: Web/JavaScript/Reference/Global_Objects/Math/asin
original_slug: Web/JavaScript/Referencia/Objectes_globals/Math/asin
---
<div>{{JSRef("Global_Objects", "Math")}}</div>
<h2 id="Summary" name="Summary">Resum</h2>
<p>La funció <strong><code>Math.asin()</code></strong> retorna l'arcsinus (en radians) d'un nombre, és a dir:</p>
<p><math display="block"><semantics><mrow><mo>∀</mo><mi>x</mi><mo>∊</mo><mo stretchy="false">[</mo><mrow><mo>-</mo><mn>1</mn></mrow><mo>;</mo><mn>1</mn><mo stretchy="false">]</mo><mo>,</mo><mspace width="thickmathspace"></mspace><mstyle mathvariant="monospace"><mrow><mo lspace="0em" rspace="thinmathspace">Math.asin</mo><mo stretchy="false">(</mo><mi>x</mi><mo stretchy="false">)</mo></mrow></mstyle><mo>=</mo><mo lspace="0em" rspace="0em">arcsin</mo><mo stretchy="false">(</mo><mi>x</mi><mo stretchy="false">)</mo><mo>=</mo><mtext> l'únic </mtext><mspace width="thickmathspace"></mspace><mi>y</mi><mo>∊</mo><mrow><mo>[</mo><mrow><mo>-</mo><mfrac><mi>π</mi><mn>2</mn></mfrac><mo>;</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><mo>]</mo></mrow><mspace width="thinmathspace"></mspace><mtext>tal que </mtext><mo lspace="0em" rspace="0em">sin</mo><mo stretchy="false">(</mo><mi>y</mi><mo stretchy="false">)</mo><mo>=</mo><mi>x</mi></mrow><annotation encoding="TeX">\forall x \in [{-1};1],\;\mathtt{\operatorname{Math.asin}(x)} = \arcsin(x) = \text{ the unique } \; y \in \left[-\frac{\pi}{2}; \frac{\pi}{2}\right] \, \text{such that} \; \sin(y) = x</annotation></semantics></math></p>
<h2 id="Syntax" name="Syntax">Sintaxi</h2>
<pre class="syntaxbox"><code>Math.asin(<var>x</var>)</code></pre>
<h3 id="Parameters" name="Parameters">Paràmetres</h3>
<dl>
<dt><code>x</code></dt>
<dd>Un nombre.</dd>
</dl>
<h2 id="Description" name="Description">Descripció</h2>
<p>El mètode <code>Math.asin()</code> retorna un valor numèric entre <math><semantics><mrow><mo>-</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><annotation encoding="TeX">-\frac{\pi}{2}</annotation></semantics></math> i <math><semantics><mfrac><mi>π</mi><mn>2</mn></mfrac><annotation encoding="TeX">\frac{\pi}{2}</annotation></semantics></math> radians per a <code>x</code> entre -1 i 1. Si el valor de <code>x</code> està fora d'aquest rang la funció retorna {{jsxref("NaN")}}.</p>
<p>Degut a que <code>asin()</code> és un mètode estàtic de <code>Math</code>, sempre s'utilitza com a <code>Math.asin()</code>, en comptes de com a mètode d'una instància de <code>Math</code> (<code>Math</code> no és un constructor).</p>
<h2 id="Examples" name="Examples">Exemples</h2>
<h3 id="Example:_Using_Math.asin" name="Example:_Using_Math.asin">Exemple: Ús de <code>Math.asin()</code></h3>
<pre class="brush: js">Math.asin(-2); // NaN
Math.asin(-1); // -1.5707963267948966 (-pi/2)
Math.asin(0); // 0
Math.asin(0.5); // 0.5235987755982989
Math.asin(1); // 1.570796326794897 (pi/2)
Math.asin(2); // NaN
</pre>
<p>Per a valors menors que -1 o majors que 1, <code>Math.asin()</code> retorna {{jsxref("NaN")}}.</p>
<h2 id="Specifications" name="Specifications">Especificacions</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Especificació</th>
<th scope="col">Estat</th>
<th scope="col">Comentaris</th>
</tr>
<tr>
<td>ECMAScript 1a Edició.</td>
<td>Standard</td>
<td>Definició inicial. Implementat a JavaScript 1.0.</td>
</tr>
<tr>
<td>{{SpecName('ES5.1', '#sec-15.8.2.3', 'Math.asin')}}</td>
<td>{{Spec2('ES5.1')}}</td>
<td> </td>
</tr>
<tr>
<td>{{SpecName('ES6', '#sec-math.asin', 'Math.asin')}}</td>
<td>{{Spec2('ES6')}}</td>
<td> </td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility" name="Browser_compatibility">Compatibilitat amb navegadors</h2>
<div>{{CompatibilityTable}}</div>
<div id="compat-desktop">
<table class="compat-table">
<tbody>
<tr>
<th>Característica</th>
<th>Chrome</th>
<th>Firefox (Gecko)</th>
<th>Internet Explorer</th>
<th>Opera</th>
<th>Safari</th>
</tr>
<tr>
<td>Suport bàsic</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
</tr>
</tbody>
</table>
</div>
<div id="compat-mobile">
<table class="compat-table">
<tbody>
<tr>
<th>Característica</th>
<th>Android</th>
<th>Chrome for Android</th>
<th>Firefox Mobile (Gecko)</th>
<th>IE Mobile</th>
<th>Opera Mobile</th>
<th>Safari Mobile</th>
</tr>
<tr>
<td>Suport bàsic</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
</tr>
</tbody>
</table>
</div>
<h2 id="See_also" name="See_also">Vegeu també</h2>
<ul>
<li>{{jsxref("Math.acos()")}}</li>
<li>{{jsxref("Math.atan()")}}</li>
<li>{{jsxref("Math.atan2()")}}</li>
<li>{{jsxref("Math.cos()")}}</li>
<li>{{jsxref("Math.sin()")}}</li>
<li>{{jsxref("Math.tan()")}}</li>
</ul>
|
