forked from docs/doc-exports
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-authored-by: Su, Xiaomeng <suxiaomeng1@huawei.com> Co-committed-by: Su, Xiaomeng <suxiaomeng1@huawei.com>
52 lines
5.4 KiB
HTML
52 lines
5.4 KiB
HTML
<a name="dli_spark_aocs"></a><a name="dli_spark_aocs"></a>
|
|
|
|
<h1 class="topictitle1">acos</h1>
|
|
<div id="body8662426"><p id="dli_spark_aocs__en-us_topic_0000001696401497_p8060118">This function is used to return the arc cosine value of a given angle <strong id="dli_spark_aocs__en-us_topic_0000001696401497_b1032895219157">a</strong>.</p>
|
|
<div class="section" id="dli_spark_aocs__en-us_topic_0000001696401497_section45291954203217"><h4 class="sectiontitle">Syntax</h4><pre class="screen" id="dli_spark_aocs__en-us_topic_0000001696401497_screen19928459112517">acos(DOUBLE a)</pre>
|
|
</div>
|
|
<div class="section" id="dli_spark_aocs__en-us_topic_0000001696401497_section992014913317"><h4 class="sectiontitle">Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_spark_aocs__en-us_topic_0000001696401497_table1829154762513" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter</caption><thead align="left"><tr id="dli_spark_aocs__en-us_topic_0000001696401497_row8830104792517"><th align="left" class="cellrowborder" valign="top" width="16.64%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_spark_aocs__en-us_topic_0000001696401497_p983074711252">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.02%" id="mcps1.3.3.2.2.5.1.2"><p id="dli_spark_aocs__en-us_topic_0000001696401497_p6830124732517">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.57%" id="mcps1.3.3.2.2.5.1.3"><p id="dli_spark_aocs__en-us_topic_0000001696401497_p13318164512614">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="51.77%" id="mcps1.3.3.2.2.5.1.4"><p id="dli_spark_aocs__en-us_topic_0000001696401497_p08301547132513">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_spark_aocs__en-us_topic_0000001696401497_row15830184792511"><td class="cellrowborder" valign="top" width="16.64%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_aocs__en-us_topic_0000001696401497_p683034714250">a</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.02%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_aocs__en-us_topic_0000001696401497_p12830184752518">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.57%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_spark_aocs__en-us_topic_0000001696401497_p0318545102615">DOUBLE, BIGINT, DECIMAL, or STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.77%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_spark_aocs__en-us_topic_0000001696401497_p08215497384">The value range is [-1,1]. The value can be a float, integer, or string.</p>
|
|
<p id="dli_spark_aocs__en-us_topic_0000001696401497_p9484232112711">If the value is not of the DOUBLE type, the system will implicitly convert it to the DOUBLE type for calculation.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_spark_aocs__en-us_topic_0000001696401497_section210162513312"><h4 class="sectiontitle">Return Values</h4><p id="dli_spark_aocs__en-us_topic_0000001696401497_p1387835132114">The return value is of the DOUBLE type. The value ranges from 0 to π.</p>
|
|
<div class="note" id="dli_spark_aocs__en-us_topic_0000001696401497_note61422099395"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dli_spark_aocs__en-us_topic_0000001696401497_ul10778141512238"><li id="dli_spark_aocs__en-us_topic_0000001696401497_li1077814158233">If the value of <strong id="dli_spark_aocs__en-us_topic_0000001696401497_b560717276197">a</strong> is not within the range [-1,1], <strong id="dli_spark_aocs__en-us_topic_0000001696401497_b25501238161920">NaN</strong> is returned.</li><li id="dli_spark_aocs__en-us_topic_0000001696401497_li1555311815232">If the value of <strong id="dli_spark_aocs__en-us_topic_0000001696401497_b102543141631312">a</strong> is <strong id="dli_spark_aocs__en-us_topic_0000001696401497_b59138928431312">NULL</strong>, <strong id="dli_spark_aocs__en-us_topic_0000001696401497_b66786261331312">NULL</strong> is returned.</li></ul>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="dli_spark_aocs__en-us_topic_0000001696401497_section13277192233920"><h4 class="sectiontitle">Example Code</h4><p id="dli_spark_aocs__en-us_topic_0000001696401497_p172221918502">The value <strong id="dli_spark_aocs__en-us_topic_0000001696401497_b41051438172016">3.141592653589793</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_aocs__en-us_topic_0000001696401497_screen2318631705">select acos(-1);</pre>
|
|
<p id="dli_spark_aocs__en-us_topic_0000001696401497_p8842101914020">The value <strong id="dli_spark_aocs__en-us_topic_0000001696401497_b20599535954611">0</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_aocs__en-us_topic_0000001696401497_screen14853173318014">select acos(1);</pre>
|
|
<p id="dli_spark_aocs__en-us_topic_0000001696401497_p12511121708">The value <strong id="dli_spark_aocs__en-us_topic_0000001696401497_b699634982016">NULL</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_aocs__en-us_topic_0000001696401497_screen11726636804">select acos(null);</pre>
|
|
<p id="dli_spark_aocs__en-us_topic_0000001696401497_p1530718221309">The value <strong id="dli_spark_aocs__en-us_topic_0000001696401497_b12478129162113">NAN</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_aocs__en-us_topic_0000001696401497_screen18906439805">select acos(10);</pre>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_08_0473.html">Mathematical Functions</a></div>
|
|
</div>
|
|
</div>
|
|
|