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>
64 lines
9.4 KiB
HTML
64 lines
9.4 KiB
HTML
<a name="dli_spark_trunc"></a><a name="dli_spark_trunc"></a>
|
|
|
|
<h1 class="topictitle1">trunc</h1>
|
|
<div id="body8662426"><p id="dli_spark_trunc__en-us_topic_0000001647771668_p16433433161116">This function is used to reset a date to a specific format.</p>
|
|
<p id="dli_spark_trunc__en-us_topic_0000001647771668_p18471163815215">Resetting means returning to default values, where the default values for year, month, and day are <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b176851210133">01</strong>, and the default values for hour, minute, second, and millisecond are <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b1156910193135">00</strong>.</p>
|
|
<div class="section" id="dli_spark_trunc__en-us_topic_0000001647771668_section45291954203217"><h4 class="sectiontitle">Syntax</h4><pre class="screen" id="dli_spark_trunc__en-us_topic_0000001647771668_screen16141162410365">trunc(string date, string format)</pre>
|
|
</div>
|
|
<div class="section" id="dli_spark_trunc__en-us_topic_0000001647771668_section992014913317"><h4 class="sectiontitle">Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_spark_trunc__en-us_topic_0000001647771668_table1311123023717" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters</caption><thead align="left"><tr id="dli_spark_trunc__en-us_topic_0000001647771668_row81123018371"><th align="left" class="cellrowborder" valign="top" width="19.220000000000002%" id="mcps1.3.4.2.2.5.1.1"><p id="dli_spark_trunc__en-us_topic_0000001647771668_p911153012374">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.43%" id="mcps1.3.4.2.2.5.1.2"><p id="dli_spark_trunc__en-us_topic_0000001647771668_p17114302373">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.62%" id="mcps1.3.4.2.2.5.1.3"><p id="dli_spark_trunc__en-us_topic_0000001647771668_p81173023718">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="46.73%" id="mcps1.3.4.2.2.5.1.4"><p id="dli_spark_trunc__en-us_topic_0000001647771668_p811113063717">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_spark_trunc__en-us_topic_0000001647771668_row1211183073714"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_spark_trunc__en-us_topic_0000001647771668_p71113305371">date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.43%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_spark_trunc__en-us_topic_0000001647771668_p161153083720">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_spark_trunc__en-us_topic_0000001647771668_p34163588472">DATE or STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="46.73%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_spark_trunc__en-us_topic_0000001647771668_p10994193319443">Date that needs to be processed</p>
|
|
<div class="p" id="dli_spark_trunc__en-us_topic_0000001647771668_p16460192113371">The following formats are supported:<ul id="dli_spark_trunc__en-us_topic_0000001647771668_ul1476862843819"><li id="dli_spark_trunc__en-us_topic_0000001647771668_li9768132843817">yyyy-mm-dd</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li16768528153818">yyyy-mm-dd hh:mi:ss</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li18768192815382">yyyy-mm-dd hh:mi:ss.ff3</li></ul>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_spark_trunc__en-us_topic_0000001647771668_row3685125904316"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_spark_trunc__en-us_topic_0000001647771668_p12686125924313">format</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.43%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_spark_trunc__en-us_topic_0000001647771668_p7496121924513">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_spark_trunc__en-us_topic_0000001647771668_p1249601911451">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="46.73%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_spark_trunc__en-us_topic_0000001647771668_p14686105911431">Format of the date to be converted</p>
|
|
<p id="dli_spark_trunc__en-us_topic_0000001647771668_p1321011344516">The value is a combination of the time unit (year, month, day, hour, minute, and second) and any character.</p>
|
|
<ul id="dli_spark_trunc__en-us_topic_0000001647771668_ul1085813488453"><li id="dli_spark_trunc__en-us_topic_0000001647771668_li5858648194516"><strong id="dli_spark_trunc__en-us_topic_0000001647771668_b176494259435533">YYYY</strong> or <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b121026699535533">yyyy</strong> indicates the year.</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li138581848194519"><strong id="dli_spark_trunc__en-us_topic_0000001647771668_b40327530635544">MM</strong> indicates the month.</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li48581548174511"><strong id="dli_spark_trunc__en-us_topic_0000001647771668_b174420030535553">mm</strong> indicates the minute.</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li1858348114517"><strong id="dli_spark_trunc__en-us_topic_0000001647771668_b202745109135559">dd</strong> indicates the day.</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li1085815488459"><strong id="dli_spark_trunc__en-us_topic_0000001647771668_b773725735623">HH</strong> indicates the 24-hour clock.</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li2858154854513"><strong id="dli_spark_trunc__en-us_topic_0000001647771668_b71118006335635">hh</strong> indicates the 12-hour clock.</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li19858104814458"><strong id="dli_spark_trunc__en-us_topic_0000001647771668_b163987985735643">mi</strong> indicates the minute.</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li128581648124518"><strong id="dli_spark_trunc__en-us_topic_0000001647771668_b197583766235652">ss</strong> indicates the second.</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li138581748194512"><strong id="dli_spark_trunc__en-us_topic_0000001647771668_b50818022935659">SSS</strong> indicates the millisecond.</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_spark_trunc__en-us_topic_0000001647771668_section210162513312"><h4 class="sectiontitle">Return Values</h4><p id="dli_spark_trunc__en-us_topic_0000001647771668_p1985525218396">The return value is of the DATE type, in the <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b1534217587318">yyyy-mm-dd</strong> format.</p>
|
|
<p id="dli_spark_trunc__en-us_topic_0000001647771668_p2213418121119"></p>
|
|
<div class="note" id="dli_spark_trunc__en-us_topic_0000001647771668_note1641625019416"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dli_spark_trunc__en-us_topic_0000001647771668_ul356743410535"><li id="dli_spark_trunc__en-us_topic_0000001647771668_li1056723455312">If the value of <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b1718555535755">date</strong> is not of the DATE or STRING type, the error message "data type mismatch" is displayed.</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li1660473113357">If the value of <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b14265068903586">date</strong> is of the DATE or STRING type but is not in one of the supported formats, <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b6160848323586">NULL</strong> is returned.</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li3567123425312">If the value of <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b117481080835823">date</strong> is <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b77699148535823">NULL</strong>, <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b176113434135823">NULL</strong> is returned.</li><li id="dli_spark_trunc__en-us_topic_0000001647771668_li8567133465311">If the value of <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b40825875842724">format</strong> is <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b59880129742724">NULL</strong>, <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b37822950442724">NULL</strong> is returned.</li></ul>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="dli_spark_trunc__en-us_topic_0000001647771668_section13277192233920"><h4 class="sectiontitle">Example Code</h4><p id="dli_spark_trunc__en-us_topic_0000001647771668_p4849432133815">The value <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b98031339722">2023-08-01</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_trunc__en-us_topic_0000001647771668_screen166131142133814">select trunc('2023-08-16', 'MM');</pre>
|
|
<p id="dli_spark_trunc__en-us_topic_0000001647771668_p13628183510385">The value <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b162667456214">2023-08-01</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_trunc__en-us_topic_0000001647771668_screen86174818382">select trunc('2023-08-16 10:54:36', 'MM');</pre>
|
|
<p id="dli_spark_trunc__en-us_topic_0000001647771668_p911510383387">The value <strong id="dli_spark_trunc__en-us_topic_0000001647771668_b680950727">NULL</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_trunc__en-us_topic_0000001647771668_screen77181752113816"> select trunc(null, 'MM');</pre>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_08_0471.html">Date Functions</a></div>
|
|
</div>
|
|
</div>
|
|
|