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>
55 lines
6.0 KiB
HTML
55 lines
6.0 KiB
HTML
<a name="dli_spark_hour"></a><a name="dli_spark_hour"></a>
|
|
|
|
<h1 class="topictitle1">hour</h1>
|
|
<div id="body8662426"><p id="dli_spark_hour__en-us_topic_0000001694154509_p18471163815215">This function is used to return the hour (from 0 to 23) of a specified time.</p>
|
|
<div class="section" id="dli_spark_hour__en-us_topic_0000001694154509_section45291954203217"><h4 class="sectiontitle">Syntax</h4><pre class="screen" id="dli_spark_hour__en-us_topic_0000001694154509_screen374425713247">hour(string date)</pre>
|
|
</div>
|
|
<div class="section" id="dli_spark_hour__en-us_topic_0000001694154509_section992014913317"><h4 class="sectiontitle">Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_spark_hour__en-us_topic_0000001694154509_table1829154762513" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter</caption><thead align="left"><tr id="dli_spark_hour__en-us_topic_0000001694154509_row8830104792517"><th align="left" class="cellrowborder" valign="top" width="19.220000000000002%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_spark_hour__en-us_topic_0000001694154509_p983074711252">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.43%" id="mcps1.3.3.2.2.5.1.2"><p id="dli_spark_hour__en-us_topic_0000001694154509_p6830124732517">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.62%" id="mcps1.3.3.2.2.5.1.3"><p id="dli_spark_hour__en-us_topic_0000001694154509_p13318164512614">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="46.73%" id="mcps1.3.3.2.2.5.1.4"><p id="dli_spark_hour__en-us_topic_0000001694154509_p08301547132513">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_spark_hour__en-us_topic_0000001694154509_row15830184792511"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_hour__en-us_topic_0000001694154509_p683034714250">date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.43%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_hour__en-us_topic_0000001694154509_p12830184752518">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_spark_hour__en-us_topic_0000001694154509_p2098843181320">DATE</p>
|
|
<p id="dli_spark_hour__en-us_topic_0000001694154509_p158591444191319">or</p>
|
|
<p id="dli_spark_hour__en-us_topic_0000001694154509_p0318545102615">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="46.73%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_spark_hour__en-us_topic_0000001694154509_p189251333161511">Date that needs to be processed</p>
|
|
<p id="dli_spark_hour__en-us_topic_0000001694154509_p262017013166">The following formats are supported:</p>
|
|
<ul id="dli_spark_hour__en-us_topic_0000001694154509_ul18403171617"><li id="dli_spark_hour__en-us_topic_0000001694154509_li20849331611">yyyy-mm-dd</li><li id="dli_spark_hour__en-us_topic_0000001694154509_li9841137169">yyyy-mm-dd hh:mi:ss</li><li id="dli_spark_hour__en-us_topic_0000001694154509_li784203121614">yyyy-mm-dd hh:mi:ss.ff3</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_spark_hour__en-us_topic_0000001694154509_section210162513312"><h4 class="sectiontitle">Return Values</h4><p id="dli_spark_hour__en-us_topic_0000001694154509_p1240612497394">The return value is of the INT type.</p>
|
|
<div class="note" id="dli_spark_hour__en-us_topic_0000001694154509_note1641625019416"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dli_spark_hour__en-us_topic_0000001694154509_ul15767105344111"><li id="dli_spark_hour__en-us_topic_0000001694154509_li197671453104116">If the value of <strong id="dli_spark_hour__en-us_topic_0000001694154509_b200321593235749">date</strong> is not of the DATE or STRING type, the error message "data type mismatch" is displayed.</li><li id="dli_spark_hour__en-us_topic_0000001694154509_li022617328384">If the value of <strong id="dli_spark_hour__en-us_topic_0000001694154509_b14823259533580">date</strong> is of the DATE or STRING type but is not in one of the supported formats, <strong id="dli_spark_hour__en-us_topic_0000001694154509_b20008920143580">NULL</strong> is returned.</li><li id="dli_spark_hour__en-us_topic_0000001694154509_li127671253154120">If the value of <strong id="dli_spark_hour__en-us_topic_0000001694154509_b179068333435817">date</strong> is <strong id="dli_spark_hour__en-us_topic_0000001694154509_b132017318235817">NULL</strong>, <strong id="dli_spark_hour__en-us_topic_0000001694154509_b149543905835817">NULL</strong> is returned.</li></ul>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="dli_spark_hour__en-us_topic_0000001694154509_section13277192233920"><h4 class="sectiontitle">Example Code</h4><p id="dli_spark_hour__en-us_topic_0000001694154509_p15943341112">The value <strong id="dli_spark_hour__en-us_topic_0000001694154509_b181993632945048">10</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_hour__en-us_topic_0000001694154509_screen5309184120119">select hour('2023-08-10 10:54:00');</pre>
|
|
<p id="dli_spark_hour__en-us_topic_0000001694154509_p125947341312">The value <strong id="dli_spark_hour__en-us_topic_0000001694154509_b3802115151617">12</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_hour__en-us_topic_0000001694154509_screen12727174711117">select hour('12:00:00');</pre>
|
|
<p id="dli_spark_hour__en-us_topic_0000001694154509_p2594173417118">The value <strong id="dli_spark_hour__en-us_topic_0000001694154509_b157093202167">NULL</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_hour__en-us_topic_0000001694154509_screen85091153913">select hour('20230810105600');</pre>
|
|
<p id="dli_spark_hour__en-us_topic_0000001694154509_p15594934816">The value <strong id="dli_spark_hour__en-us_topic_0000001694154509_b2381423141619">NULL</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_hour__en-us_topic_0000001694154509_screen1515119597119">select hour(null);</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>
|
|
|