forked from docs/doc-exports
Su, Xiaomeng
76a5b1ee83
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>
67 lines
7.3 KiB
HTML
67 lines
7.3 KiB
HTML
<a name="dli_spark_round"></a><a name="dli_spark_round"></a>
|
|
|
|
<h1 class="topictitle1">round</h1>
|
|
<div id="body8662426"><p id="dli_spark_round__en-us_topic_0000001696401529_p18471163815215">This function is used to calculate the rounded value of <strong id="dli_spark_round__en-us_topic_0000001696401529_b19565205573815">a</strong> up to <strong id="dli_spark_round__en-us_topic_0000001696401529_b1364560193920">d</strong> decimal places.</p>
|
|
<div class="section" id="dli_spark_round__en-us_topic_0000001696401529_section45291954203217"><h4 class="sectiontitle">Syntax</h4><pre class="screen" id="dli_spark_round__en-us_topic_0000001696401529_screen19928459112517">round(DOUBLE a, INT d)</pre>
|
|
</div>
|
|
<div class="section" id="dli_spark_round__en-us_topic_0000001696401529_section992014913317"><h4 class="sectiontitle">Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_spark_round__en-us_topic_0000001696401529_table1829154762513" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters</caption><thead align="left"><tr id="dli_spark_round__en-us_topic_0000001696401529_row8830104792517"><th align="left" class="cellrowborder" valign="top" width="19.220000000000002%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_spark_round__en-us_topic_0000001696401529_p983074711252">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.44%" id="mcps1.3.3.2.2.5.1.2"><p id="dli_spark_round__en-us_topic_0000001696401529_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_round__en-us_topic_0000001696401529_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_round__en-us_topic_0000001696401529_p08301547132513">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_spark_round__en-us_topic_0000001696401529_row15830184792511"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_round__en-us_topic_0000001696401529_p683034714250">a</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.44%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_round__en-us_topic_0000001696401529_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_round__en-us_topic_0000001696401529_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_round__en-us_topic_0000001696401529_p37477568343">It indicates the value to be rounded off.</p>
|
|
<p id="dli_spark_round__en-us_topic_0000001696401529_p18653154615263">The value can be a float, integer, or string.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_spark_round__en-us_topic_0000001696401529_row112631310103410"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_round__en-us_topic_0000001696401529_p42631010103415">d</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.44%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_round__en-us_topic_0000001696401529_p2264610123412">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.57%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_spark_round__en-us_topic_0000001696401529_p15264121016349">INT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.77%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_spark_round__en-us_topic_0000001696401529_p14324122945216">The default value is <strong id="dli_spark_round__en-us_topic_0000001696401529_b7954111318191">0</strong>.</p>
|
|
<p id="dli_spark_round__en-us_topic_0000001696401529_p22641410133416">It indicates the number of decimal places to which the value needs to be rounded.</p>
|
|
<p id="dli_spark_round__en-us_topic_0000001696401529_p1185414237352">If the value is not of the INT type, the system will implicitly convert it to the INT type for calculation.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_spark_round__en-us_topic_0000001696401529_section210162513312"><h4 class="sectiontitle">Return Values</h4><p id="dli_spark_round__en-us_topic_0000001696401529_p184124317231">The return value is of the DOUBLE type.</p>
|
|
<div class="note" id="dli_spark_round__en-us_topic_0000001696401529_note61422099395"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dli_spark_round__en-us_topic_0000001696401529_ul175181918368"><li id="dli_spark_round__en-us_topic_0000001696401529_li47591912362">If the value of <strong id="dli_spark_round__en-us_topic_0000001696401529_b1896174451915">d</strong> is negative, an error is reported.</li><li id="dli_spark_round__en-us_topic_0000001696401529_li1108421103616">If the value of <strong id="dli_spark_round__en-us_topic_0000001696401529_b16806208076613">a</strong> or <strong id="dli_spark_round__en-us_topic_0000001696401529_b19434889836613">d</strong> is <strong id="dli_spark_round__en-us_topic_0000001696401529_b18031724806613">NULL</strong>, <strong id="dli_spark_round__en-us_topic_0000001696401529_b4324942976613">NULL</strong> is returned.</li></ul>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="dli_spark_round__en-us_topic_0000001696401529_section13277192233920"><h4 class="sectiontitle">Example Code</h4><p id="dli_spark_round__en-us_topic_0000001696401529_p195861130142016">The value <strong id="dli_spark_round__en-us_topic_0000001696401529_b14923208102013">123.0</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_round__en-us_topic_0000001696401529_screen10374522016">select round(123.321);</pre>
|
|
<p id="dli_spark_round__en-us_topic_0000001696401529_p363616318201">The value <strong id="dli_spark_round__en-us_topic_0000001696401529_b77072214207">123.4</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_round__en-us_topic_0000001696401529_screen1912515501206">select round(123.396, 1);</pre>
|
|
<p id="dli_spark_round__en-us_topic_0000001696401529_p114581833132018">The value <strong id="dli_spark_round__en-us_topic_0000001696401529_b731453032011">NULL</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_round__en-us_topic_0000001696401529_screen31081412217">select round(null);</pre>
|
|
<p id="dli_spark_round__en-us_topic_0000001696401529_p1550363414202">The value <strong id="dli_spark_round__en-us_topic_0000001696401529_b1293443613205">123.321</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_round__en-us_topic_0000001696401529_screen5155131212118">select round(123.321, 4);</pre>
|
|
<p id="dli_spark_round__en-us_topic_0000001696401529_p12634193552010">The value <strong id="dli_spark_round__en-us_topic_0000001696401529_b115824772016">123.3</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_round__en-us_topic_0000001696401529_screen12564102292111">select round(123.321,1.33333);</pre>
|
|
<p id="dli_spark_round__en-us_topic_0000001696401529_p05373852017">The value <strong id="dli_spark_round__en-us_topic_0000001696401529_b262615018200">123.3</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_round__en-us_topic_0000001696401529_screen1760593112212">select round(123.321,1.33333);</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>
|
|
|