forked from docs/doc-exports
Su, Xiaomeng
04d4597cf3
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>
1705 lines
240 KiB
HTML
1705 lines
240 KiB
HTML
<a name="dli_08_0334"></a><a name="dli_08_0334"></a>
|
|
|
|
<h1 class="topictitle1">Temporal Functions</h1>
|
|
<div id="body8662426"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a0afc1542d28746fc9572e1ad11e28d5d"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_ta2a0e6534d354c7195ebf06580c6c081">Table 1</a> lists the temporal functions supported by Flink OpenSource SQL.</p>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_section565310510264"><h4 class="sectiontitle">Function Description</h4>
|
|
<div class="tablenoborder"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_ta2a0e6534d354c7195ebf06580c6c081"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_ta2a0e6534d354c7195ebf06580c6c081"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_ta2a0e6534d354c7195ebf06580c6c081" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Temporal functions</caption><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_r94e9c30c23dd4af3908643ddb78b35c7"><th align="left" class="cellrowborder" valign="top" width="29.673267326732677%" id="mcps1.3.2.2.2.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_af3c0a9ba4b4f47dab3c76ec63484ed7f">Function</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.792079207920793%" id="mcps1.3.2.2.2.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p062042117432">Return Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="56.53465346534653%" id="mcps1.3.2.2.2.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_aa80b70b4f1624621a61e741988c5d582">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_r2d5dbdcae7e949b1bda4187fec7e1840"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_ac86f61fa314d4836821b7c19d57ed457"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section14378194561717">DATE string</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a6390bb9c83434bf1abc803877f93c5fd">DATE</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p097102217463">Parse the date string (<strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1735202274817">yyyy-MM-dd</strong>) to a SQL date.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_re6037d00a4ca402aba8919a6a11ea8e4"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p66208213435"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section360564211339">TIME string</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_afc52ddf9a3494f5cada4cae31e07326c">TIME</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p362162194314">Parse the time string (<strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b146492022103217">HH:mm:ss[.fff]</strong>) to a SQL time.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_r09c43fb588884afd86c80c79a92d92b0"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p062182113439"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1878994533516">TIMESTAMP string</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a59ddaba2be4d49bb989825b24c45e7d6">TIMESTAMP</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a8e5a140307a44c7a9bba48033ce4096a">Convert the time string into a timestamp. The time string format is <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b08811143103215">yyyy-MM-dd HH:mm:ss[.fff]</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_r02301fcf0eb94f9eb6ffa285ba5399c0"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a07ebf2beb37442a8bc0510aa92ae391d"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section8680184819367">INTERVAL string range</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p257191085014">INTERVAL</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p231292515196">Parse an interval string in the following two forms:</p>
|
|
<ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul15361195202"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li18536169192015"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b55361297206">yyyy-MM</strong> for SQL intervals of months. An interval range might be <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1332241317532">YEAR</strong> or<strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1182172013534"> YEAR TO MONTH</strong>. </li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1853629152013"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b113715495537">dd hh:mm:ss.fff</strong> for SQL intervals of milliseconds. An interval range might be <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1862143415540">DAY</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b06218341545">MINUTE</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b15621183417545">DAY TO HOUR</strong>, or <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b15622193475412">DAY TO SECOND</strong>.</li></ul>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p34549219522">Example:</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_p10145102112514"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1340563464713">INTERVAL '10 00:00:00.004' DAY TO second</strong> indicates that the interval is 10 days and 4 milliseconds.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p630817199586"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1526118365123">INTERVAL '10' DAY</strong>: indicates that the interval is 10 days.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p849154571214"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1550613515122">INTERVAL '2-10' YEAR TO MONTH</strong> indicates that the interval is two years and ten months.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_r452fd9bcac904451a132b11e8b93d994"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a6965d1077bf6425f9aa006163ededed0"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section17211159143814">CURRENT_DATE</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a1a61c57d956e436f82015b10e1fa1c6a">DATE</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p2938947522">Return the SQL date of UTC time zone.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_r814ffb81098d45b9bb8e6afe4d135390"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p7541167406"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section207768598406">CURRENT_TIME</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a22a3f9e012eb4a48a21a17b131fbeaf3">TIME</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_ad8f46723d2334db5b440bce0c5f31e14">Return the SQL time of UTC time zone.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_r4ce2696a760c453eb3982feb3a50b630"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a1249662b8bff4bef8086c9fe4a13f29a"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section17661335184515">CURRENT_TIMESTAMP</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a20c5d0b9ef3c4b2bb09c8a301d2775c3">TIMESTAMP</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a063e702dfd5b4a4497ee9fd2f2198d18">Return the SQL timestamp of UTC time zone.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_r2501ad96582b42b8a16a6d9ee6472488"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p852131644019"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section11477133554614">LOCALTIME</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_aaed36ae8f2dd4bc191f803537d5fd285">TIME</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a124cad95c1d245a8b14fe7fb4ddb9897">Return the SQL time of the local time zone.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_r2e3fbb4619bb40ccbc11d29a22f86d83"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_af689318e7c264e62aa4b2421fe20a36d"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section14830142934817">LOCALTIMESTAMP</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_adb38d4dbf6654577ae44c14eb7c8911d">TIMESTAMP</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a85b54e5560b74f31a5e9112f92ae4b84">Return the SQL timestamp of the local time zone.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_rf661654af51b42999987cea96ef62a53"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p7507165405"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section184791718509">EXTRACT(timeintervalunit FROM temporal)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_en-us_topic_0060575890_p8530105500">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_aec44d12f22134b7d8d9f30ce54de302d">Extract part of the time point or interval. Return the part in the int type.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p3207181512497">For example, extract the date <span class="uicontrol" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_uicontrol2335142212142"><b>2006-06-05</b></span> and return <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1260813117283">5</strong>.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_a2db479eec5b24736bb5691fc968a67f3"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b2365142181419">EXTRACT(DAY FROM DATE '2006-06-05')</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b93461740131416">5</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row028717578494"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7287657144910"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1643812191377">YEAR(date)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p162871057164913">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1628713578495">Return the year from a SQL date.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p19788135312510">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b628611831519">YEAR(DATE'1994-09-27')</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b22541051510">1994</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row3689115924915"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p87162045318"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section517261154017">QUARTER(date)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p57220105311">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1771204532">Return the quarter of a year from a SQL date.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row912320245017"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p51231212509"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section838818144523">MONTH(date)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p5123102155013">BIGINT</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p341020269582"></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p31233218507">Return the month of a year from a SQL date.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1436133913580">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1739445191513">MONTH(DATE '1994-09-27')</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b3902348141520">9</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row745113415502"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p10451144145020"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section08692035515">WEEK(date)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1045184205016">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p44511549504">Return the week of a year from a SQL date.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p13453140604">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b043131341618">WEEK(DATE'1994-09-27')</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1380682217163">39</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1911547125014"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p41151171508"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section35952273562">DAYOFYEAR(date)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p131157785011">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p011519765020">Return the day of a year from a SQL date.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p54611658162518">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b75921347111617">DAYOFYEAR(DATE '1994-09-27')</strong> is <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1613513451161">270</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row5881031192313"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1288173120232"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section89188327592">DAYOFMONTH(date)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p3881143116232">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p8881153142312">Return the day of a month from a SQL date.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p929954692615">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b93421416111710">DAYOFMONTH(DATE'1994-09-27')</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b15673193081715">27</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row176251535122314"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2625113552314"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section152759367121">DAYOFWEEK(date)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2062518357233">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p362583519231">Return the day of a week from a SQL date.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p979115613350">Sunday is set to <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b171497114187">1</strong>.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p15735812113617">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b19732162612188">DAYOFWEEK(DATE'1994-09-27')</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b13891224101818">3</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1698315811270"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p698388162717"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section34301613121413">HOUR(timestamp)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1098310812714">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p09835882712">Return the hour of a day (an integer between 0 and 23) from a SQL timestamp. </p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p61153110408">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b20921105681817">HOUR(TIMESTAMP '1994-09-27 13:14:15')</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b136514549184">13</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1822314115272"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p202241114273"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section17296191222215">MINUTE(timestamp)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p92241611162717">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p162241511152711">Return the minute of an hour (an integer between 0 and 59) from a SQL timestamp.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p4845162274110">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b496192914193">MINUTE(TIMESTAMP '1994-09-27 13:14:15')</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1471132712191">14</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row421811316273"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p221811372717"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section125214317232">SECOND(timestamp)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p22184130277">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p72181136277">Returns the second of a minute (an integer between 0 and 59) from a SQL timestamp.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p16902923194210">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b105136182020">SECOND(TIMESTAMP '1994-09-27 13:14:15')</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1815016411202">15</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row0556245184117"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1455684513419"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section114922047182416">FLOOR(timepoint TO timeintervalunit)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p195567455417">TIME</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p86896266436">Round a time point down to the given unit.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7689112644310">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_b842352706171216">12:44:00</strong> is returned from <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_dli_08_0097_b842352706171239">FLOOR(TIME '12:44:31' TO MINUTE)</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row21061243124114"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2106843194111"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section345282814439">CEIL(timepoint TO timeintervalunit)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1910654314412">TIME</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p112747513434">Round a time point up to the given unit.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p152750513439">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b34471624102013">CEIL(TIME '12:44:31' TO MINUTE)</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b34899470445846">12:45:00</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1512284134115"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p5122164124116"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section132721624154711">(timepoint1, temporal1) OVERLAPS (timepoint2, temporal2)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p0122041124110">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1112216417411">Return <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1356855082015">TRUE</strong> if two time intervals overlap.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p105011261505">Example:</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p89942235016"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b7541103122113">(TIME '2:55:00', INTERVAL '1' HOUR) OVERLAPS (TIME '3:30:00', INTERVAL '2' HOUR)</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b66947220217">TRUE</strong>.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p8149128175019"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b14856737192117">(TIME '9:00:00', TIME '10:00:00') OVERLAPS (TIME '10:15:00', INTERVAL '3' HOUR)</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b829744416217">FALSE</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1565415446"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1561747447"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section98557160415">DATE_FORMAT(timestamp, string)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p16568474420">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p105731342081">Convert a timestamp to a value of string in the format specified by the date format string.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row48031710446"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p28031114448"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section105601517203220">TIMESTAMPADD(timeintervalunit, interval, timepoint)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p38031019443">TIMESTAMP/DATE/TIME</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1667711375516">Return the date and time added to <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b682224512238">timepoint</strong> based on the result of <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1524425392312">interval</strong> and <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b2394750122316">timeintervalunit</strong>.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p480316164418">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b3502184192413">TIMESTAMPADD(WEEK, 1, DATE '2003-01-02')</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b2433667249">2003-01-09</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row9873125914313"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p487335904318"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section16290114810404">TIMESTAMPDIFF(timepointunit, timepoint1, timepoint2)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p58731959174317">INT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p0873659204314">Return the (signed) number of timepointunit between <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1867483632412">timepoint1</strong> and <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b875211382246">timepoint2</strong>. </p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1832955017219">The unit for the interval is given by the first argument, which should be one of the following values: <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b16219112613315">SECOND</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b8588327193117">MINUTE</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b11466102983119">HOUR</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b996953012315">DAY</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b106203322314">MONTH</strong>, and <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b5140153543113">YEAR</strong>.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1773716478319">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b488981710252">TIMESTAMPDIFF(DAY, TIMESTAMP '2003-01-02 10:00:00', TIMESTAMP '2003-01-03 10:00:00')</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b818291616259">1</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1693732212117"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p109373227114"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1698193003115">CONVERT_TZ(string1, string2, string3)</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p15937162216113">TIMESTAMP</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p493717222115">Convert a datetime <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b131521510162620">string1</strong> from time zone <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b116234218264">string2</strong> to time zone <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b2812152310264">string3</strong>. </p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2984151515915">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b3860192911267">CONVERT_TZ('1970-01-01 00:00:00', 'UTC', 'America/Los_Angeles')</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b5852153532617">'1969-12-31 16:00:00'</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row183471629813"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1834720298113"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section01032914372">FROM_UNIXTIME(numeric[, string])</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p33474293119">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p29691910132415">Return a representation of the numeric argument as a value in string format.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p22041554182718">The default string format is YYYY-MM-DD hh:mm:ss.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1177645271918">For example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b18247427142715">FROM_UNIXTIME(44)</strong> returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b3818192962711">1970-01-01 09:00:44</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row2341112515117"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p13419254113"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section166571146145016">UNIX_TIMESTAMP()</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7341725519">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1634113251619">Get current Unix timestamp in seconds.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p191163210222"></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row17235152713114"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p14235527718"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section175599271533">UNIX_TIMESTAMP(string1[, string2])</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p52354271116">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p72351927414">Convert date time string <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b7881623142819">string1</strong> in format <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1619622518284">string2</strong> to Unix timestamp (in seconds), using the specified timezone in table config.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p325613334315">The default format of <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b17636231152820">string2</strong> is yyyy-MM-dd HH:mm:ss.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row114830188249"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p8483161819243"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1871816161526">TO_DATE(string1[, string2])</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p11483151819241">DATE</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p548331815247">Convert a date string <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b142951455172812">string1</strong> with format <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b260595782818">string2</strong> to a date.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7785191312328">The default format of <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1451610105291">string2</strong> is yyyy-MM-dd.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row14346320152417"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p4346192015249"><a href="#dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1374114020551">TO_TIMESTAMP(string1[, string2])</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.792079207920793%" headers="mcps1.3.2.2.2.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p183462020172411">TIMESTAMP</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p15346162002411">Convert date time string <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b17851337113220">string1</strong> with format <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b51791532143216">string2</strong> to a timestamp.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1112191312348">The default format of <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b23964311477">string2</strong> is yyyy-MM-dd HH:mm:ss.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section14378194561717"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section14378194561717"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section14378194561717"></a><h4 class="sectiontitle">DATE</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul202988559179"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1529825511713"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b986991011516">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1652615285183">Returns a date parsed from string in form of <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b8343112125715">yyyy-MM-dd</strong>.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li991314510181"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b2175161512516">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen85953333326">DATE <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b119751846134812">DATE </strong>string</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li3917139131820"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b922284335713">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table11910153753010" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1791118372301"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p18911173713018">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p39117373307">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1391193712304">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1891183710301"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p19112037123017">string</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1491111377308">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p4883114991116">String in the SQL date format. </p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p891173715309">Note that the string must be in the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b138181473318">yyyy-MM-dd</strong> format. Otherwise, an error will be reported.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li374581412189"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1673862115114">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul138618914337"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1933692417358">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1150181573219">SELECT
|
|
DATE "2021-08-19" AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li14230202883518">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table0224118113517" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row10224141819357"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.3.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p836324211360">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1722431817358"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.3.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p8978446163612">2021-08-19</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section360564211339"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section360564211339"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section360564211339"></a><h4 class="sectiontitle">TIME</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul360504212331"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li156051642113312"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1936482445112">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p156021956173319">Returns a SQL time parsed from string in form of <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b2022193720016">HH:mm:ss[.fff]</strong>.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li11606042153313"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b3428131134915">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen860618424334">TIME <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1285712503482">TIME </strong>string</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li06061342133312"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b146823559018">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table1067317317346" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row467373118349"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p4673931173411">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p867373103412">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p12673113133411">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row567343112348"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p18673331173419">string</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p567313118348">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1067323114343">Time</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7361130112517">Note that the string must be in the format of <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1223213015116">HH:mm:ss[.fff]</strong>. Otherwise, an error will be reported.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li560612429338"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b28312415495">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1260624223316"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1360694216331">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen206065428334">SELECT
|
|
TIME "10:11:12" AS `result`,
|
|
TIME "10:11:12.032" AS `result2`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li960613424333">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table86061442203312" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row16606174218335"><th align="left" class="cellrowborder" valign="top" width="22.99%" id="mcps1.3.4.2.4.2.2.1.1.3.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p260619423337">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="77.01%" id="mcps1.3.4.2.4.2.2.1.1.3.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1790827113318">result2</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1360664253315"><td class="cellrowborder" valign="top" width="22.99%" headers="mcps1.3.4.2.4.2.2.1.1.3.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p8606154214335">10:11:12</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="77.01%" headers="mcps1.3.4.2.4.2.2.1.1.3.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1790811773316">10:11:12.032</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1878994533516"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1878994533516"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1878994533516"></a><h4 class="sectiontitle">TIMESTAMP</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1979011458350"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li197901345203511"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b103751645154916">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1779074515352">Converts the time string into timestamp. The time string format is <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b2148448164918">yyyy-MM-dd HH:mm:ss[.fff]</strong>. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b851814485215">TIMESTAMP(3) </strong>type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li4790645173516"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b066084904918">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen3790144516358">TIMESTAMP(3) <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b625655504810">TIMESTAMP </strong>string</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li779012457353"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b187881297316">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table1079084533515" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row0790204510355"><th align="left" class="cellrowborder" valign="top" width="27.34273427342734%" id="mcps1.3.5.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1679054512350">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25.85258525852585%" id="mcps1.3.5.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p079015451359">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="46.804680468046804%" id="mcps1.3.5.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p879018451351">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row9790145193517"><td class="cellrowborder" valign="top" width="27.34273427342734%" headers="mcps1.3.5.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p9999111618362">string</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.85258525852585%" headers="mcps1.3.5.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1999131683615">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="46.804680468046804%" headers="mcps1.3.5.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p17999111693611">Time</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p5273104720470">Note that the string must be in the format of <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b185241517931">yyyy-MM-dd HH:mm:ss[.fff]</strong>. Otherwise, an error will be reported.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1779016458359"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1621231239">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul17790045103510"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li679014543516">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen279024573510">SELECT
|
|
TIMESTAMP "1997-04-25 13:14:15" AS `result`,
|
|
TIMESTAMP "1997-04-25 13:14:15.032" AS `result2`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li8790174553514">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table1279094593511" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1779084583519"><th align="left" class="cellrowborder" valign="top" width="31.900000000000002%" id="mcps1.3.5.2.4.2.2.1.1.3.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1279034510352">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="68.10000000000001%" id="mcps1.3.5.2.4.2.2.1.1.3.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p62281849154017">result2</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row67901456357"><td class="cellrowborder" valign="top" width="31.900000000000002%" headers="mcps1.3.5.2.4.2.2.1.1.3.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p136111735113617">1997-04-25 13:14:15</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="68.10000000000001%" headers="mcps1.3.5.2.4.2.2.1.1.3.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p422818495408">1997-04-25 13:14:15.032</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section8680184819367"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section8680184819367"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section8680184819367"></a><h4 class="sectiontitle">INTERVAL</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1668117487366"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li26811548103612"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b91451341635">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p18681548133616">Parses an interval string.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li16814483367"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b6743899416">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen868118481362">INTERVAL <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b164101011492">INTERVAL </strong>string range</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1868194873616"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b51531116419">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table15381139153718" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1138133993718"><th align="left" class="cellrowborder" valign="top" width="23.522352235223522%" id="mcps1.3.6.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p133883910377">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.76187618761876%" id="mcps1.3.6.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1381139153714">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.71577157715772%" id="mcps1.3.6.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p19381039103719">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row173813399377"><td class="cellrowborder" valign="top" width="23.522352235223522%" headers="mcps1.3.6.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p33812398373">string</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.76187618761876%" headers="mcps1.3.6.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p53814391372">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.71577157715772%" headers="mcps1.3.6.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p638183911378">Timestamp string used together with the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b24686381947">range</strong> parameter. The string is in either of the following two formats:</p>
|
|
<ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul14137932161217"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li18137232131219"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b71532441653">yyyy-MM</strong> for SQL intervals of months. An interval range might be <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b31591944254">YEAR</strong> or<strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1615984417516"> YEAR TO MONTH </strong>for intervals of months. </li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li841674219503"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b10333945657">dd hh:mm:ss.fff</strong> for SQL intervals of milliseconds. An interval range might be <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b8145134714513">DAY</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b41451471854">MINUTE</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b514574719516">DAY TO HOUR</strong>, or <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b11145134717518">DAY TO SECOND</strong>.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row273614571912"><td class="cellrowborder" valign="top" width="23.522352235223522%" headers="mcps1.3.6.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p119468161010">range</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.76187618761876%" headers="mcps1.3.6.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p3101132031015">INTERVAL</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.71577157715772%" headers="mcps1.3.6.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p29167519529">Interval range. This parameter is used together with the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1090112341876">string</strong> parameter. </p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p17490112611119">Available values are as follows: <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1786214530719">YEAR, YEAR To Month, DAY, MINUTE, DAY TO HOUR and DAY TO SECOND</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li468164816369"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1174214101288">Example</strong><div class="p" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p972005514379">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1968114819363">-- The interval is 10 days and 4 milliseconds.
|
|
INTERVAL '10 00:00:00.004' DAY TO second
|
|
-- The interval is 10 days.
|
|
INTERVAL '10'
|
|
-- The interval is 2 years and 10 months.
|
|
INTERVAL '2-10' YEAR TO MONTH</pre>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section17211159143814"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section17211159143814"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section17211159143814"></a><h4 class="sectiontitle">CURRENT_DATE</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul621159193816"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li921155913818"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1978719597">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1921185914381">Returns the current SQL time (<strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b124765183115">yyyy-MM-dd</strong>) in the local time zone. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b11688941121016">DATE </strong>type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li12111592382"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b15558142191015">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1521359193817">DATE <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b8653201117556">CURRENT_DATE</strong></pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li4211459203816"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b156491948171020">Input parameters</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p336973224011">N/A</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li5211059193820"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1564935119103">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul19227599388"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li7221159143810">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1622175913813">SELECT
|
|
CURRENT_DATE AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1922959143814">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table1222959143818" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row152235918385"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.7.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p62235933818">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row522125983818"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.7.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7925115120405">2021-10-28</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section207768598406"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section207768598406"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section207768598406"></a><h4 class="sectiontitle">CURRENT_TIME</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1177611592403"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li6776135954019"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b63649558104">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7776759124012">Returns the current SQL time (<strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b858910463114">HH:mm:sss.fff</strong>) in the local time zone. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b135891646141113">TIME</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li677614599406"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1125519101219">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1577695954014">TIME <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b9124847185420">CURRENT_TIME</strong></pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1677618598407"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b6433121771218">Input parameters</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p147762595408">N/A</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li17776125954010"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1405201991214">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul15776185913406"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li777645916408">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen6776135917404">SELECT
|
|
CURRENT_TIME AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li77760591406">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table177766596402" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row18776165994014"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.8.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7776115915405">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row10776185917408"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.8.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2793164752014">08:29:19.289</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section17661335184515"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section17661335184515"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section17661335184515"></a><h4 class="sectiontitle">CURRENT_TIMESTAMP</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul676623513459"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li176613554514"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b17333122212121">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p776603514454">Returns the current SQL timestamp in the local time zone. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b9121747141214">TIMESTAMP(3)</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li476623594517"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b7694112116136">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen161621232095">TIMESTAMP(3) <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b11708121615414">CURRENT_TIMESTAMP</strong></pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li876653594516"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b32551528141312">Input parameters</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1176733515454">N/A</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1476715357452"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b99713302135">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul14767203554511"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li15767183574518">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1776733516456">SELECT
|
|
CURRENT_TIMESTAMP AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li5767173510459">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table1767335134516" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row5767143519454"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.9.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p576773513454">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1976733514515"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.9.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p676713514517">2021-10-28 08:33:51.606</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section11477133554614"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section11477133554614"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section11477133554614"></a><h4 class="sectiontitle">LOCALTIME</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1447783510469"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1947773554613"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b37393331310">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1223312517199">Returns the current SQL time in the local time zone. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b156315119143">TIME</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li747733519463"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b81041512201413">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen2477435164615">TIME <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b11641271428">LOCALTIME</strong></pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li947733574613"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b3229191461413">Input parameters</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1647713514612">N/A</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li447783519461"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b725731631411">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul24771335174610"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1547753514465">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen647718357460">SELECT
|
|
LOCALTIME AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li947793594615">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table13477113510464" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row047713511464"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.10.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p16477735164616">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row16477103534614"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.10.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1427461514472">16:39:37.706</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section14830142934817"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section14830142934817"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section14830142934817"></a><h4 class="sectiontitle">LOCALTIMESTAMP</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1283042915483"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li19830829184814"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b31437243149">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p3830132911482">Returns the current SQL timestamp in the local time zone. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b12318626151413">TIMESTAMP(3)</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1983014295486"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b113521254101419">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen68304297482">TIMESTAMP(3) <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1527731012541">LOCALTIMESTAMP</strong></pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li148301729124817"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b66266201515">Input parameters</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p3830629164812">N/A</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li148301529144810"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b787311771517">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1830132944811"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li7830829104814">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1830629154815">SELECT
|
|
LOCALTIMESTAMP AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li9830192964817">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table19830152912485" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row168303297481"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.11.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7830152916489">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row383013296489"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.11.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p6390455497">2021-10-28 16:43:17.625</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section184791718509"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section184791718509"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section184791718509"></a><h4 class="sectiontitle">EXTRACT</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1047217145017"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1247617155019"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b96366102155">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p19567854757">Returns a value extracted from the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1254584931713">timeintervalunit</strong> part of temporal. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b14788151761614">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li54751785019"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b22748230162">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen15471817185014">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b167721838517">EXTRACT</strong>(timeinteravlunit <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b124946851">FROM </strong>temporal)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li247717185010"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b56041246166">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table108661744165017" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row9866104419505"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.12.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p20866204495018">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.912191219121908%" id="mcps1.3.12.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1086614455018">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="54.54545454545454%" id="mcps1.3.12.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p17866144115013">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row4866184412509"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.12.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p14866174415014">timeinteravlunit</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.912191219121908%" headers="mcps1.3.12.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1986614465019">TIMEUNIT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.54545454545454%" headers="mcps1.3.12.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p68008411318">Time unit to be extracted from a time point or interval. The value can be <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b12733125411186">YEAR</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b12507457191819">QUARTER</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b7571105912189">MONTH</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b159391704198">WEEK</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b930512191915">DAY</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1598710316193">DOY</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b526714531912">HOUR</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1275056151919">MINUTE</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b6275171091918">SECOND</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row128663449509"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.12.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p38671844125011">temporal</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.912191219121908%" headers="mcps1.3.12.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p486714442509">DATE/TIME/TIMESTAMP/INTERVAL</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.54545454545454%" headers="mcps1.3.12.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1092012183116">Time point or interval.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="caution" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_note660918595510"><span class="cautiontitle"><img src="public_sys-resources/caution_3.0-en-us.png"> </span><div class="cautionbody"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p16094593515">Do not specify a time unit that is not of any time points or intervals. Otherwise, the job fails to be submitted.</p>
|
|
<p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p186201523141318">For example, an error message is displayed when the following statement is executed because <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b57261211125418">YEAR</strong> cannot be extracted from <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b16218161515540">TIME</strong>.</p>
|
|
<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen4240161971318">SELECT
|
|
EXTRACT(YEAR FROM TIME '12:44:31' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</div></div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li2047121795018"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b10511419200">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul947217205010"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li247151717502">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen114751718501">SELECT
|
|
EXTRACT(YEAR FROM DATE '1997-04-25' ) AS `result`,
|
|
EXTRACT(MINUTE FROM TIME '12:44:31') AS `result2`,
|
|
EXTRACT(SECOND FROM TIMESTAMP '1997-04-25 13:14:15') AS `result3`,
|
|
EXTRACT(YEAR FROM INTERVAL '2-10' YEAR TO MONTH) AS `result4`,
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li547111775016">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table197512181539" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1775171825311"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.12.2.4.2.2.1.1.5.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p67511418135319">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.12.2.4.2.2.1.1.5.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7751181865316">result2</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.12.2.4.2.2.1.1.5.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p147511718195316">result3</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.12.2.4.2.2.1.1.5.1.4"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1475181805317">result4</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row157511718165311"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.12.2.4.2.2.1.1.5.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1875114183531">1997</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.12.2.4.2.2.1.1.5.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p575119183535">44</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.12.2.4.2.2.1.1.5.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p6751121835319">15</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.12.2.4.2.2.1.1.5.1.4 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7751191835318">2</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1643812191377"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1643812191377"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1643812191377"></a><h4 class="sectiontitle">YEAR</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul104388197372"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li10438719173718"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b101410106203">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p184388192370">Returns the year from a SQL date. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b2592191125517">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li11438141916371"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b922961218207">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen194381191375">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b49013125179">YEAR</strong>(date)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li4438141923711"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b19601514122018">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table3438171943719" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row34392198378"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.13.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p18439419163720">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.74187418741874%" id="mcps1.3.13.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p12439121915372">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.71577157715772%" id="mcps1.3.13.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p194391019123716">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row15439519173715"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.13.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p143919198379">date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.74187418741874%" headers="mcps1.3.13.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p543901913711">DATE</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.71577157715772%" headers="mcps1.3.13.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p19439719203714">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li74395197374"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b144511519162011">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1543961973712"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li94391519163717">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen2439121917370">SELECT
|
|
YEAR(DATE '1997-04-25' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li743920195378">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table124394191378" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row164391619143718"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.13.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p11439119113713">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row344012196377"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.13.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p04401819183713">1997</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section517261154017"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section517261154017"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section517261154017"></a><h4 class="sectiontitle">QUARTER</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1617241120406"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li16172511194015"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b11960621122015">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1917271115409">Returns the quarter of a year (an integer between 1 and 4) from a SQL date. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1239213399561">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li5172711164016"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b59191823102020">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen17172611134015">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b17353212185">QUARTER</strong>(date)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1172511204014"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1296272482014">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table7172161114012" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row18172161164010"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.14.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p31721511114020">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.74187418741874%" id="mcps1.3.14.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p31721511184010">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.71577157715772%" id="mcps1.3.14.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2172101124018">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row141721311104011"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.14.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1417312119405">date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.74187418741874%" headers="mcps1.3.14.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p8173911114011">DATE</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.71577157715772%" headers="mcps1.3.14.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p6173131111405">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li5173181110406"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b4160430192013">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul14173101118408"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li11735118408">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen14173141115400">SELECT
|
|
<strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b26071342171910">QUARTER</strong>(DATE '1997-04-25' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li617371154010">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table917361164011" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row15173171111408"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.14.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p15173161104016">Result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row19173121184015"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.14.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p16173121119403">2</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section838818144523"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section838818144523"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section838818144523"></a><h4 class="sectiontitle">MONTH</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1438811145526"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1638811147526"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1941103272018">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p47331657122213">Returns the month of a year (an integer between 1 and 12) from a SQL date. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b095485822510">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li8388314185218"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b29841034112014">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen14388121465216">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b171021729132311">MONTH</strong>(date)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li15388121455214"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b05153611202">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table163898146525" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row173891814115219"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.15.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p133891514105216">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.74187418741874%" id="mcps1.3.15.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1838941412526">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.71577157715772%" id="mcps1.3.15.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2389131410529">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row9389614165217"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.15.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p138921475210">date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.74187418741874%" headers="mcps1.3.15.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p93891714135219">DATE</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.71577157715772%" headers="mcps1.3.15.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p103891914175210">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li12389131412522"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b19176742172012">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul9389111465216"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li4389161415211">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen19389111465220">SELECT
|
|
MONTH(DATE '1997-04-25' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li738917148523">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table1338961419522" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1338971415210"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.15.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1438971411529">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1338931425217"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.15.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p113891814145220">4</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section08692035515"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section08692035515"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section08692035515"></a><h4 class="sectiontitle">WEEK</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul178709045513"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li158701408557"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b536864519204">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p158701401550">Returns the week of a year from a SQL date. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b53274434592">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1587080135515"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b14536148162016">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen208701303559">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1168717109248">WEEK</strong>(date)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li138701500556"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b167241549152015">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table3870801556" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1870803557"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.16.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p138701002553">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.74187418741874%" id="mcps1.3.16.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p787013065515">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.71577157715772%" id="mcps1.3.16.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p5870120145513">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1187014018557"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.16.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p9870130195512">date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.74187418741874%" headers="mcps1.3.16.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p78701016559">DATE</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.71577157715772%" headers="mcps1.3.16.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p587017075514">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li118701602556"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1672175510203">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul10870705557"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li08711000551">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen118711408551">SELECT
|
|
WEEK(DATE '1997-04-25' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li168713012554">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table087170175517" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row3871603556"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.16.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p4871303554">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row28714012559"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.16.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p158718065518">17</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section35952273562"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section35952273562"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section35952273562"></a><h4 class="sectiontitle">DAYOFYEAR</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul10595192735618"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li159542745619"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b11297175892011">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p781110132250">Returns the day of a year (an integer between 1 and 366) from SQL date. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1932854155919">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li45951827145617"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1658171132110">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen13595102711561">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b126851541162514">DAYOFYEAR</strong>(date)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li165959272560"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b06692029212">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table4595122785617" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row15596102735614"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.17.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p159652715563">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.74187418741874%" id="mcps1.3.17.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p135961727155619">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.71577157715772%" id="mcps1.3.17.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p559622715614">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row0596182735620"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.17.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p35964276563">date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.74187418741874%" headers="mcps1.3.17.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p115961227175613">DATE</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.71577157715772%" headers="mcps1.3.17.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p459602725618">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li15596122785617"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b153041682219">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul0596142717564"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li15596327155619">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen5596162735615">SELECT
|
|
DAYOFYEAR(DATE '1997-04-25' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li13596827135616">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table759642711564" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row3596142715612"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.17.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1159612275561">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row18596122711567"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.17.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p16596202775617">115</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section89188327592"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section89188327592"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section89188327592"></a><h4 class="sectiontitle">DAYOFMONTH</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul791873212596"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li991823275911"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b152110127214">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7918732195910">Returns the day of a month (an integer between 1 and 31) from a SQL date. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b786517158016">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li169181532155916"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b13466514152111">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen19918332135916">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b555142214261">DAYOFMONTH</strong>(date)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li791919327596"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b268111155214">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table4919153217591" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row16919133211599"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.18.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p15919032155915">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.74187418741874%" id="mcps1.3.18.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p149191132145918">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.71577157715772%" id="mcps1.3.18.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p16919432175915">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row5919163215596"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.18.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p17919203285919">date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.74187418741874%" headers="mcps1.3.18.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1491918327590">DATE</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.71577157715772%" headers="mcps1.3.18.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p191993295913">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li139191732145914"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b6918521132110">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul6919143214594"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li10919632175912">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1919123265919">SELECT
|
|
DAYOFMONTH(DATE '1997-04-25' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li99198323597">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table6919163212593" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row5919143210599"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.18.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1591973285920">Result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row9920113235919"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.18.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p8920173211596">25</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section152759367121"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section152759367121"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section152759367121"></a><h4 class="sectiontitle">DAYOFWEEK</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul15275183621220"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li42751136171212"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b24013256213">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p71006464268">Returns the day of a week (an integer between 1 and 7) from a SQL date. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b131695484115">BIGINT</strong> type.</p>
|
|
<div class="note" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_note2414151182612"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p10275836161219">Note that the start day of a week is Sunday. </p>
|
|
</div></div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li11275536181219"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b662523720217">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen927518364127">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b2385149102714">DAYOFWEEK</strong>(date)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li42752036161210"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b882193815214">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table127516362121" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row327543631218"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.19.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p627553691211">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.74187418741874%" id="mcps1.3.19.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p727573612120">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.71577157715772%" id="mcps1.3.19.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p0275436101214">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1927513363125"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.19.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p13275103651220">date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.74187418741874%" headers="mcps1.3.19.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p727603631211">DATE</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.71577157715772%" headers="mcps1.3.19.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p52764369127">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li8276153618123"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b4494134432118">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul2027623681212"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li9276183661216">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen122764364127">SELECT
|
|
DAYOFWEEK(DATE '1997-04-25') AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li52761636181220">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table4276103621216" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row112762036181220"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.19.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p17276143617120">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1027643671220"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.19.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1427613361129">6</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section34301613121413"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section34301613121413"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section34301613121413"></a><h4 class="sectiontitle">HOUR</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul144308137147"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1043041313143"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b785444912119">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p4430151301411">Returns the hour of a day (an integer between 0 and 23) from SQL timestamp. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b4539133417318">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1143071371414"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b241915210217">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen184300133145">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b17823427288">HOUR</strong>(timestamp)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li2430181310148"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b148421651122118">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table17431201321418" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row18431131313144"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.20.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2431101371417">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.731873187318733%" id="mcps1.3.20.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p16431713201418">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.72577257725773%" id="mcps1.3.20.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p11431101319149">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row18431101312145"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.20.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1543112137143">timestamp</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.731873187318733%" headers="mcps1.3.20.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1431131311144">TIMESTAMP</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.72577257725773%" headers="mcps1.3.20.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1443181315145">SQL timestamp</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li19431101361412"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b9819155872117">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1243131381410"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li043131314146">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen94311413111420">SELECT
|
|
HOUR(TIMESTAMP '1997-04-25 10:11:12') AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1431191331415">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table9431913171415" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row943171311143"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.20.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p9432713131412">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1543291320145"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.20.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p13432121341420">10</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section17296191222215"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section17296191222215"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section17296191222215"></a><h4 class="sectiontitle">MINUTE</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul9296171210226"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1329614128226"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b158441017227">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1929619122220">Returns the minute of an hour (an integer between 0 and 59) from a SQL timestamp. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b49801842059">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li729615122220"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b357616320225">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen12971412152217">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b992111134301">MINUTE</strong>(timestamp)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1629771222214"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b16647145226">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table1429712128221" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row19297161292219"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.21.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p182972123229">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.731873187318733%" id="mcps1.3.21.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2029712124225">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.72577257725773%" id="mcps1.3.21.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p102971312162212">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row102971712122217"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.21.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p11297171222215">timestamp</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.731873187318733%" headers="mcps1.3.21.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1229701218222">TIMESTAMP</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.72577257725773%" headers="mcps1.3.21.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p10297912102218">SQL timestamp</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li32971112132218"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b184673108227">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul182971612102213"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li8297111212229">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen4297112152219">SELECT
|
|
MINUTE(TIMESTAMP '1997-04-25 10:11:12') AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1297012202214">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table1029812123222" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row229819121225"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.21.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p122983125225">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1329881232213"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.21.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p112980123223">11</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section125214317232"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section125214317232"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section125214317232"></a><h4 class="sectiontitle">SECOND</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul17252183117235"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li202525315237"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b178361352212">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p12252431112317">Returns the second of an hour (an integer between 0 and 59) from a SQL timestamp. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b20721034256">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li162521131122319"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b15669171511224">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen7252163112238">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b17800193393018">SECOND</strong>(timestamp)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li192521831162319"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b77899163227">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table12252133172316" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row112527311239"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.22.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1125211319236">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.731873187318733%" id="mcps1.3.22.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p6252431172319">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.72577257725773%" id="mcps1.3.22.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1125373112320">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row12531631162319"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.22.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1225363113235">timestamp</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.731873187318733%" headers="mcps1.3.22.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p625319311235">TIMESTAMP</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.72577257725773%" headers="mcps1.3.22.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p4253031132310">SQL timestamp</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li10253193142315"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1652392213222">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul15253163112238"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li10253133110234">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen725333112320">SELECT
|
|
SECOND(TIMESTAMP '1997-04-25 10:11:12') AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li9253123118236">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table152531331182314" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row4253831132320"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.22.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p17253143162312">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row525373122313"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.22.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p625320315238">12</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section114922047182416"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section114922047182416"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section114922047182416"></a><h4 class="sectiontitle">FLOOR</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul749264710241"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li6492164772418"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1363982519224">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p14492747132415">Returns a value that rounds <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1732519271613">timepoint</strong> down to the time unit <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b75491124162">timeintervalunit</strong>.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li6492144722417"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b625716287226">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen8492547172416">TIME/TIMESTAMP(3) <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b2083175443016">FLOOR</strong>(timepoint <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b4801458173010">TO </strong>timeintervalunit)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1149254752411"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b18334152952214">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table3492154742419" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row12493547112412"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.23.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p5493144720249">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.731873187318733%" id="mcps1.3.23.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p449324710241">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.72577257725773%" id="mcps1.3.23.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2049334762420">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row144932047162415"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.23.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p144931647102414">timepoint</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.731873187318733%" headers="mcps1.3.23.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2493184718249">TIMESTAMP/TIME</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.72577257725773%" headers="mcps1.3.23.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p174931547162413">SQL time or SQL timestamp</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row842517722710"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.23.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p042527172710">timeintervalunit</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.731873187318733%" headers="mcps1.3.23.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p84251578275">TIMEUNIT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.72577257725773%" headers="mcps1.3.23.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p3425127182716">Time unit. The value can be <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b118658309124">YEAR</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b2049315294129">QUARTER</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b551572717124">MONTH</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1920162551214">WEEK</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b958053214124">DAY</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b6188203410124">DOY</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1563914356122">HOUR</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b8532382126">MINUTE</strong>, or <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b817232414125">SECOND</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li124937471247"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b155233832216">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul349364714249"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li12493114717246">Test statement For details about the syntax of the userDefined result table, see <a href="dli_08_0347.html#dli_08_0347">User-defined Result Table</a>.<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen14493114720246">create table PrintSink (
|
|
message TIME,
|
|
message2 TIME,
|
|
message3 TIMESTAMP(3)
|
|
)
|
|
with (
|
|
'connector.type' = 'user-defined',
|
|
'connector.class-name' = 'com.swqtest.flink.sink.PrintSink'--Replace the class with a user-defined class. For details, see the syntax description in the userDefined result table.
|
|
);
|
|
|
|
INSERT INTO
|
|
PrintSink
|
|
SELECT
|
|
FLOOR(TIME '13:14:15' TO MINUTE) AS `result`
|
|
FLOOR(TIMESTAMP '1997-04-25 13:14:15' TO MINUTE) AS `result2`,
|
|
FLOOR(TIMESTAMP '1997-04-25 13:14:15' TO MINUTE) AS `result3`;
|
|
</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li249316478241">Test result<div class="p" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1363311855514"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li249316478241"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_li249316478241"></a>The values of the fields in the PrintSink table are as follows:
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table877311711558" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1477216717553"><th align="left" class="cellrowborder" valign="top" width="20.18%" id="mcps1.3.23.2.4.2.2.1.1.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p57721715558">Message</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="27.439999999999998%" id="mcps1.3.23.2.4.2.2.1.1.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p15772157155516">Message 2</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="52.38%" id="mcps1.3.23.2.4.2.2.1.1.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2853124110559">Message 3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row2773177175511"><td class="cellrowborder" valign="top" width="20.18%" headers="mcps1.3.23.2.4.2.2.1.1.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p4772117195517">13:14</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.439999999999998%" headers="mcps1.3.23.2.4.2.2.1.1.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1977213735513">13:14</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="52.38%" headers="mcps1.3.23.2.4.2.2.1.1.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p16853154119552">1997-04-25T13:14</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section345282814439"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section345282814439"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section345282814439"></a><h4 class="sectiontitle">CEIL</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1645212815437"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li3452828154313"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b141384582212">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p164531828164311">Returns a value that rounds <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1290415317170">timepoint</strong> up to the time unit <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b14219775177">timeintervalunit</strong>.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li144539283433"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b6446144882216">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen54538284439">TIME/TIMESTAMP(3) <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b119671548380">CEIL</strong>(timepoint <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b20635271388">TO </strong>timeintervalunit)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li94537284433"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b193121849172214">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table1445362814316" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row20453828154316"><th align="left" class="cellrowborder" valign="top" width="23.54235423542354%" id="mcps1.3.24.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1445312824310">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.731873187318733%" id="mcps1.3.24.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p11453112894312">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.72577257725773%" id="mcps1.3.24.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p13453162854317">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row17453728194315"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.24.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1745392854316">timepoint</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.731873187318733%" headers="mcps1.3.24.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1745318287437">TIMESTAMP/TIME</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.72577257725773%" headers="mcps1.3.24.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p245312283435">SQL time or SQL timestamp</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row7453328184312"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.24.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p14531428144313">timeintervalunit</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.731873187318733%" headers="mcps1.3.24.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p94531281437">TIMEUNIT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.72577257725773%" headers="mcps1.3.24.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p3454182818435">Time unit. The value can be <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b0951822171714">YEAR</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1795712223178">QUARTER</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b9957162291720">MONTH</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b495772218170">WEEK</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1695712261719">DAY</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b159581122151720">DOY</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1295872201713">HOUR</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1995822261715">MINUTE</strong>, or <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b4958132271719">SECOND</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li15454132864312"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b5776125614227">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul2454328134312"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li4454728124318">Test statement For details about the syntax of the userDefined result table, see <a href="dli_08_0347.html#dli_08_0347">User-defined Result Table</a>.<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1345415283430">create table PrintSink (
|
|
message TIME,
|
|
message2 TIME,
|
|
message3 TIMESTAMP(3)
|
|
)
|
|
with (
|
|
'connector.type' = 'user-defined',
|
|
'connector.class-name' = 'com.swqtest.flink.sink.PrintSink'--Replace the class with a user-defined class. For details, see the syntax description in the userDefined result table.
|
|
);
|
|
|
|
INSERT INTO
|
|
PrintSink
|
|
SELECT
|
|
CEIL(TIME '13:14:15' TO MINUTE) AS `result`
|
|
CEIL(TIMESTAMP '1997-04-25 13:14:15' TO MINUTE) AS `result2`,
|
|
CEIL(TIMESTAMP '1997-04-25 13:14:15' TO MINUTE) AS `result3`;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li18454192814436">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table44547282432" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row54541528184311"><th align="left" class="cellrowborder" valign="top" width="29.849999999999998%" id="mcps1.3.24.2.4.2.2.1.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p745452810438">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.96%" id="mcps1.3.24.2.4.2.2.1.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p9454142820432">result2</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="49.19%" id="mcps1.3.24.2.4.2.2.1.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p85611581625">result3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row545432811435"><td class="cellrowborder" valign="top" width="29.849999999999998%" headers="mcps1.3.24.2.4.2.2.1.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p11454152874313">13:15</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.96%" headers="mcps1.3.24.2.4.2.2.1.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1845492844315">13:15</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.19%" headers="mcps1.3.24.2.4.2.2.1.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p3561185818216">1997-04-25T13:15</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section132721624154711"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section132721624154711"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section132721624154711"></a><h4 class="sectiontitle">OVERLAPS</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul19272162412472"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1272152414471"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1998517472317">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p185715194817">Returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b9437113171910">TRUE</strong> if two time intervals overlap; returns <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1392810192011">FALSE</strong> otherwise.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li627220245477"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b971218822312">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1272824134713">BOOLEAN (timepoint1, temporal1) <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1491953917612">OVERLAPS </strong>(timepoint2, temporal2)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li14272124154716"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b782510912317">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table5272112419472" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row14272142424716"><th align="left" class="cellrowborder" valign="top" width="22.132213221322132%" id="mcps1.3.25.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2272152434720">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="23.472347234723472%" id="mcps1.3.25.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1427322410479">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="54.3954395439544%" id="mcps1.3.25.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1127319247479">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1727382415473"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.25.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p25272524542">timepoint1/timepoint2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="23.472347234723472%" headers="mcps1.3.25.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p10273112416478">DATE/TIME/TIMESTAMP</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.3954395439544%" headers="mcps1.3.25.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p927317240472">Time point</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row027372414713"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.25.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p198811359555">temporal1/temporal2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="23.472347234723472%" headers="mcps1.3.25.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1327372415473">DATE/TIME/TIMESTAMP/INTERVAL</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="54.3954395439544%" headers="mcps1.3.25.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p8273142418470">Time point or interval</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="note" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_note762811581144"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul78071732353"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li511113614514"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b926632619203">(timepoint, temporal)</strong> is a closed interval.</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li780717327511">The temporal can be of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b10751129162111">DATE</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b19715194362113">TIME</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1295204522112">TIMESTAMP</strong>, or <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b31171950122117">INTERVAL</strong> type.<ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul96231054175211"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li6623185411527">When th temporal is <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1250511772218">DATE</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b676861972217">TIME</strong>, or <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b89913217221">TIMESTAMP</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b77571314225">(timepoint, temporal)</strong> indicates an interval between <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b66891444225">timepoint</strong> and <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1764515477227">temporal</strong>. The temporal can be earlier than the value of <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b06671677233">timepoint</strong>, for example, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b15115111516230">(DATE '1997-04-25', DATE '1997-04-23')</strong>.</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li926405895213">When the temporal is <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b4931359232">INTERVAL</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b817413396236">(timepoint, temporal)</strong> indicates an interval between <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b12364048182311">timepoint</strong> and <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b15420135292315">timepoint + temporal</strong>.</li></ul>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li15129184012514">Ensure that <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b32661543249">(timepoint1, temporal1)</strong> and <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1716117102420">(timepoint2, temporal2)</strong> are intervals of the same data type.</li></ul>
|
|
</div></div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li727352484711"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b15777127102311">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul227302414475"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li17273624174717">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen112733241470">SELECT
|
|
(TIME '2:55:00', INTERVAL '1' HOUR) OVERLAPS (TIME '3:30:00', INTERVAL '2' HOUR) AS `result`,
|
|
(TIME '2:30:00', INTERVAL '1' HOUR) OVERLAPS (TIME '3:30:00', INTERVAL '2' HOUR) AS `result2`,
|
|
(TIME '2:30:00', INTERVAL '1' HOUR) OVERLAPS (TIME '3:31:00', INTERVAL '2' HOUR) AS `result3`,
|
|
(TIME '9:00:00', TIME '10:00:00') OVERLAPS (TIME '10:00:00', INTERVAL '3' HOUR) AS `result4`,
|
|
(TIMESTAMP '1997-04-25 12:00:00', TIMESTAMP '1997-04-25 12:20:00') OVERLAPS (TIMESTAMP '1997-04-25 13:00:00', INTERVAL '2' HOUR) AS `result5`,
|
|
(DATE '1997-04-23', INTERVAL '2' DAY) OVERLAPS (DATE '1997-04-25', INTERVAL '2' DAY) AS `result6`,
|
|
(DATE '1997-04-25', DATE '1997-04-23') OVERLAPS (DATE '1997-04-25', INTERVAL '2' DAY) AS `result7`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1827310242474">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table152731424124711" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row4274124184715"><th align="left" class="cellrowborder" valign="top" width="7.5%" id="mcps1.3.25.2.4.2.2.1.1.8.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1427414243474">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="7.3999999999999995%" id="mcps1.3.25.2.4.2.2.1.1.8.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p627462424717">result2</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="8.19%" id="mcps1.3.25.2.4.2.2.1.1.8.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1068715231210">result3</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="8.290000000000001%" id="mcps1.3.25.2.4.2.2.1.1.8.1.4"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1134282720110">result4</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="9.049999999999999%" id="mcps1.3.25.2.4.2.2.1.1.8.1.5"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1943393714110">result5</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="9.46%" id="mcps1.3.25.2.4.2.2.1.1.8.1.6"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1214104013113">result6</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50.11%" id="mcps1.3.25.2.4.2.2.1.1.8.1.7"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1863120421918">result7</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row927420242470"><td class="cellrowborder" valign="top" width="7.5%" headers="mcps1.3.25.2.4.2.2.1.1.8.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p12741724144712">true</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="7.3999999999999995%" headers="mcps1.3.25.2.4.2.2.1.1.8.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p13274162413474">true</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.19%" headers="mcps1.3.25.2.4.2.2.1.1.8.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p18687123410">false</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="8.290000000000001%" headers="mcps1.3.25.2.4.2.2.1.1.8.1.4 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1534312716110">true</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.049999999999999%" headers="mcps1.3.25.2.4.2.2.1.1.8.1.5 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p0433237412">false</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="9.46%" headers="mcps1.3.25.2.4.2.2.1.1.8.1.6 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p01413406117">true</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50.11%" headers="mcps1.3.25.2.4.2.2.1.1.8.1.7 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p10631842315">true</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section98557160415"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section98557160415"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section98557160415"></a><h4 class="sectiontitle">DATE_FORMAT</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul185516162041"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li19855181615414"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b224443142310">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p57420541348">Converts a timestamp to a value of string in the format specified by the date format string.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li885714161249"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b14104334122310">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen168571166410">STRING <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b8832236397">DATE_FORMAT</strong>(timestamp, dateformat)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li385813162046"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b18440103310237">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table586151617413" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row686320167414"><th align="left" class="cellrowborder" valign="top" width="22.132213221322132%" id="mcps1.3.26.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1686319169417">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.142014201420142%" id="mcps1.3.26.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p18863616347">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.72577257725773%" id="mcps1.3.26.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p8864316742">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row986411614411"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.26.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1986410161546">timestamp</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.142014201420142%" headers="mcps1.3.26.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p58651116346">TIMESTAMP/STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.72577257725773%" headers="mcps1.3.26.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p386516167410">Time point</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1186513161041"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.26.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p14866101614410">dateformat</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.142014201420142%" headers="mcps1.3.26.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p9866161618417">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.72577257725773%" headers="mcps1.3.26.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p78660160411">String in the date format</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li0866616246"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b451744112316">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul10867131615419"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li138679165416">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen148671816545">SELECT
|
|
DATE_FORMAT(TIMESTAMP '1997-04-25 10:11:12', 'yyyy-MM-dd HH:mm:ss') AS `result`,
|
|
DATE_FORMAT(TIMESTAMP '1997-04-25 10:11:12', 'yyyy-MM-dd') AS `result2`,
|
|
DATE_FORMAT(TIMESTAMP '1997-04-25 10:11:12', 'yy/MM/dd HH:mm') AS `result3`,
|
|
DATE_FORMAT('1997-04-25 10:11:12', 'yyyy-MM-dd') AS `result4`
|
|
FROM testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li15868171613419">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table15869016241" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row687081620410"><th align="left" class="cellrowborder" valign="top" width="25.650000000000002%" id="mcps1.3.26.2.4.2.2.1.1.5.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p14870101613414">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.44%" id="mcps1.3.26.2.4.2.2.1.1.5.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p128701816945">result2</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.47%" id="mcps1.3.26.2.4.2.2.1.1.5.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p11871131616412">result3</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="32.440000000000005%" id="mcps1.3.26.2.4.2.2.1.1.5.1.4"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p17871416947">result4</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1687218161419"><td class="cellrowborder" valign="top" width="25.650000000000002%" headers="mcps1.3.26.2.4.2.2.1.1.5.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p14872516146">1997-04-25 10:11:12</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.44%" headers="mcps1.3.26.2.4.2.2.1.1.5.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p108724161241">1997-04-25</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.47%" headers="mcps1.3.26.2.4.2.2.1.1.5.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p3873116546">97/04/25 10:11</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="32.440000000000005%" headers="mcps1.3.26.2.4.2.2.1.1.5.1.4 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p188734162417">1997-04-25</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section105601517203220"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section105601517203220"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section105601517203220"></a><h4 class="sectiontitle">TIMESTAMPADD</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul19561417193211"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li165611417183217"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b116121647172314">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p6332144511618">Returns the date and time by combining <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b18601193817299">interval</strong> and <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1746410418291">timeintervalunit</strong> and adding the combination to <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b11461124502912">timepoint</strong>.</p>
|
|
<div class="note" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_note16429629101812"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p12546131901919">The return value of <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b4983643112">TIMESTAMPADD</strong> is the value of <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b167841450173110">timepoint</strong>. An exception is that if the input <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b14191620114417">timepoint</strong> is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b141972011448">TIMESTAMP</strong> type, the return value can be inserted into a table field of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b941932034420">DATE</strong> type.</p>
|
|
</div></div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li456181763213"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1106115342317">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1856181711320">TIMESTAMP(3)/DATE/TIME <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b44289614160">TIMESTAMPADD</strong>(timeintervalunit, interval, timepoint)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li185615174324"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b31381754182312">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table20561181723219" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row19561101711322"><th align="left" class="cellrowborder" valign="top" width="22.132213221322132%" id="mcps1.3.27.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p135611217193212">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.142014201420142%" id="mcps1.3.27.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1556181793219">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.72577257725773%" id="mcps1.3.27.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p056171720328">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row16561917193216"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.27.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2056114175321">timeintervalunit</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.142014201420142%" headers="mcps1.3.27.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1856113173321">TIMEUNIT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.72577257725773%" headers="mcps1.3.27.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1456211175328">Time unit</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row356231753214"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.27.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p25621217103210">interval</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.142014201420142%" headers="mcps1.3.27.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p125623175324">INT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.72577257725773%" headers="mcps1.3.27.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p65621917153211">Interval</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row194001519123517"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.27.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2401181903511">timepoint</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.142014201420142%" headers="mcps1.3.27.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p11401019183520">TIMESTAMP/DATE/TIME</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.72577257725773%" headers="mcps1.3.27.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p164018198356">Time point</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1756241715323"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1213718116246">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul9562141716326"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li756201783211">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen6562191783215">SELECT
|
|
TIMESTAMPADD(WEEK, 1, DATE '1997-04-25') AS `result`,
|
|
TIMESTAMPADD(QUARTER, 1, TIMESTAMP '1997-04-25 10:11:12') AS `result2`,
|
|
TIMESTAMPADD(SECOND, 2, TIME '10:11:12') AS `result3`
|
|
FROM testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li195621817163211">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table14562171713215" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row105622177327"><th align="left" class="cellrowborder" valign="top" width="37.97%" id="mcps1.3.27.2.4.2.2.1.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p6562111716322">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="35.03%" id="mcps1.3.27.2.4.2.2.1.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p12562817173216">result2</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="27%" id="mcps1.3.27.2.4.2.2.1.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p105633178320">result3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row185631176321"><td class="cellrowborder" valign="top" width="37.97%" headers="mcps1.3.27.2.4.2.2.1.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p11563121733216">1997-05-02</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="35.03%" headers="mcps1.3.27.2.4.2.2.1.1.4.1.2 "><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul55011211182515"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1250114116251">If this field is inserted into a table field of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b8298205193319">TIMESTAMP</strong> type, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b779240113412">1997-07-25T10:11:12</strong> is returned.</li></ul>
|
|
<ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul14169152116252"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li41697212251">If this field is inserted into a table field of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b19155113193416">DATE</strong> type, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b131559363413">1997-07-25</strong> is returned.</li></ul>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.27.2.4.2.2.1.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p956351793215">10:11:14</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section16290114810404"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section16290114810404"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section16290114810404"></a><h4 class="sectiontitle">TIMESTAMPDIFF</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1729084813409"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li2029074854013"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b192501668248">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p10292141522610">Returns the (signed) number of <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1855904473714">timepointunit</strong> between <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b6624125016379">timepoint1</strong> and <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b626617531379">timepoint2</strong>. The unit for the interval is given by the first argument.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1829115485409"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b18560171032413">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen20291174810408">INT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b12975163612917">TIMESTAMPDIFF</strong>(timepointunit, timepoint1, timepoint2)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li5291124820404"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1574991162415">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table529164817400" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1529174810401"><th align="left" class="cellrowborder" valign="top" width="22.65226522652265%" id="mcps1.3.28.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p15291134815404">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.611961196119612%" id="mcps1.3.28.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p6291194815400">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.73577357735774%" id="mcps1.3.28.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p829154811407">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row19291194818401"><td class="cellrowborder" valign="top" width="22.65226522652265%" headers="mcps1.3.28.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p5291348134018">timepointunit</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.611961196119612%" headers="mcps1.3.28.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p11291154813401">TIMEUNIT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.28.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p6291104814404">Time unit. The value can be <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1917804133816">SECOND</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b14221261380">MINUTE</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b581710717384">HOUR</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b98701919382">DAY</strong>, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b8193412193810">MONTH </strong>or <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1252761313387">YEAR</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row929224815401"><td class="cellrowborder" valign="top" width="22.65226522652265%" headers="mcps1.3.28.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p5794479264">timepoint1/timepoint2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.611961196119612%" headers="mcps1.3.28.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1729204811408">TIMESTAMP/DATE</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.28.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1429215480403">Time point</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li13292154818407"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b15829422132416">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul7292104813406"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li929214486409">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1292114844018">SELECT
|
|
TIMESTAMPDIFF(DAY, TIMESTAMP '1997-04-25 10:00:00', TIMESTAMP '1997-04-28 10:00:00') AS `result`,
|
|
TIMESTAMPDIFF(DAY, DATE '1997-04-25', DATE '1997-04-28') AS `result2`,
|
|
TIMESTAMPDIFF(DAY, TIMESTAMP '1997-04-27 10:00:20', TIMESTAMP '1997-04-25 10:00:00') AS `result3`
|
|
FROM testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1029218488406">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table14292748144018" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1629213482407"><th align="left" class="cellrowborder" valign="top" width="37.97%" id="mcps1.3.28.2.4.2.2.1.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p102925482406">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="31.730000000000004%" id="mcps1.3.28.2.4.2.2.1.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p629364817405">result2</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="30.3%" id="mcps1.3.28.2.4.2.2.1.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p429304818408">result3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row129316483401"><td class="cellrowborder" valign="top" width="37.97%" headers="mcps1.3.28.2.4.2.2.1.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p9293104820400">3</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="31.730000000000004%" headers="mcps1.3.28.2.4.2.2.1.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p11293174812407">3</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.28.2.4.2.2.1.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p192931348144010">-2</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1698193003115"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1698193003115"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1698193003115"></a><h4 class="sectiontitle">CONVERT_TZ</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1569923013314"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li11699123013113"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b475702714245">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7699103017311">Converts a datetime<strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b172662537385"> string1</strong> (with default ISO timestamp format <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b12392589399">'yyyy-MM-dd HH:mm:ss'</strong>) from time zone <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1795601216398">string2</strong> to time zone <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b580471617393">string3</strong>.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li126991130183112"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b17436232112414">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen19699183063112">STRING <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b14518182153116">CONVERT_TZ</strong>(string1, string2, string3)</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li196997302317"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b17656173313244">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table106991730123112" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row18699830163119"><th align="left" class="cellrowborder" valign="top" width="22.132213221322132%" id="mcps1.3.29.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p069993013115">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.13201320132013%" id="mcps1.3.29.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p569920302317">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.73577357735774%" id="mcps1.3.29.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p106991330163115">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row15699103073116"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.29.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1969919301315">string1</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.13201320132013%" headers="mcps1.3.29.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1670033016312">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.29.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1170033017311">SQL timestamp. If the value does not meet the format requirements, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b19351204119396">NULL</strong> is returned.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1700133015313"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.29.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1670063013113">string2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.13201320132013%" headers="mcps1.3.29.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1070043013118">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.29.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p17700193043114">Time zone before conversion. The format of time zone should be either an abbreviation such as <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b14233261580">PST</strong>, a full name such as <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b19501631175813">America/Los_Angeles</strong>, or a custom ID such as <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1689094295819">GMT-08:00</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1993420401324"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.29.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p19472154519327">string3</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.13201320132013%" headers="mcps1.3.29.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p14721045113212">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.29.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p10472144514324">Time zone after conversion. The format of time zone should be either an abbreviation such as <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b225114514580">PST</strong>, a full name such as <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b10252195110589">America/Los_Angeles</strong>, or a custom ID such as <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1725245119588">GMT-08:00</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li8700113013114"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b143752436241">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul2700183093118"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1700113014315">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen15700163073118">SELECT
|
|
CONVERT_TZ(1970-01-01 00:00:00, UTC, America/Los_Angeles) AS `result`,
|
|
CONVERT_TZ(1997-04-25 10:00:00, UTC, GMT-08:00) AS `result2`
|
|
FROM testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li127001630173113">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table14700183015315" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row37001730163113"><th align="left" class="cellrowborder" valign="top" width="54.48%" id="mcps1.3.29.2.4.2.2.1.1.3.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1470017307318">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="45.519999999999996%" id="mcps1.3.29.2.4.2.2.1.1.3.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p9701183043119">result2</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row77016307319"><td class="cellrowborder" valign="top" width="54.48%" headers="mcps1.3.29.2.4.2.2.1.1.3.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p16701163018316">1969-12-31 16:00:00</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45.519999999999996%" headers="mcps1.3.29.2.4.2.2.1.1.3.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1770111309310">1997-04-25 02:00:00</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section01032914372"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section01032914372"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section01032914372"></a><h4 class="sectiontitle">FROM_UNIXTIME</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1510311923717"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1210311916377"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1607446182414">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p111037913711">Returns a representation of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1584155119405">numeric</strong> argument as a value in string format.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li910315920371"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b10262154992418">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1710318973714">STRING <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b202669973418">FROM_UNIXTIME</strong>(numeric[, string])</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li81038983710"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b730911504247">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table91031893377" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row910312933719"><th align="left" class="cellrowborder" valign="top" width="22.132213221322132%" id="mcps1.3.30.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p18103189133716">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.13201320132013%" id="mcps1.3.30.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p7103109183716">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.73577357735774%" id="mcps1.3.30.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p21041596374">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1010416913371"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.30.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p41046973717">numeric</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.13201320132013%" headers="mcps1.3.30.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p16104129143711">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.30.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1010416915372">An internal timestamp representing the number of seconds since 1970-01-01 00:00:00 UTC. The value can be generated by the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1953142517590">UNIX_TIMESTAMP()</strong> function.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row810411916372"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.30.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p61041492376">string</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.13201320132013%" headers="mcps1.3.30.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1810489113711">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.30.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1910419183713">Time. If this parameter is not specified, the default time format is <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b89840345117">yyyy-MM-dd HH:mm:ss</strong> format.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li61043923715"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b185595591246">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul121045973717"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li210439143714">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1010589103716">SELECT
|
|
FROM_UNIXTIME(44) AS `result`,
|
|
FROM_UNIXTIME(44, 'yyyy:MM:dd') AS `result2`
|
|
FROM testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li3105199153710">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table16105496379" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row510569173718"><th align="left" class="cellrowborder" valign="top" width="54.48%" id="mcps1.3.30.2.4.2.2.1.1.3.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1910510943711">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="45.519999999999996%" id="mcps1.3.30.2.4.2.2.1.1.3.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1610514953719">result2</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row01055916373"><td class="cellrowborder" valign="top" width="54.48%" headers="mcps1.3.30.2.4.2.2.1.1.3.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p510579183710">1970-01-01 08:00:44</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="45.519999999999996%" headers="mcps1.3.30.2.4.2.2.1.1.3.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p171051399378">1970:01:01</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section166571146145016"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section166571146145016"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section166571146145016"></a><h4 class="sectiontitle">UNIX_TIMESTAMP</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1565814665017"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li19658846195016"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1232462511">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1165813468507">Gets current Unix timestamp in seconds. The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b37889301629">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li265810461501"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b155061968254">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1658164645020">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b14595191254011">UNIX_TIMESTAMP</strong>()</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li965864615503"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b205661077255">Input parameters</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p481774245115">N/A</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1765904625012"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b16488410132512">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul13659164614509"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li106591746185012">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1665964615509">SELECT
|
|
UNIX_TIMESTAMP() AS `result`
|
|
FROM
|
|
table;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1565974611508">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table17659134614502" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1765964614509"><th align="left" class="cellrowborder" valign="top" width="100%" id="mcps1.3.31.2.4.2.2.1.1.2.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1166074695013">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row17660154605016"><td class="cellrowborder" valign="top" width="100%" headers="mcps1.3.31.2.4.2.2.1.1.2.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1366010461502">1635401982</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section175599271533"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section175599271533"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section175599271533"></a><h4 class="sectiontitle">UNIX_TIMESTAMP(string1[, string2])</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1955915279316"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li195591227936"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1753413182512">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1955912720316">Converts date time <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b02853595614">string1</strong> in format <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1372152773">string2</strong> to Unix timestamp (in seconds). The return value is of the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b147237431071">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li555942710316"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b16193317152510">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1356019271239">BIGINT <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b10746144164110">UNIX_TIMESTAMP</strong>(string1[, string2])</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1656020272313"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b8501171882512">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table1697682813211" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row7976182803216"><th align="left" class="cellrowborder" valign="top" width="22.132213221322132%" id="mcps1.3.32.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p18976328193215">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.13201320132013%" id="mcps1.3.32.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p097619288322">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.73577357735774%" id="mcps1.3.32.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p12976428163216">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row179761228133212"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.32.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p17472113883212">string1</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.13201320132013%" headers="mcps1.3.32.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p69761128183214">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.32.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p169764281324">SQL timestamp string. An error is reported if the value does not comply with the <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b67041341094">string2</strong> format.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row5976628153212"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.32.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2061217430321">string2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.13201320132013%" headers="mcps1.3.32.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p13976192815321">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.32.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p13977172873220">Time. If this parameter is not specified, the default time format is <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b26771714121118">yyyy-MM-dd HH:mm:ss</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1556015275318"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1025452622517">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul1156017270317"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li125603271037">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen856017271635">SELECT
|
|
UNIX_TIMESTAMP('1997-04-25', 'yyyy-MM-dd') AS `result`,
|
|
UNIX_TIMESTAMP('1997-04-25 00:00:10', 'yyyy-MM-dd HH:mm:ss') AS `result2`,
|
|
UNIX_TIMESTAMP('1997-04-25 00:00:00') AS `result3`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li256011271430">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table10560627636" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row556016271319"><th align="left" class="cellrowborder" valign="top" width="18.459999999999997%" id="mcps1.3.32.2.4.2.2.1.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p55604271833">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.97%" id="mcps1.3.32.2.4.2.2.1.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p17246100113515">result2</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="64.57000000000001%" id="mcps1.3.32.2.4.2.2.1.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p59761811354">result3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row115600271530"><td class="cellrowborder" valign="top" width="18.459999999999997%" headers="mcps1.3.32.2.4.2.2.1.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p105615276311">861897600</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.97%" headers="mcps1.3.32.2.4.2.2.1.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p72466043518">861897610</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.57000000000001%" headers="mcps1.3.32.2.4.2.2.1.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p997618813514">861897600</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1871816161526"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1871816161526"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1871816161526"></a><h4 class="sectiontitle">TO_DATE</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul97184166529"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li9718016165211"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b11571102912251">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1871812161524">Converts a date <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b9114144721316">string1</strong> with format <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b665784491310">string2</strong> to a date.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li471811617525"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b289273192514">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen187181316135217">DATE <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b382512684516">TO_DATE</strong>(string1[, string2])</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li10718916155219"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1857163292511">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table1171813164529" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row171813163520"><th align="left" class="cellrowborder" valign="top" width="22.132213221322132%" id="mcps1.3.33.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p10718316185215">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.13201320132013%" id="mcps1.3.33.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1371819160522">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.73577357735774%" id="mcps1.3.33.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p6719101618526">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row27194160527"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.33.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p3719161635214">string1</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.13201320132013%" headers="mcps1.3.33.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p9719116105216">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.33.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p3719121605214">SQL timestamp string. If the value is not in the required format, an error is reported.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row371917169526"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.33.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p9719111611526">string2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.13201320132013%" headers="mcps1.3.33.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p12719191625213">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.33.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p2719816135218">Format. If this parameter is not specified, the default time format is <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b894004881413">yyyy-MM-dd</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li571913166524"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b108564142517">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul8719516195219"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li071917163528">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen371901617529">SELECT
|
|
TO_DATE('1997-04-25') AS `result`,
|
|
TO_DATE('1997:04:25', 'yyyy-MM-dd') AS `result2`,
|
|
TO_DATE('1997-04-25 00:00:00', 'yyyy-MM-dd HH:mm:ss') AS `result3`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li167204169524">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table3720116195214" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1172081611529"><th align="left" class="cellrowborder" valign="top" width="18.459999999999997%" id="mcps1.3.33.2.4.2.2.1.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p272091635220">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.97%" id="mcps1.3.33.2.4.2.2.1.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1972051611528">result2</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="64.57000000000001%" id="mcps1.3.33.2.4.2.2.1.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p472061615217">result3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row11720416185211"><td class="cellrowborder" valign="top" width="18.459999999999997%" headers="mcps1.3.33.2.4.2.2.1.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p14720216185213">1997-04-25</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.97%" headers="mcps1.3.33.2.4.2.2.1.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p772051614526">1997-04-25</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.57000000000001%" headers="mcps1.3.33.2.4.2.2.1.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p872071616527">1997-04-25</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1374114020551"><a name="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1374114020551"></a><a name="en-us_topic_0000001166031885_en-us_topic_0000001127976909_section1374114020551"></a><h4 class="sectiontitle">TO_TIMESTAMP</h4><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul637410405551"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li12374114014558"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b91705446254">Function</strong><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p18313720144911">Converts date time <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b172037380183">string1</strong> with format <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b8843113915187">string2</strong> to a timestamp.</p>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li20374740155520"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b6673148122520">Description</strong><pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen18375144075516">TIMESTAMP <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b8855713205019">TO_TIMESTAMP</strong>(string1[, string2])</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li43759408556"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b661254911253">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table15375040115511" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row1837524014551"><th align="left" class="cellrowborder" valign="top" width="22.132213221322132%" id="mcps1.3.34.2.3.2.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p737574085515">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.13201320132013%" id="mcps1.3.34.2.3.2.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p6375440205511">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="57.73577357735774%" id="mcps1.3.34.2.3.2.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1637584025518">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row137554045517"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.34.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1375104014557">string1</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.13201320132013%" headers="mcps1.3.34.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p437544075515">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.34.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p9375940155510">SQL timestamp string. If the value is not in the required format, <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b1609131171915">NULL</strong> is returned.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row537564019551"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.34.2.3.2.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1837634015515">string2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.13201320132013%" headers="mcps1.3.34.2.3.2.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1437684019555">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="57.73577357735774%" headers="mcps1.3.34.2.3.2.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1837684075519">Date format. If this parameter is not specified, the default format is <strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b105635544196">yyyy-MM-dd HH:mm:ss</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li1337654019555"><strong id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_b5414257112514">Example</strong><ul id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_ul15376134055514"><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li037684075520">Test statement<pre class="screen" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_screen1537634018559">SELECT
|
|
TO_TIMESTAMP('1997-04-25', 'yyyy-MM-dd') AS `result`,
|
|
TO_TIMESTAMP('1997-04-25 00:00:00') AS `result2`,
|
|
TO_TIMESTAMP('1997-04-25 00:00:00', 'yyyy-MM-dd HH:mm:ss') AS `result3`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_li143761940165517">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_table1037617406551" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row11376204035511"><th align="left" class="cellrowborder" valign="top" width="18.459999999999997%" id="mcps1.3.34.2.4.2.2.1.1.4.1.1"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p1237718400553">result</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.97%" id="mcps1.3.34.2.4.2.2.1.1.4.1.2"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p16377164010559">result2</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="64.57000000000001%" id="mcps1.3.34.2.4.2.2.1.1.4.1.3"><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p53774408551">result3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_row63771540205512"><td class="cellrowborder" valign="top" width="18.459999999999997%" headers="mcps1.3.34.2.4.2.2.1.1.4.1.1 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p53776407552">1997-04-25 00:00</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.97%" headers="mcps1.3.34.2.4.2.2.1.1.4.1.2 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p123776402553">1997-04-25 00:00</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.57000000000001%" headers="mcps1.3.34.2.4.2.2.1.1.4.1.3 "><p id="dli_08_0334__en-us_topic_0000001166031885_en-us_topic_0000001127976909_p193771540125518">1997-04-25 00:00</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_08_0331.html">Built-In Functions</a></div>
|
|
</div>
|
|
</div>
|
|
|