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>
63 lines
7.8 KiB
HTML
63 lines
7.8 KiB
HTML
<a name="dli_spark_isdate"></a><a name="dli_spark_isdate"></a>
|
|
|
|
<h1 class="topictitle1">isdate</h1>
|
|
<div id="body8662426"><p id="dli_spark_isdate__en-us_topic_0000001645954798_p18471163815215">This function is used to determine whether a date string can be converted into a date value based on a specified format.</p>
|
|
<div class="section" id="dli_spark_isdate__en-us_topic_0000001645954798_section45291954203217"><h4 class="sectiontitle">Syntax</h4><pre class="screen" id="dli_spark_isdate__en-us_topic_0000001645954798_screen87871852104319">isdate(string date , string format)</pre>
|
|
</div>
|
|
<div class="section" id="dli_spark_isdate__en-us_topic_0000001645954798_section992014913317"><h4 class="sectiontitle">Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_spark_isdate__en-us_topic_0000001645954798_table1829154762513" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters</caption><thead align="left"><tr id="dli_spark_isdate__en-us_topic_0000001645954798_row8830104792517"><th align="left" class="cellrowborder" valign="top" width="19.220000000000002%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_spark_isdate__en-us_topic_0000001645954798_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_isdate__en-us_topic_0000001645954798_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_isdate__en-us_topic_0000001645954798_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_isdate__en-us_topic_0000001645954798_p08301547132513">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_spark_isdate__en-us_topic_0000001645954798_row15830184792511"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_isdate__en-us_topic_0000001645954798_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_isdate__en-us_topic_0000001645954798_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_isdate__en-us_topic_0000001645954798_p2098843181320">DATE</p>
|
|
<p id="dli_spark_isdate__en-us_topic_0000001645954798_p158591444191319">or</p>
|
|
<p id="dli_spark_isdate__en-us_topic_0000001645954798_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_isdate__en-us_topic_0000001645954798_p10994193319443">String to be checked</p>
|
|
<p id="dli_spark_isdate__en-us_topic_0000001645954798_p92704267444">If the value is of the BIGINT, DOUBLE, DECIMAL, or DATETIME type, the value is implicitly converted to the STRING type for calculation.</p>
|
|
<p id="dli_spark_isdate__en-us_topic_0000001645954798_p262017013166">The value can be any string.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_spark_isdate__en-us_topic_0000001645954798_row3685125904316"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_isdate__en-us_topic_0000001645954798_p12686125924313">format</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.43%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_isdate__en-us_topic_0000001645954798_p7496121924513">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_spark_isdate__en-us_topic_0000001645954798_p1249601911451">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="46.73%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_spark_isdate__en-us_topic_0000001645954798_p14686105911431">Format of the date to be converted</p>
|
|
<p id="dli_spark_isdate__en-us_topic_0000001645954798_p135863346458">Constant of the STRING type. Extended date formats are not supported.</p>
|
|
<p id="dli_spark_isdate__en-us_topic_0000001645954798_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_isdate__en-us_topic_0000001645954798_ul1085813488453"><li id="dli_spark_isdate__en-us_topic_0000001645954798_li5858648194516"><strong id="dli_spark_isdate__en-us_topic_0000001645954798_b4107714335531">YYYY</strong> or <strong id="dli_spark_isdate__en-us_topic_0000001645954798_b207220075935531">yyyy</strong> indicates the year.</li><li id="dli_spark_isdate__en-us_topic_0000001645954798_li138581848194519"><strong id="dli_spark_isdate__en-us_topic_0000001645954798_b150272235335541">MM</strong> indicates the month.</li><li id="dli_spark_isdate__en-us_topic_0000001645954798_li48581548174511"><strong id="dli_spark_isdate__en-us_topic_0000001645954798_b152416448935551">mm</strong> indicates the minute.</li><li id="dli_spark_isdate__en-us_topic_0000001645954798_li1858348114517"><strong id="dli_spark_isdate__en-us_topic_0000001645954798_b194384407335556">dd</strong> indicates the day.</li><li id="dli_spark_isdate__en-us_topic_0000001645954798_li1085815488459"><strong id="dli_spark_isdate__en-us_topic_0000001645954798_b154617399535620">HH</strong> indicates the 24-hour clock.</li><li id="dli_spark_isdate__en-us_topic_0000001645954798_li2858154854513"><strong id="dli_spark_isdate__en-us_topic_0000001645954798_b170171349735633">hh</strong> indicates the 12-hour clock.</li><li id="dli_spark_isdate__en-us_topic_0000001645954798_li19858104814458"><strong id="dli_spark_isdate__en-us_topic_0000001645954798_b64417883735640">mi</strong> indicates the minute.</li><li id="dli_spark_isdate__en-us_topic_0000001645954798_li128581648124518"><strong id="dli_spark_isdate__en-us_topic_0000001645954798_b29528890535650">ss</strong> indicates the second.</li><li id="dli_spark_isdate__en-us_topic_0000001645954798_li138581748194512"><strong id="dli_spark_isdate__en-us_topic_0000001645954798_b76508434935657">SSS</strong> indicates millisecond.</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_spark_isdate__en-us_topic_0000001645954798_section210162513312"><h4 class="sectiontitle">Return Values</h4><p id="dli_spark_isdate__en-us_topic_0000001645954798_p1240612497394">The return value is of the BOOLEAN type.</p>
|
|
<div class="note" id="dli_spark_isdate__en-us_topic_0000001645954798_note1641625019416"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dli_spark_isdate__en-us_topic_0000001645954798_p196111376469">If the value of <strong id="dli_spark_isdate__en-us_topic_0000001645954798_b208851203921932">date</strong> or <strong id="dli_spark_isdate__en-us_topic_0000001645954798_b43605063621932">format</strong> is <strong id="dli_spark_isdate__en-us_topic_0000001645954798_b202421453721932">NULL</strong>, <strong id="dli_spark_isdate__en-us_topic_0000001645954798_b50223190221932">NULL</strong> is returned.</p>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="dli_spark_isdate__en-us_topic_0000001645954798_section13277192233920"><h4 class="sectiontitle">Example Code</h4><p id="dli_spark_isdate__en-us_topic_0000001645954798_p599882512210">The value <strong id="dli_spark_isdate__en-us_topic_0000001645954798_b77751842124310">true</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_isdate__en-us_topic_0000001645954798_screen575114368213"> select isdate('2023-08-10','yyyy-mm-dd');</pre>
|
|
<p id="dli_spark_isdate__en-us_topic_0000001645954798_p99891271521">The value <strong id="dli_spark_isdate__en-us_topic_0000001645954798_b1932152864519">false</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_isdate__en-us_topic_0000001645954798_screen17779143325"> select isdate(123456789,'yyyy-mm-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>
|
|
|