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>
80 lines
13 KiB
HTML
80 lines
13 KiB
HTML
<a name="dli_spark_datediff1"></a><a name="dli_spark_datediff1"></a>
|
|
|
|
<h1 class="topictitle1">datediff1</h1>
|
|
<div id="body8662426"><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p990811211817">This function is used to calculate the difference between <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b18709688565756">date1</strong> and <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b177968962365756">date2</strong> and return the difference in a specified datepart.</p>
|
|
<p id="dli_spark_datediff1__en-us_topic_0000001694154501_p49591750135310">Similar function: <a href="dli_spark_datediff.html#dli_spark_datediff">datediff</a>. The <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b128919455912">datediff</strong> function is used to calculate the difference between <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b11517125101211">date1</strong> and <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b169151527101210">date2</strong> but does not return the difference in a specified datepart.</p>
|
|
<div class="section" id="dli_spark_datediff1__en-us_topic_0000001694154501_section45291954203217"><h4 class="sectiontitle">Syntax</h4><pre class="screen" id="dli_spark_datediff1__en-us_topic_0000001694154501_screen2121185651218">datediff1(string date1, string date2, string datepart)</pre>
|
|
</div>
|
|
<div class="section" id="dli_spark_datediff1__en-us_topic_0000001694154501_section992014913317"><h4 class="sectiontitle">Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_spark_datediff1__en-us_topic_0000001694154501_table1829154762513" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters</caption><thead align="left"><tr id="dli_spark_datediff1__en-us_topic_0000001694154501_row8830104792517"><th align="left" class="cellrowborder" valign="top" width="19.220000000000002%" id="mcps1.3.4.2.2.5.1.1"><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p983074711252">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.44%" id="mcps1.3.4.2.2.5.1.2"><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p6830124732517">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.61%" id="mcps1.3.4.2.2.5.1.3"><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p13318164512614">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_datediff1__en-us_topic_0000001694154501_p08301547132513">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_spark_datediff1__en-us_topic_0000001694154501_row15830184792511"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p683034714250">date1</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.44%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p12830184752518">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.61%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p2098843181320">DATE</p>
|
|
<p id="dli_spark_datediff1__en-us_topic_0000001694154501_p158591444191319">or</p>
|
|
<p id="dli_spark_datediff1__en-us_topic_0000001694154501_p0318545102615">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="46.73%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p189251333161511">Minuend of the date difference between <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b182659236744437">date1</strong> and <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b197363022244437">date2</strong>.</p>
|
|
<p id="dli_spark_datediff1__en-us_topic_0000001694154501_p262017013166">The following formats are supported:</p>
|
|
<ul id="dli_spark_datediff1__en-us_topic_0000001694154501_ul18403171617"><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li20849331611">yyyy-mm-dd</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li9841137169">yyyy-mm-dd hh:mi:ss</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li784203121614">yyyy-mm-dd hh:mi:ss.ff3</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_spark_datediff1__en-us_topic_0000001694154501_row52033239362"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p34501243193613">date2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.44%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p132041223183617">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.61%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p391921217153">DATE</p>
|
|
<p id="dli_spark_datediff1__en-us_topic_0000001694154501_p0919121211517">or</p>
|
|
<p id="dli_spark_datediff1__en-us_topic_0000001694154501_p129199128158">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="46.73%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p720417232361">Subtrahend of the date difference between <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b146154272744513">date1</strong> and <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b77219391944513">date2</strong>.</p>
|
|
<p id="dli_spark_datediff1__en-us_topic_0000001694154501_p1029545971519">The following formats are supported:</p>
|
|
<ul id="dli_spark_datediff1__en-us_topic_0000001694154501_ul20382959169"><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li1038275101615">yyyy-mm-dd</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li7382195101611">yyyy-mm-dd hh:mi:ss</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li193822052166">yyyy-mm-dd hh:mi:ss.ff3</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_spark_datediff1__en-us_topic_0000001694154501_row295054517207"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.4.2.2.5.1.1 "><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p5950194582015">datepart</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.44%" headers="mcps1.3.4.2.2.5.1.2 "><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p14950104515207">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.61%" headers="mcps1.3.4.2.2.5.1.3 "><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p9950194582011">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="46.73%" headers="mcps1.3.4.2.2.5.1.4 "><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p157541402116">Unit of the time to be returned</p>
|
|
<p id="dli_spark_datediff1__en-us_topic_0000001694154501_p1995034510202">This parameter supports the following extended date formats: year, month or mon, day, and hour.</p>
|
|
<ul id="dli_spark_datediff1__en-us_topic_0000001694154501_ul5326124018213"><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li1332634082113"><strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b174906282535529">YYYY</strong> or <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b116860477235529">yyyy</strong> indicates the year.</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li18326134020211"><strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b203821244335539">MM</strong> indicates the month.</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li83267401213"><strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b94380591635549">mm</strong> indicates the minute.</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li19326040152117"><strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b1704857935554">dd</strong> indicates the day.</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li3326154018212"><strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b26258333635618">HH</strong> indicates the 24-hour clock.</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li3326104016218"><strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b125901172535631">hh</strong> indicates the 12-hour clock.</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li13261640132117"><strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b196373568935638">mi</strong> indicates the minute.</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li532619407218"><strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b117927319835648">ss</strong> indicates the second.</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li153266409211"><strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b43669227835655">SSS</strong> indicates millisecond.</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_spark_datediff1__en-us_topic_0000001694154501_section210162513312"><h4 class="sectiontitle">Return Values</h4><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p136202119551">The return value is of the BIGINT type.</p>
|
|
<div class="note" id="dli_spark_datediff1__en-us_topic_0000001694154501_note61422099395"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dli_spark_datediff1__en-us_topic_0000001694154501_ul1419951023915"><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li1238485811167">If the values of <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b15594111983311">date1</strong> and <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b95951219203316">date2</strong> are not of the DATE or STRING type, the error message "data type mismatch" is displayed.</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li162913337367">If the values of <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b1521142318331">date1</strong> and <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b822923193314">date2</strong> are of the DATE or STRING type but are not in one of the supported formats, <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b022182333318">NULL</strong> is returned.</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li6884525162219">If the value of <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b2945342394499">date1</strong> is smaller than that of <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b19165681814499">date2</strong>, the return value is a negative number.</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li208841253223">If the value of <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b87078321144937">date1</strong> or <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b81400788644937">date2</strong> is <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b63625120144937">NULL</strong>, <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b202080323644937">NULL</strong> is returned.</li><li id="dli_spark_datediff1__en-us_topic_0000001694154501_li8884025142219">If the value of <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b638392863315">datepart</strong> is <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b1838313286333">NULL</strong>, <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b7383528153319">NULL</strong> is returned.</li></ul>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="dli_spark_datediff1__en-us_topic_0000001694154501_section13277192233920"><h4 class="sectiontitle">Example Code</h4><p id="dli_spark_datediff1__en-us_topic_0000001694154501_p9523132516115">The value <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b1164124810330">14400</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_datediff1__en-us_topic_0000001694154501_screen1473732981110">select datediff1('2023-06-30 00:00:00', '2023-06-20 00:00:00', 'mi');</pre>
|
|
<p id="dli_spark_datediff1__en-us_topic_0000001694154501_p14523162541119">The value <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b2933957545048">10</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_datediff1__en-us_topic_0000001694154501_screen4395834101114">select datediff1(date '2023-06-21', date '2023-06-11', 'dd');</pre>
|
|
<p id="dli_spark_datediff1__en-us_topic_0000001694154501_p6523192518116">The value <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b12715757193310">NULL</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_datediff1__en-us_topic_0000001694154501_screen2428038171120">select datediff1(date '2023-05-21', date '2023-05-10', null);</pre>
|
|
<p id="dli_spark_datediff1__en-us_topic_0000001694154501_p1952311256115">The value <strong id="dli_spark_datediff1__en-us_topic_0000001694154501_b795413193420">NULL</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_datediff1__en-us_topic_0000001694154501_screen3783114616114">select datediff1(date '2023-05-21', null, 'dd');</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>
|
|
|