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>
1681 lines
194 KiB
HTML
1681 lines
194 KiB
HTML
<a name="dli_08_0429"></a><a name="dli_08_0429"></a>
|
|
|
|
<h1 class="topictitle1">Temporal Functions</h1>
|
|
<div id="body8662426"><p id="dli_08_0429__en-us_topic_0000001262335946_dli_08_0097_a0afc1542d28746fc9572e1ad11e28d5d"><a href="#dli_08_0429__en-us_topic_0000001262335946_dli_08_0097_ta2a0e6534d354c7195ebf06580c6c081">Table 1</a> lists the time functions supported by Flink OpenSource SQL.</p>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_dli_08_0097_section565310510264"><h4 class="sectiontitle">Description</h4>
|
|
<div class="tablenoborder"><a name="dli_08_0429__en-us_topic_0000001262335946_dli_08_0097_ta2a0e6534d354c7195ebf06580c6c081"></a><a name="en-us_topic_0000001262335946_dli_08_0097_ta2a0e6534d354c7195ebf06580c6c081"></a><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_aa80b70b4f1624621a61e741988c5d582">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_ac86f61fa314d4836821b7c19d57ed457"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_en-us_topic_0060575890_p097102217463">Parse the date string (<strong id="dli_08_0429__en-us_topic_0000001262335946_b1578418203211">yyyy-MM-dd</strong>) to a SQL date.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_en-us_topic_0060575890_p66208213435"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_en-us_topic_0060575890_p362162194314">Parse the time string (<strong id="dli_08_0429__en-us_topic_0000001262335946_b146492022103217">HH:mm:ss[.fff]</strong>) to a SQL time.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_en-us_topic_0060575890_p062182113439"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_a8e5a140307a44c7a9bba48033ce4096a">Convert the time string into a timestamp. The time string format is <strong id="dli_08_0429__en-us_topic_0000001262335946_b08811143103215">yyyy-MM-dd HH:mm:ss[.fff]</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_a07ebf2beb37442a8bc0510aa92ae391d"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p231292515196">interval indicates the interval. There are two forms:</p>
|
|
<ul id="dli_08_0429__en-us_topic_0000001262335946_ul15361195202"><li id="dli_08_0429__en-us_topic_0000001262335946_li18536169192015"><strong id="dli_08_0429__en-us_topic_0000001262335946_b14665783414495">yyyy-MM</strong> for SQL intervals of months. An interval range might be <strong id="dli_08_0429__en-us_topic_0000001262335946_b6148212784495">YEAR</strong> or<strong id="dli_08_0429__en-us_topic_0000001262335946_b18127100514495"> YEAR TO MONTH </strong>for intervals of months. </li><li id="dli_08_0429__en-us_topic_0000001262335946_li1853629152013"><strong id="dli_08_0429__en-us_topic_0000001262335946_b15536139152015">dd hh:mm:ss.fff</strong> for SQL intervals of milliseconds. An interval range might be <strong id="dli_08_0429__en-us_topic_0000001262335946_b8928708824495">DAY</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b2487810214495">MINUTE</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b9217256494495">DAY TO HOUR</strong>, or <strong id="dli_08_0429__en-us_topic_0000001262335946_b180543374495">DAY TO SECOND</strong>.</li></ul>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_dli_08_0097_en-us_topic_0060575890_p34549219522">Example:</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_dli_08_0097_p10145102112514">INTERVAL '10 00:00:00.004' DAY TO second indicates that the interval is 10 days and 4 milliseconds.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p630817199586">INTERVA<strong id="dli_08_0429__en-us_topic_0000001262335946_b9295703484495">L '10' DAY</strong>: indicates that the interval is 10 days.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_dli_08_0097_en-us_topic_0060575890_p849154571214"><strong id="dli_08_0429__en-us_topic_0000001262335946_b606971754495">INTERVAL '2-10' YEAR TO MONTH</strong> indicates that the interval is two years and ten months.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_a6965d1077bf6425f9aa006163ededed0"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_en-us_topic_0060575890_p2938947522">Return the SQL date of UTC time zone.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_en-us_topic_0060575890_p7541167406"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_ad8f46723d2334db5b440bce0c5f31e14">Return the SQL time of UTC time zone.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_a1249662b8bff4bef8086c9fe4a13f29a"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_a063e702dfd5b4a4497ee9fd2f2198d18">Return the SQL timestamp of UTC time zone.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_en-us_topic_0060575890_p852131644019"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_a124cad95c1d245a8b14fe7fb4ddb9897">Return the SQL time of the current time zone.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_af689318e7c264e62aa4b2421fe20a36d"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_a85b54e5560b74f31a5e9112f92ae4b84">Return the SQL timestamp of the current time zone.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_en-us_topic_0060575890_p7507165405"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_dli_08_0097_aec44d12f22134b7d8d9f30ce54de302d">Extract part of the time point or interval. Return the part in the int type.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p3207181512497">For example, extract the date <span class="uicontrol" id="dli_08_0429__en-us_topic_0000001262335946_uicontrol11207115114914"><b>2006-06-05</b></span> and return 5.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_dli_08_0097_a2db479eec5b24736bb5691fc968a67f3"><strong id="dli_08_0429__en-us_topic_0000001262335946_b6364120544495">EXTRACT(DAY FROM DATE '2006-06-05')</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b10643859944495">5</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row028717578494"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p7287657144910"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1628713578495">Return the year from SQL date.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p19788135312510">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b100940284495">YEAR(DATE'1994-09-27')</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b11601507144495">1994</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row3689115924915"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p87162045318"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1771204532">Return the quarter of a year (an integer between 1 and 4) from SQL date.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row912320245017"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p51231212509"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p5123102155013">BIGINT</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p341020269582"></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.53465346534653%" headers="mcps1.3.2.2.2.4.1.3 "><p id="dli_08_0429__en-us_topic_0000001262335946_p31233218507">Return the month of a year (an integer between 1 and 12) from SQL date.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p1436133913580">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b15653666854495">MONTH(DATE '1994-09-27')</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b20626431654495">9</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row745113415502"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p10451144145020"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p44511549504">Return the week of a year (an integer between 1 and 53) from SQL date.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p13453140604">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b15215448944495">WEEK(DATE'1994-09-27')</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b16464894194495">39</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row1911547125014"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p41151171508"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p011519765020">Returns the day of a year (an integer between 1 and 366) from SQL date.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p54611658162518">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b17761216604495">DAYOFYEAR(DATE '1994-09-27')</strong> is <strong id="dli_08_0429__en-us_topic_0000001262335946_b14570906124495">270</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row5881031192313"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p1288173120232"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p8881153142312">Return the day of a month (an integer between 1 and 31) from SQL date.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p929954692615">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b11418061504495">DAYOFMONTH(DATE'1994-09-27')</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b2614442944495">27</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row176251535122314"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p2625113552314"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p362583519231">Return the day of a week (an integer between 1 and 7) from SQL date.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p979115613350">Sunday is set to <strong id="dli_08_0429__en-us_topic_0000001262335946_b1330739504495">1</strong>.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p15735812113617">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b7339297754495">DAYOFWEEK(DATE'1994-09-27')</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b6747244184495">3</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row1698315811270"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p698388162717"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p09835882712">Returns the hour of a day (an integer between 0 and 23) from SQL timestamp. </p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p61153110408">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b20262701564495">HOUR(TIMESTAMP '1994-09-27 13:14:15')</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b12761117964495">13</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row1822314115272"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p202241114273"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p162241511152711">Returns the minute of an hour (an integer between 0 and 59) from SQL timestamp.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p4845162274110">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b14155532964495">MINUTE(TIMESTAMP '1994-09-27 13:14:15')</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b3994815654495">14</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row421811316273"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p221811372717"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p72181136277">Returns the second of a minute (an integer between 0 and 59) from SQL timestamp.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p16902923194210">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b7846352674495">SECOND(TIMESTAMP '1994-09-27 13:14:15')</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b11130506734495">15</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row0556245184117"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p1455684513419"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p86896266436">Round a time point down to the given unit.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p7689112644310">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b10486591274495">12:44:00</strong> is returned from <strong id="dli_08_0429__en-us_topic_0000001262335946_b547759644495">FLOOR(TIME '12:44:31' TO MINUTE)</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row21061243124114"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p2106843194111"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p112747513434">Round a time point up to the given unit.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p152750513439">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b14048988234495">CEIL(TIME '12:44:31' TO MINUTE)</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b14962703804495">12:45:00</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row1512284134115"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p5122164124116"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1112216417411">Return <strong id="dli_08_0429__en-us_topic_0000001262335946_b14301309344495">TRUE</strong> if two time intervals defined by (timepoint1, temporal1) and (timepoint2, temporal2) overlap.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p105011261505">Example:</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p89942235016"><strong id="dli_08_0429__en-us_topic_0000001262335946_b14801174744495">(TIME '2:55:00', INTERVAL '1' HOUR) OVERLAPS (TIME '3:30:00', INTERVAL '2' HOUR)</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b11048425144495">TRUE</strong>.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p8149128175019"><strong id="dli_08_0429__en-us_topic_0000001262335946_b3659565734495">(TIME '9:00:00', TIME '10:00:00') OVERLAPS (TIME '10:15:00', INTERVAL '3' HOUR)</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b7051378134495">FALSE</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row1565415446"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p1561747447"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p105731342081">Convert timestamp to a value of string in the format specified by the date format string.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row48031710446"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p28031114448"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1667711375516">Return the date and time added to <strong id="dli_08_0429__en-us_topic_0000001262335946_b6824084464495">timepoint</strong> based on the result of <strong id="dli_08_0429__en-us_topic_0000001262335946_b964719814495">interval</strong> and <strong id="dli_08_0429__en-us_topic_0000001262335946_b13381763564495">timeintervalunit</strong>.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p480316164418">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b13436130034495">TIMESTAMPADD(WEEK, 1, DATE '2003-01-02')</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b11753223554495">2003-01-09</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row9873125914313"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p487335904318"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p0873659204314">Return the (signed) number of timepointunit between <strong id="dli_08_0429__en-us_topic_0000001262335946_b11237772954495">timepoint1</strong> and <strong id="dli_08_0429__en-us_topic_0000001262335946_b18139800064495">timepoint2</strong>. </p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p1832955017219">The unit for the interval is given by the first argument, which should be one of the following values: SECOND, MINUTE, HOUR, DAY, MONTH, or YEAR.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p1773716478319">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b19610971314495">TIMESTAMPDIFF(DAY, TIMESTAMP '2003-01-02 10:00:00', TIMESTAMP '2003-01-03 10:00:00')</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b1119843414495">1</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row1693732212117"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p109373227114"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p493717222115">Convert a datetime <strong id="dli_08_0429__en-us_topic_0000001262335946_b5478667724495">string1</strong> from time zone <strong id="dli_08_0429__en-us_topic_0000001262335946_b5417067804495">string2</strong> to time zone <strong id="dli_08_0429__en-us_topic_0000001262335946_b19610604334495">string3</strong>. </p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p2984151515915">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b20288367124495">CONVERT_TZ('1970-01-01 00:00:00', 'UTC', 'America/Los_Angeles')</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b13902271894495">'1969-12-31 16:00:00'</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row183471629813"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p1834720298113"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p29691910132415">Return a string representation of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b611132834516">numeric</strong> argument (in seconds) in the current time zone.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p22041554182718">The default string format is YYYY-MM-DD hh:mm:ss.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p1177645271918">For example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b15454591174495">FROM_UNIXTIME(44)</strong> returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b20458398674495">1970-01-01 09:00:44</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row2341112515117"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p13419254113"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1634113251619">Get current Unix timestamp in seconds.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p191163210222"></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row17235152713114"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p14235527718"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p72351927414">Convert date time string <strong id="dli_08_0429__en-us_topic_0000001262335946_b19742286754495">string1</strong> in format <strong id="dli_08_0429__en-us_topic_0000001262335946_b5952809994495">string2</strong> to Unix timestamp (in seconds), using the specified timezone in table config.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p325613334315">The default format of <strong id="dli_08_0429__en-us_topic_0000001262335946_b9968771104495">string2</strong> is yyyy-MM-dd HH:mm:ss.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row114830188249"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p8483161819243"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p548331815247">Convert a date string <strong id="dli_08_0429__en-us_topic_0000001262335946_b10652884994495">string1</strong> with format <strong id="dli_08_0429__en-us_topic_0000001262335946_b20977145114495">string2</strong> to a date.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p7785191312328">The default format of <strong id="dli_08_0429__en-us_topic_0000001262335946_b1106607474495">string2</strong> is yyyy-MM-dd.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row14346320152417"><td class="cellrowborder" valign="top" width="29.673267326732677%" headers="mcps1.3.2.2.2.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p4346192015249"><a href="#dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p15346162002411">Converts date time string string1 with format string2 under the 'UTC+0' time zone to a timestamp.</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p1112191312348">The default format of <strong id="dli_08_0429__en-us_topic_0000001262335946_b17029276904495">string2</strong> is yyyy-MM-dd HH:mm:ss.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section14378194561717"><a name="dli_08_0429__en-us_topic_0000001262335946_section14378194561717"></a><a name="en-us_topic_0000001262335946_section14378194561717"></a><h4 class="sectiontitle">DATE</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul202988559179"><li id="dli_08_0429__en-us_topic_0000001262335946_li1529825511713"><strong id="dli_08_0429__en-us_topic_0000001262335946_b16261143915188">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p1652615285183">Returns a SQL date parsed from string in form of <strong id="dli_08_0429__en-us_topic_0000001262335946_b2757154010315">yyyy-MM-dd</strong>.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li991314510181"><strong id="dli_08_0429__en-us_topic_0000001262335946_b6991541103218">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen85953333326">DATE <strong id="dli_08_0429__en-us_topic_0000001262335946_b119751846134812">DATE </strong>string</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li3917139131820"><strong id="dli_08_0429__en-us_topic_0000001262335946_b67181943153217">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table11910153753010" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p39117373307">Data Types</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_0429__en-us_topic_0000001262335946_p1391193712304">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row1891183710301"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p4883114991116">String in the SQL date format. </p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p891173715309">Note that the string must be in the <strong id="dli_08_0429__en-us_topic_0000001262335946_b11706887384495">yyyy-MM-dd</strong> format. Otherwise, an error will be reported.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li374581412189"><strong id="dli_08_0429__en-us_topic_0000001262335946_b568845443214">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul138618914337"><li id="dli_08_0429__en-us_topic_0000001262335946_li1933692417358">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1150181573219">SELECT
|
|
DATE "2021-08-19" AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li14230202883518">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table0224118113517" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p836324211360">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p8978446163612">2021-08-19</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section360564211339"><a name="dli_08_0429__en-us_topic_0000001262335946_section360564211339"></a><a name="en-us_topic_0000001262335946_section360564211339"></a><h4 class="sectiontitle">TIME</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul360504212331"><li id="dli_08_0429__en-us_topic_0000001262335946_li156051642113312"><strong id="dli_08_0429__en-us_topic_0000001262335946_b11605154213317">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p156021956173319">Returns a SQL time parsed from string in form of <strong id="dli_08_0429__en-us_topic_0000001262335946_b9107157125016">HH:mm:ss[.fff]</strong>.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li11606042153313"><strong id="dli_08_0429__en-us_topic_0000001262335946_b56069429332">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen860618424334">TIME <strong id="dli_08_0429__en-us_topic_0000001262335946_b1285712503482">TIME </strong>string</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li06061342133312"><strong id="dli_08_0429__en-us_topic_0000001262335946_b5606144216337">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table1067317317346" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p867373103412">Data Types</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_0429__en-us_topic_0000001262335946_p12673113133411">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row567343112348"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1067323114343">Time</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p7361130112517">Note that the string must be in the format of <strong id="dli_08_0429__en-us_topic_0000001262335946_b39366316573">HH:mm:ss[.fff]</strong>. Otherwise, an error will be reported.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li560612429338"><strong id="dli_08_0429__en-us_topic_0000001262335946_b66061142143313">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1260624223316"><li id="dli_08_0429__en-us_topic_0000001262335946_li1360694216331">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen206065428334">SELECT
|
|
TIME "10:11:12" AS `result`,
|
|
TIME "10:11:12.032" AS `result2`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li960613424333">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table86061442203312" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1790827113318">result2</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1790811773316">10:11:12.032</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section1878994533516"><a name="dli_08_0429__en-us_topic_0000001262335946_section1878994533516"></a><a name="en-us_topic_0000001262335946_section1878994533516"></a><h4 class="sectiontitle">TIMESTAMP</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1979011458350"><li id="dli_08_0429__en-us_topic_0000001262335946_li197901345203511"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1479074520353">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p1779074515352">Converts the time string into timestamp. The time string format is <strong id="dli_08_0429__en-us_topic_0000001262335946_b19107679464495">yyyy-MM-dd HH:mm:ss[.fff]</strong>. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b18985108094495">TIMESTAMP(3) </strong>type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li4790645173516"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1679004543516">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen3790144516358">TIMESTAMP(3) <strong id="dli_08_0429__en-us_topic_0000001262335946_b625655504810">TIMESTAMP </strong>string</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li779012457353"><strong id="dli_08_0429__en-us_topic_0000001262335946_b177906454359">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table1079084533515" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p079015451359">Data Types</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_0429__en-us_topic_0000001262335946_p879018451351">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row9790145193517"><td class="cellrowborder" valign="top" width="27.34273427342734%" headers="mcps1.3.5.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p17999111693611">Time</p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p5273104720470">Note that the string must be in the format of <strong id="dli_08_0429__en-us_topic_0000001262335946_b8918162425716">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_0429__en-us_topic_0000001262335946_li1779016458359"><strong id="dli_08_0429__en-us_topic_0000001262335946_b2790145103513">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul17790045103510"><li id="dli_08_0429__en-us_topic_0000001262335946_li679014543516">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_li8790174553514">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table1279094593511" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p62281849154017">result2</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_section8680184819367"><a name="dli_08_0429__en-us_topic_0000001262335946_section8680184819367"></a><a name="en-us_topic_0000001262335946_section8680184819367"></a><h4 class="sectiontitle">INTERVAL</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1668117487366"><li id="dli_08_0429__en-us_topic_0000001262335946_li26811548103612"><strong id="dli_08_0429__en-us_topic_0000001262335946_b168115486367">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p18681548133616">Parses an interval string.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li16814483367"><strong id="dli_08_0429__en-us_topic_0000001262335946_b06819485366">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen868118481362">INTERVAL <strong id="dli_08_0429__en-us_topic_0000001262335946_b164101011492">INTERVAL </strong>string range</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1868194873616"><strong id="dli_08_0429__en-us_topic_0000001262335946_b9681248143614">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table15381139153718" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1381139153714">Data Types</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_0429__en-us_topic_0000001262335946_p19381039103719">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row173813399377"><td class="cellrowborder" valign="top" width="23.522352235223522%" headers="mcps1.3.6.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p638183911378">Timestamp string used together with the <strong id="dli_08_0429__en-us_topic_0000001262335946_b2056982264495">range</strong> parameter. The string is in either of the following two formats:</p>
|
|
<ul id="dli_08_0429__en-us_topic_0000001262335946_ul14137932161217"><li id="dli_08_0429__en-us_topic_0000001262335946_li18137232131219"><strong id="dli_08_0429__en-us_topic_0000001262335946_b3421508914495">yyyy-MM</strong> for SQL intervals of months. An interval range might be <strong id="dli_08_0429__en-us_topic_0000001262335946_b21285148994495">YEAR</strong> or<strong id="dli_08_0429__en-us_topic_0000001262335946_b10770982954495"> YEAR TO MONTH </strong>for intervals of months. </li><li id="dli_08_0429__en-us_topic_0000001262335946_li841674219503"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1218483015599">dd hh:mm:ss.fff</strong> for SQL intervals of milliseconds. An interval range might be <strong id="dli_08_0429__en-us_topic_0000001262335946_b17410709344495">DAY</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b10850519194495">MINUTE</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b9530602254495">DAY TO HOUR</strong>, or <strong id="dli_08_0429__en-us_topic_0000001262335946_b17689758114495">DAY TO SECOND</strong>.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row273614571912"><td class="cellrowborder" valign="top" width="23.522352235223522%" headers="mcps1.3.6.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p29167519529">Interval range. This parameter is used together with the <strong id="dli_08_0429__en-us_topic_0000001262335946_b19599124474495">string</strong> parameter. </p>
|
|
<p id="dli_08_0429__en-us_topic_0000001262335946_p17490112611119">Available values are as follows: <strong id="dli_08_0429__en-us_topic_0000001262335946_b2600784113">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_0429__en-us_topic_0000001262335946_li468164816369"><strong id="dli_08_0429__en-us_topic_0000001262335946_b5681124820367">Example</strong><div class="p" id="dli_08_0429__en-us_topic_0000001262335946_p972005514379">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1968114819363">-- indicates that 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_0429__en-us_topic_0000001262335946_section17211159143814"><a name="dli_08_0429__en-us_topic_0000001262335946_section17211159143814"></a><a name="en-us_topic_0000001262335946_section17211159143814"></a><h4 class="sectiontitle">CURRENT_DATE</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul621159193816"><li id="dli_08_0429__en-us_topic_0000001262335946_li921155913818"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1121105913817">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p1921185914381">Returns the current SQL time (<strong id="dli_08_0429__en-us_topic_0000001262335946_b19882786664495">yyyy-MM-dd</strong>) in the local time zone. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b19802631934495">DATE </strong>type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li12111592382"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1721559123810">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1521359193817">DATE <strong id="dli_08_0429__en-us_topic_0000001262335946_b8653201117556">CURRENT_DATE</strong></pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li4211459203816"><strong id="dli_08_0429__en-us_topic_0000001262335946_b192115595386">Input parameters</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p336973224011">None</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li5211059193820"><strong id="dli_08_0429__en-us_topic_0000001262335946_b162225933818">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul19227599388"><li id="dli_08_0429__en-us_topic_0000001262335946_li7221159143810">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1622175913813">SELECT
|
|
CURRENT_DATE AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1922959143814">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table1222959143818" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p62235933818">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p7925115120405">2021-10-28</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section207768598406"><a name="dli_08_0429__en-us_topic_0000001262335946_section207768598406"></a><a name="en-us_topic_0000001262335946_section207768598406"></a><h4 class="sectiontitle">CURRENT_TIME</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1177611592403"><li id="dli_08_0429__en-us_topic_0000001262335946_li6776135954019"><strong id="dli_08_0429__en-us_topic_0000001262335946_b877645913402">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p7776759124012">Returns the current SQL time (<strong id="dli_08_0429__en-us_topic_0000001262335946_b20871742424495">HH:mm:sss.fff</strong>) in the local time zone. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b2066831044495">TIME</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li677614599406"><strong id="dli_08_0429__en-us_topic_0000001262335946_b27761359194010">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1577695954014">TIME <strong id="dli_08_0429__en-us_topic_0000001262335946_b9124847185420">CURRENT_TIME</strong></pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1677618598407"><strong id="dli_08_0429__en-us_topic_0000001262335946_b187769590403">Input parameters</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p147762595408">None</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li17776125954010"><strong id="dli_08_0429__en-us_topic_0000001262335946_b177685944016">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul15776185913406"><li id="dli_08_0429__en-us_topic_0000001262335946_li777645916408">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen6776135917404">SELECT
|
|
CURRENT_TIME AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li77760591406">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table177766596402" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p7776115915405">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p2793164752014">08:29:19.289</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section17661335184515"><a name="dli_08_0429__en-us_topic_0000001262335946_section17661335184515"></a><a name="en-us_topic_0000001262335946_section17661335184515"></a><h4 class="sectiontitle">CURRENT_TIMESTAMP</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul676623513459"><li id="dli_08_0429__en-us_topic_0000001262335946_li176613554514"><strong id="dli_08_0429__en-us_topic_0000001262335946_b19766113511459">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p776603514454">Returns the current SQL timestamp in the local time zone. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b17067260714495">TIMESTAMP(3)</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li476623594517"><strong id="dli_08_0429__en-us_topic_0000001262335946_b976623584516">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen161621232095">TIMESTAMP(3) <strong id="dli_08_0429__en-us_topic_0000001262335946_b11708121615414">CURRENT_TIMESTAMP</strong></pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li876653594516"><strong id="dli_08_0429__en-us_topic_0000001262335946_b6767435144518">Input parameters</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p1176733515454">None</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1476715357452"><strong id="dli_08_0429__en-us_topic_0000001262335946_b0767123516451">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul14767203554511"><li id="dli_08_0429__en-us_topic_0000001262335946_li15767183574518">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1776733516456">SELECT
|
|
CURRENT_TIMESTAMP AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li5767173510459">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table1767335134516" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p576773513454">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_section11477133554614"><a name="dli_08_0429__en-us_topic_0000001262335946_section11477133554614"></a><a name="en-us_topic_0000001262335946_section11477133554614"></a><h4 class="sectiontitle">LOCALTIME</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1447783510469"><li id="dli_08_0429__en-us_topic_0000001262335946_li1947773554613"><strong id="dli_08_0429__en-us_topic_0000001262335946_b124779357462">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p1223312517199">Returns the current SQL time in the local time zone. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b8883777394495">TIME</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li747733519463"><strong id="dli_08_0429__en-us_topic_0000001262335946_b2477133513466">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen2477435164615">TIME <strong id="dli_08_0429__en-us_topic_0000001262335946_b11641271428">LOCALTIME</strong></pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li947733574613"><strong id="dli_08_0429__en-us_topic_0000001262335946_b18477735124617">Input parameters</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p1647713514612">None</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li447783519461"><strong id="dli_08_0429__en-us_topic_0000001262335946_b14477183514618">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul24771335174610"><li id="dli_08_0429__en-us_topic_0000001262335946_li1547753514465">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen647718357460">SELECT
|
|
LOCALTIME AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li947793594615">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table13477113510464" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p16477735164616">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1427461514472">16:39:37.706</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section14830142934817"><a name="dli_08_0429__en-us_topic_0000001262335946_section14830142934817"></a><a name="en-us_topic_0000001262335946_section14830142934817"></a><h4 class="sectiontitle">LOCALTIMESTAMP</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1283042915483"><li id="dli_08_0429__en-us_topic_0000001262335946_li19830829184814"><strong id="dli_08_0429__en-us_topic_0000001262335946_b138301029104812">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p3830132911482">Returns the current SQL timestamp in the local time zone. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b18337425674495">TIMESTAMP(3)</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1983014295486"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1883010290483">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen68304297482">TIMESTAMP(3) <strong id="dli_08_0429__en-us_topic_0000001262335946_b1527731012541">LOCALTIMESTAMP</strong></pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li148301729124817"><strong id="dli_08_0429__en-us_topic_0000001262335946_b68307292486">Input parameters</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p3830629164812">None</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li148301529144810"><strong id="dli_08_0429__en-us_topic_0000001262335946_b783032920482">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1830132944811"><li id="dli_08_0429__en-us_topic_0000001262335946_li7830829104814">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1830629154815">SELECT
|
|
LOCALTIMESTAMP AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li9830192964817">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table19830152912485" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p7830152916489">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_section184791718509"><a name="dli_08_0429__en-us_topic_0000001262335946_section184791718509"></a><a name="en-us_topic_0000001262335946_section184791718509"></a><h4 class="sectiontitle">EXTRACT</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1047217145017"><li id="dli_08_0429__en-us_topic_0000001262335946_li1247617155019"><strong id="dli_08_0429__en-us_topic_0000001262335946_b2473177501">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p19567854757">Returns a value extracted from the <strong id="dli_08_0429__en-us_topic_0000001262335946_b1732656784495">timeintervalunit</strong> part of temporal. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b12120996044495">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li54751785019"><strong id="dli_08_0429__en-us_topic_0000001262335946_b64713174509">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen15471817185014">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b167721838517">EXTRACT</strong>(timeinteravlunit <strong id="dli_08_0429__en-us_topic_0000001262335946_b124946851">FROM </strong>temporal)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li247717185010"><strong id="dli_08_0429__en-us_topic_0000001262335946_b3471717205011">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table108661744165017" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1086614455018">Data Types</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_0429__en-us_topic_0000001262335946_p17866144115013">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row4866184412509"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.12.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p68008411318">Time unit to be extracted from a time point or interval. The value can be <strong id="dli_08_0429__en-us_topic_0000001262335946_b19695467314495">YEAR</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b17784797904495">QUARTER</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b2229432564495">MONTH</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b8347935864495">WEEK</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b16751001884495">DAY</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b365431794495">DOY</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b11056608144495">HOUR</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b21408731204495">MINUTE</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b15581897434495">SECOND</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row128663449509"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.12.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1092012183116">Time point or interval</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="caution" id="dli_08_0429__en-us_topic_0000001262335946_note660918595510"><span class="cautiontitle"><img src="public_sys-resources/caution_3.0-en-us.png"> </span><div class="cautionbody"><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p186201523141318">For example, an error message is displayed when the following statement is executed because <strong id="dli_08_0429__en-us_topic_0000001262335946_b10879466594495">YEAR</strong> cannot be extracted from <strong id="dli_08_0429__en-us_topic_0000001262335946_b17932153324495">TIME</strong>.</p>
|
|
<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen4240161971318">SELECT
|
|
EXTRACT(YEAR FROM TIME '12:44:31' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</div></div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li2047121795018"><strong id="dli_08_0429__en-us_topic_0000001262335946_b174751718507">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul947217205010"><li id="dli_08_0429__en-us_topic_0000001262335946_li247151717502">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_li547111775016">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table197512181539" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1475181805317">result4</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p7751191835318">2</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section1643812191377"><a name="dli_08_0429__en-us_topic_0000001262335946_section1643812191377"></a><a name="en-us_topic_0000001262335946_section1643812191377"></a><h4 class="sectiontitle">YEAR</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul104388197372"><li id="dli_08_0429__en-us_topic_0000001262335946_li10438719173718"><strong id="dli_08_0429__en-us_topic_0000001262335946_b19438619103714">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p184388192370">Returns the year from a SQL date date. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b6257369994495">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li11438141916371"><strong id="dli_08_0429__en-us_topic_0000001262335946_b6438111943717">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen194381191375">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b49013125179">YEAR</strong>(date)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li4438141923711"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1438151923714">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table3438171943719" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p12439121915372">Data Types</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_0429__en-us_topic_0000001262335946_p194391019123716">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row15439519173715"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.13.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p19439719203714">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li74395197374"><strong id="dli_08_0429__en-us_topic_0000001262335946_b9439319113718">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1543961973712"><li id="dli_08_0429__en-us_topic_0000001262335946_li94391519163717">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen2439121917370">SELECT
|
|
YEAR(DATE '1997-04-25' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li743920195378">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table124394191378" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p11439119113713">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p04401819183713">1997</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section517261154017"><a name="dli_08_0429__en-us_topic_0000001262335946_section517261154017"></a><a name="en-us_topic_0000001262335946_section517261154017"></a><h4 class="sectiontitle">QUARTER</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1617241120406"><li id="dli_08_0429__en-us_topic_0000001262335946_li16172511194015"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1172131134017">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p1917271115409">Returns the quarter of a year (an integer between 1 and 4) from a SQL date date. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b12549983204495">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li5172711164016"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1317221194015">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen17172611134015">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b17353212185">QUARTER</strong>(date)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1172511204014"><strong id="dli_08_0429__en-us_topic_0000001262335946_b6172111124020">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table7172161114012" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p31721511184010">Data Types</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_0429__en-us_topic_0000001262335946_p2172101124018">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row141721311104011"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.14.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p6173131111405">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li5173181110406"><strong id="dli_08_0429__en-us_topic_0000001262335946_b91733117408">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul14173101118408"><li id="dli_08_0429__en-us_topic_0000001262335946_li11735118408">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen14173141115400">SELECT
|
|
<strong id="dli_08_0429__en-us_topic_0000001262335946_b26071342171910">QUARTER</strong>(DATE '1997-04-25' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li617371154010">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table917361164011" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p15173161104016">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p16173121119403">2</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section838818144523"><a name="dli_08_0429__en-us_topic_0000001262335946_section838818144523"></a><a name="en-us_topic_0000001262335946_section838818144523"></a><h4 class="sectiontitle">MONTH</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1438811145526"><li id="dli_08_0429__en-us_topic_0000001262335946_li1638811147526"><strong id="dli_08_0429__en-us_topic_0000001262335946_b838810142526">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p47331657122213">Returns the month of a year (an integer between 1 and 12) from a SQL date date. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b769711442117">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li8388314185218"><strong id="dli_08_0429__en-us_topic_0000001262335946_b43881914205214">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen14388121465216">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b171021729132311">MONTH</strong>(date)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li15388121455214"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1838871405216">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table163898146525" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1838941412526">Data Types</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_0429__en-us_topic_0000001262335946_p2389131410529">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row9389614165217"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.15.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p103891914175210">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li12389131412522"><strong id="dli_08_0429__en-us_topic_0000001262335946_b9389111418523">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul9389111465216"><li id="dli_08_0429__en-us_topic_0000001262335946_li4389161415211">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen19389111465220">SELECT
|
|
MONTH(DATE '1997-04-25' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li738917148523">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table1338961419522" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1438971411529">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p113891814145220">4</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section08692035515"><a name="dli_08_0429__en-us_topic_0000001262335946_section08692035515"></a><a name="en-us_topic_0000001262335946_section08692035515"></a><h4 class="sectiontitle">WEEK</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul178709045513"><li id="dli_08_0429__en-us_topic_0000001262335946_li158701408557"><strong id="dli_08_0429__en-us_topic_0000001262335946_b158709025510">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p158701401550">Returns the week of a year from a SQL date date. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b403818714495">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1587080135515"><strong id="dli_08_0429__en-us_topic_0000001262335946_b15870110125515">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen208701303559">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b1168717109248">WEEK</strong>(date)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li138701500556"><strong id="dli_08_0429__en-us_topic_0000001262335946_b2870100195519">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table3870801556" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p787013065515">Data Types</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_0429__en-us_topic_0000001262335946_p5870120145513">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row1187014018557"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.16.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p587017075514">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li118701602556"><strong id="dli_08_0429__en-us_topic_0000001262335946_b15870100165513">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul10870705557"><li id="dli_08_0429__en-us_topic_0000001262335946_li08711000551">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen118711408551">SELECT
|
|
WEEK(DATE '1997-04-25' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li168713012554">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table087170175517" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p4871303554">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p158718065518">17</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section35952273562"><a name="dli_08_0429__en-us_topic_0000001262335946_section35952273562"></a><a name="en-us_topic_0000001262335946_section35952273562"></a><h4 class="sectiontitle">DAYOFYEAR</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul10595192735618"><li id="dli_08_0429__en-us_topic_0000001262335946_li159542745619"><strong id="dli_08_0429__en-us_topic_0000001262335946_b859518274568">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p781110132250">Returns the day of a year (an integer between 1 and 366) from SQL date date. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b4121053294495">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li45951827145617"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1459582719564">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen13595102711561">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b126851541162514">DAYOFYEAR</strong>(date)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li165959272560"><strong id="dli_08_0429__en-us_topic_0000001262335946_b2595127135610">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table4595122785617" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p135961727155619">Data Types</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_0429__en-us_topic_0000001262335946_p559622715614">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row0596182735620"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.17.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p459602725618">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li15596122785617"><strong id="dli_08_0429__en-us_topic_0000001262335946_b7596152725614">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul0596142717564"><li id="dli_08_0429__en-us_topic_0000001262335946_li15596327155619">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen5596162735615">SELECT
|
|
DAYOFYEAR(DATE '1997-04-25' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li13596827135616">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table759642711564" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1159612275561">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p16596202775617">115</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section89188327592"><a name="dli_08_0429__en-us_topic_0000001262335946_section89188327592"></a><a name="en-us_topic_0000001262335946_section89188327592"></a><h4 class="sectiontitle">DAYOFMONTH</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul791873212596"><li id="dli_08_0429__en-us_topic_0000001262335946_li991823275911"><strong id="dli_08_0429__en-us_topic_0000001262335946_b11918232145917">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p7918732195910">Returns the day of a month (an integer between 1 and 31) from a SQL date date. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b5189429974495">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li169181532155916"><strong id="dli_08_0429__en-us_topic_0000001262335946_b7918232195910">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen19918332135916">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b555142214261">DAYOFMONTH</strong>(date)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li791919327596"><strong id="dli_08_0429__en-us_topic_0000001262335946_b29191432205911">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table4919153217591" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p149191132145918">Data Types</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_0429__en-us_topic_0000001262335946_p16919432175915">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row5919163215596"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.18.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p191993295913">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li139191732145914"><strong id="dli_08_0429__en-us_topic_0000001262335946_b39197323594">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul6919143214594"><li id="dli_08_0429__en-us_topic_0000001262335946_li10919632175912">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1919123265919">SELECT
|
|
DAYOFMONTH(DATE '1997-04-25' ) AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li99198323597">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table6919163212593" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1591973285920">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p8920173211596">25</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section152759367121"><a name="dli_08_0429__en-us_topic_0000001262335946_section152759367121"></a><a name="en-us_topic_0000001262335946_section152759367121"></a><h4 class="sectiontitle">DAYOFWEEK</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul15275183621220"><li id="dli_08_0429__en-us_topic_0000001262335946_li42751136171212"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1327513621216">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p71006464268">Returns the day of a week (an integer between 1 and 7) from a SQL date date. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b5795739984495">BIGINT</strong> type.</p>
|
|
<div class="note" id="dli_08_0429__en-us_topic_0000001262335946_note2414151182612"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dli_08_0429__en-us_topic_0000001262335946_p10275836161219">Note that the start day of a week is Sunday. </p>
|
|
</div></div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li11275536181219"><strong id="dli_08_0429__en-us_topic_0000001262335946_b15275163615128">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen927518364127">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b2385149102714">DAYOFWEEK</strong>(date)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li42752036161210"><strong id="dli_08_0429__en-us_topic_0000001262335946_b7275143616125">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table127516362121" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p727573612120">Data Types</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_0429__en-us_topic_0000001262335946_p0275436101214">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row1927513363125"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.19.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p52764369127">SQL date</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li8276153618123"><strong id="dli_08_0429__en-us_topic_0000001262335946_b9276133612125">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul2027623681212"><li id="dli_08_0429__en-us_topic_0000001262335946_li9276183661216">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen122764364127">SELECT
|
|
DAYOFWEEK(DATE '1997-04-25') AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li52761636181220">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table4276103621216" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p17276143617120">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1427613361129">6</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section34301613121413"><a name="dli_08_0429__en-us_topic_0000001262335946_section34301613121413"></a><a name="en-us_topic_0000001262335946_section34301613121413"></a><h4 class="sectiontitle">HOUR</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul144308137147"><li id="dli_08_0429__en-us_topic_0000001262335946_li1043041313143"><strong id="dli_08_0429__en-us_topic_0000001262335946_b043041316141">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p4430151301411">Returns the hour of a day (an integer between 0 and 23) from SQL timestamp timestamp. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b16444222174495">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1143071371414"><strong id="dli_08_0429__en-us_topic_0000001262335946_b543041314140">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen184300133145">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b17823427288">HOUR</strong>(timestamp)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li2430181310148"><strong id="dli_08_0429__en-us_topic_0000001262335946_b194311013141415">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table17431201321418" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p16431713201418">Data Types</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_0429__en-us_topic_0000001262335946_p11431101319149">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row18431101312145"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.20.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1443181315145">SQL timestamp</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li19431101361412"><strong id="dli_08_0429__en-us_topic_0000001262335946_b13431181391418">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1243131381410"><li id="dli_08_0429__en-us_topic_0000001262335946_li043131314146">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen94311413111420">SELECT
|
|
HOUR(TIMESTAMP '1997-04-25 10:11:12') AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1431191331415">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table9431913171415" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p9432713131412">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p13432121341420">10</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section17296191222215"><a name="dli_08_0429__en-us_topic_0000001262335946_section17296191222215"></a><a name="en-us_topic_0000001262335946_section17296191222215"></a><h4 class="sectiontitle">MINUTE</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul9296171210226"><li id="dli_08_0429__en-us_topic_0000001262335946_li1329614128226"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1829618128222">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_b20016362474495">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li729615122220"><strong id="dli_08_0429__en-us_topic_0000001262335946_b42961412192214">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen12971412152217">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b992111134301">MINUTE</strong>(timestamp)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1629771222214"><strong id="dli_08_0429__en-us_topic_0000001262335946_b4297191210227">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table1429712128221" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p2029712124225">Data Types</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_0429__en-us_topic_0000001262335946_p102971312162212">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row102971712122217"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.21.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p10297912102218">SQL timestamp</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li32971112132218"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1229741222216">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul182971612102213"><li id="dli_08_0429__en-us_topic_0000001262335946_li8297111212229">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen4297112152219">SELECT
|
|
MINUTE(TIMESTAMP '1997-04-25 10:11:12') AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1297012202214">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table1029812123222" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p122983125225">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p112980123223">11</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section125214317232"><a name="dli_08_0429__en-us_topic_0000001262335946_section125214317232"></a><a name="en-us_topic_0000001262335946_section125214317232"></a><h4 class="sectiontitle">SECOND</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul17252183117235"><li id="dli_08_0429__en-us_topic_0000001262335946_li202525315237"><strong id="dli_08_0429__en-us_topic_0000001262335946_b14252183162310">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_b4815084204495">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li162521131122319"><strong id="dli_08_0429__en-us_topic_0000001262335946_b13252153118238">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen7252163112238">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b17800193393018">SECOND</strong>(timestamp)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li192521831162319"><strong id="dli_08_0429__en-us_topic_0000001262335946_b4252153112319">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table12252133172316" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p6252431172319">Data Types</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_0429__en-us_topic_0000001262335946_p1125373112320">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row12531631162319"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.22.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p4253031132310">SQL timestamp</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li10253193142315"><strong id="dli_08_0429__en-us_topic_0000001262335946_b325333117235">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul15253163112238"><li id="dli_08_0429__en-us_topic_0000001262335946_li10253133110234">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen725333112320">SELECT
|
|
SECOND(TIMESTAMP '1997-04-25 10:11:12') AS `result`
|
|
FROM
|
|
testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li9253123118236">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table152531331182314" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p17253143162312">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p625320315238">12</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section114922047182416"><a name="dli_08_0429__en-us_topic_0000001262335946_section114922047182416"></a><a name="en-us_topic_0000001262335946_section114922047182416"></a><h4 class="sectiontitle">FLOOR</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul749264710241"><li id="dli_08_0429__en-us_topic_0000001262335946_li6492164772418"><strong id="dli_08_0429__en-us_topic_0000001262335946_b15492847142413">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p14492747132415">Returns a value that rounds <strong id="dli_08_0429__en-us_topic_0000001262335946_b13520027654495">timepoint</strong> down to the time unit <strong id="dli_08_0429__en-us_topic_0000001262335946_b13566497414495">timeintervalunit</strong>.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li6492144722417"><strong id="dli_08_0429__en-us_topic_0000001262335946_b5492204722412">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen8492547172416">TIME/TIMESTAMP(3) <strong id="dli_08_0429__en-us_topic_0000001262335946_b2083175443016">FLOOR</strong>(timepoint <strong id="dli_08_0429__en-us_topic_0000001262335946_b4801458173010">TO </strong>timeintervalunit)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1149254752411"><strong id="dli_08_0429__en-us_topic_0000001262335946_b11492447122415">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table3492154742419" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p449324710241">Data Types</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_0429__en-us_topic_0000001262335946_p2049334762420">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row144932047162415"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.23.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p174931547162413">SQL time or SQL timestamp</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row842517722710"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.23.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p3425127182716">Time unit. The value can be <strong id="dli_08_0429__en-us_topic_0000001262335946_b17599935794495">YEAR</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b17091290944495">QUARTER</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b7387599174495">MONTH</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b8975771304495">WEEK</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b17404971284495">DAY</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b20732156364495">DOY</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b3327628714495">HOUR</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b15082348874495">MINUTE</strong>, or <strong id="dli_08_0429__en-us_topic_0000001262335946_b13647114114495">SECOND</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li124937471247"><strong id="dli_08_0429__en-us_topic_0000001262335946_b6493147192415">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul349364714249"><li id="dli_08_0429__en-us_topic_0000001262335946_li12493114717246">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen14493114720246">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`
|
|
FROM testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li249316478241">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table877311711558" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_row1477216717553"><th align="left" class="cellrowborder" valign="top" width="20.18%" id="mcps1.3.23.2.4.2.2.1.1.4.1.1"><p id="dli_08_0429__en-us_topic_0000001262335946_p57721715558">message</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="27.439999999999998%" id="mcps1.3.23.2.4.2.2.1.1.4.1.2"><p id="dli_08_0429__en-us_topic_0000001262335946_p15772157155516">message2</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="52.38%" id="mcps1.3.23.2.4.2.2.1.1.4.1.3"><p id="dli_08_0429__en-us_topic_0000001262335946_p2853124110559">message3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row2773177175511"><td class="cellrowborder" valign="top" width="20.18%" headers="mcps1.3.23.2.4.2.2.1.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_p4772117195517">13:14</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.439999999999998%" headers="mcps1.3.23.2.4.2.2.1.1.4.1.2 "><p id="dli_08_0429__en-us_topic_0000001262335946_p1977213735513">13:14</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="52.38%" headers="mcps1.3.23.2.4.2.2.1.1.4.1.3 "><p id="dli_08_0429__en-us_topic_0000001262335946_p16853154119552">1997-04-25T13:14</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section345282814439"><a name="dli_08_0429__en-us_topic_0000001262335946_section345282814439"></a><a name="en-us_topic_0000001262335946_section345282814439"></a><h4 class="sectiontitle">CEIL</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1645212815437"><li id="dli_08_0429__en-us_topic_0000001262335946_li3452828154313"><strong id="dli_08_0429__en-us_topic_0000001262335946_b64531328114318">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p164531828164311">Returns a value that rounds <strong id="dli_08_0429__en-us_topic_0000001262335946_b9630123034495">timepoint</strong> up to the time unit <strong id="dli_08_0429__en-us_topic_0000001262335946_b8793513034495">timeintervalunit</strong>.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li144539283433"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1453102894318">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen54538284439">TIME/TIMESTAMP(3) <strong id="dli_08_0429__en-us_topic_0000001262335946_b119671548380">CEIL</strong>(timepoint <strong id="dli_08_0429__en-us_topic_0000001262335946_b20635271388">TO </strong>timeintervalunit)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li94537284433"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1045342814310">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table1445362814316" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p11453112894312">Data Types</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_0429__en-us_topic_0000001262335946_p13453162854317">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row17453728194315"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.24.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p245312283435">SQL time or SQL timestamp</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row7453328184312"><td class="cellrowborder" valign="top" width="23.54235423542354%" headers="mcps1.3.24.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p3454182818435">Time unit. The value can be <strong id="dli_08_0429__en-us_topic_0000001262335946_b3594005904495">YEAR</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b14209291474495">QUARTER</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b2034812764495">MONTH</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b2397364584495">WEEK</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b20798002494495">DAY</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b5765014524495">DOY</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b7037642834495">HOUR</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b20102663134495">MINUTE</strong>, or <strong id="dli_08_0429__en-us_topic_0000001262335946_b8930543294495">SECOND</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li15454132864312"><strong id="dli_08_0429__en-us_topic_0000001262335946_b345410285436">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul2454328134312"><li id="dli_08_0429__en-us_topic_0000001262335946_li4454728124318">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1345415283430">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`
|
|
FROM testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li18454192814436">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table44547282432" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p85611581625">result3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p3561185818216">1997-04-25T13:15</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section132721624154711"><a name="dli_08_0429__en-us_topic_0000001262335946_section132721624154711"></a><a name="en-us_topic_0000001262335946_section132721624154711"></a><h4 class="sectiontitle">OVERLAPS</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul19272162412472"><li id="dli_08_0429__en-us_topic_0000001262335946_li1272152414471"><strong id="dli_08_0429__en-us_topic_0000001262335946_b32721424204711">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p185715194817">Returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b2986278444495">TRUE</strong> if two time intervals overlap; returns <strong id="dli_08_0429__en-us_topic_0000001262335946_b8761051724495">FALSE</strong> otherwise.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li627220245477"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1272224114712">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1272824134713">BOOLEAN (timepoint1, temporal1) <strong id="dli_08_0429__en-us_topic_0000001262335946_b1491953917612">OVERLAPS </strong>(timepoint2, temporal2)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li14272124154716"><strong id="dli_08_0429__en-us_topic_0000001262335946_b62721524184718">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table5272112419472" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1427322410479">Data Types</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_0429__en-us_topic_0000001262335946_p1127319247479">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row1727382415473"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.25.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p927317240472">Time point</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row027372414713"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.25.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p8273142418470">Time point or interval</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="note" id="dli_08_0429__en-us_topic_0000001262335946_note762811581144"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dli_08_0429__en-us_topic_0000001262335946_ul78071732353"><li id="dli_08_0429__en-us_topic_0000001262335946_li511113614514"><strong id="dli_08_0429__en-us_topic_0000001262335946_b11765176684495">(timepoint, temporal)</strong> is a closed interval.</li><li id="dli_08_0429__en-us_topic_0000001262335946_li780717327511">The temporal can be of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b2840907834495">DATE</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b8761735514495">TIME</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b11285655374495">TIMESTAMP</strong>, or <strong id="dli_08_0429__en-us_topic_0000001262335946_b9248710764495">INTERVAL</strong> type.<ul id="dli_08_0429__en-us_topic_0000001262335946_ul96231054175211"><li id="dli_08_0429__en-us_topic_0000001262335946_li6623185411527">When th temporal is <strong id="dli_08_0429__en-us_topic_0000001262335946_b6510986484495">DATE</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b11291510194495">TIME</strong>, or <strong id="dli_08_0429__en-us_topic_0000001262335946_b7803068234495">TIMESTAMP</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b20350482844495">(timepoint, temporal)</strong> indicates an interval between <strong id="dli_08_0429__en-us_topic_0000001262335946_b6796995434495">timepoint</strong> and <strong id="dli_08_0429__en-us_topic_0000001262335946_b36616464495">temporal</strong>. The temporal can be earlier than the value of <strong id="dli_08_0429__en-us_topic_0000001262335946_b17776364714495">timepoint</strong>, for example, <strong id="dli_08_0429__en-us_topic_0000001262335946_b11919734854495">(DATE '1997-04-25', DATE '1997-04-23')</strong>.</li><li id="dli_08_0429__en-us_topic_0000001262335946_li926405895213">When the temporal is <strong id="dli_08_0429__en-us_topic_0000001262335946_b1059615964495">INTERVAL</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b179946664495">(timepoint, temporal)</strong> indicates an interval between <strong id="dli_08_0429__en-us_topic_0000001262335946_b6325050004495">timepoint</strong> and <strong id="dli_08_0429__en-us_topic_0000001262335946_b18207708764495">timepoint + temporal</strong>.</li></ul>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li15129184012514">Ensure that <strong id="dli_08_0429__en-us_topic_0000001262335946_b5466964024495">(timepoint1, temporal1)</strong> and <strong id="dli_08_0429__en-us_topic_0000001262335946_b21334451784495">(timepoint2, temporal2)</strong> are intervals of the same data type.</li></ul>
|
|
</div></div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li727352484711"><strong id="dli_08_0429__en-us_topic_0000001262335946_b627382464711">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul227302414475"><li id="dli_08_0429__en-us_topic_0000001262335946_li17273624174717">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_li1827310242474">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table152731424124711" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1863120421918">result7</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p10631842315">true</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section98557160415"><a name="dli_08_0429__en-us_topic_0000001262335946_section98557160415"></a><a name="en-us_topic_0000001262335946_section98557160415"></a><h4 class="sectiontitle">DATE_FORMAT</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul185516162041"><li id="dli_08_0429__en-us_topic_0000001262335946_li19855181615414"><strong id="dli_08_0429__en-us_topic_0000001262335946_b38556169418">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p57420541348">Converts a timestamp to a value of string in the format specified by the date format string.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li885714161249"><strong id="dli_08_0429__en-us_topic_0000001262335946_b785714161943">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen168571166410">STRING <strong id="dli_08_0429__en-us_topic_0000001262335946_b8832236397">DATE_FORMAT</strong>(timestamp, dateformat)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li385813162046"><strong id="dli_08_0429__en-us_topic_0000001262335946_b138600167410">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table586151617413" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p18863616347">Data Types</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_0429__en-us_topic_0000001262335946_p8864316742">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row986411614411"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.26.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p386516167410">Time point</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row1186513161041"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.26.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p78660160411">String in the date format</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li0866616246"><strong id="dli_08_0429__en-us_topic_0000001262335946_b18675161742">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul10867131615419"><li id="dli_08_0429__en-us_topic_0000001262335946_li138679165416">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_li15868171613419">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table15869016241" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p17871416947">result4</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p188734162417">1997-04-25</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section105601517203220"><a name="dli_08_0429__en-us_topic_0000001262335946_section105601517203220"></a><a name="en-us_topic_0000001262335946_section105601517203220"></a><h4 class="sectiontitle">TIMESTAMPADD</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul19561417193211"><li id="dli_08_0429__en-us_topic_0000001262335946_li165611417183217"><strong id="dli_08_0429__en-us_topic_0000001262335946_b13561131733216">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p6332144511618">Returns the date and time by combining <strong id="dli_08_0429__en-us_topic_0000001262335946_b2631026584495">interval</strong> and <strong id="dli_08_0429__en-us_topic_0000001262335946_b17494746314495">timeintervalunit</strong> and adding the combination to <strong id="dli_08_0429__en-us_topic_0000001262335946_b19576640204495">timepoint</strong>.</p>
|
|
<div class="note" id="dli_08_0429__en-us_topic_0000001262335946_note16429629101812"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dli_08_0429__en-us_topic_0000001262335946_p12546131901919">The return value of <strong id="dli_08_0429__en-us_topic_0000001262335946_b18134077574495">TIMESTAMPADD</strong> is the value of <strong id="dli_08_0429__en-us_topic_0000001262335946_b1752060464495">timepoint</strong>. An exception is that if the input <strong id="dli_08_0429__en-us_topic_0000001262335946_b7548809564495">timepoint </strong>is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b18355944464495">TIMESTAMP</strong> type, the return value can be inserted into a table field of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b3235825374495">DATE</strong> type.</p>
|
|
</div></div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li456181763213"><strong id="dli_08_0429__en-us_topic_0000001262335946_b856117170322">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1856181711320">TIMESTAMP(3)/DATE/TIME <strong id="dli_08_0429__en-us_topic_0000001262335946_b44289614160">TIMESTAMPADD</strong>(timeintervalunit, interval, timepoint)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li185615174324"><strong id="dli_08_0429__en-us_topic_0000001262335946_b15561191718324">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table20561181723219" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1556181793219">Data Types</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_0429__en-us_topic_0000001262335946_p056171720328">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row16561917193216"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.27.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1456211175328">Time unit.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row356231753214"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.27.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p65621917153211">Interval</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row194001519123517"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.27.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p164018198356">Time point</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1756241715323"><strong id="dli_08_0429__en-us_topic_0000001262335946_b756281716327">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul9562141716326"><li id="dli_08_0429__en-us_topic_0000001262335946_li756201783211">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_li195621817163211">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table14562171713215" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p105633178320">result3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_ul55011211182515"><li id="dli_08_0429__en-us_topic_0000001262335946_li1250114116251">If this field is inserted into a table field of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b9052214344495">TIMESTAMP</strong> type, <strong id="dli_08_0429__en-us_topic_0000001262335946_b6814731914495">1997-07-25T10:11:12</strong> is returned.</li></ul>
|
|
<ul id="dli_08_0429__en-us_topic_0000001262335946_ul14169152116252"><li id="dli_08_0429__en-us_topic_0000001262335946_li41697212251">If this field is inserted into a table field of the TIMESTAMP type, 1997-07-25 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_0429__en-us_topic_0000001262335946_p956351793215">10:11:14</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section16290114810404"><a name="dli_08_0429__en-us_topic_0000001262335946_section16290114810404"></a><a name="en-us_topic_0000001262335946_section16290114810404"></a><h4 class="sectiontitle">TIMESTAMPDIFF</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1729084813409"><li id="dli_08_0429__en-us_topic_0000001262335946_li2029074854013"><strong id="dli_08_0429__en-us_topic_0000001262335946_b122911748194013">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p10292141522610">Returns the (signed) number of <strong id="dli_08_0429__en-us_topic_0000001262335946_b19164915244495">timepointunit</strong> between <strong id="dli_08_0429__en-us_topic_0000001262335946_b17631402314495">timepoint1</strong> and <strong id="dli_08_0429__en-us_topic_0000001262335946_b16565937464495">timepoint2</strong>. The unit for the interval is given by the first argument.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1829115485409"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1429114483409">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen20291174810408">INT <strong id="dli_08_0429__en-us_topic_0000001262335946_b12975163612917">TIMESTAMPDIFF</strong>(timepointunit, timepoint1, timepoint2)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li5291124820404"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1429124811404">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table529164817400" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p6291194815400">Data Types</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_0429__en-us_topic_0000001262335946_p829154811407">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row19291194818401"><td class="cellrowborder" valign="top" width="22.65226522652265%" headers="mcps1.3.28.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p6291104814404">Time unit. The value can be <strong id="dli_08_0429__en-us_topic_0000001262335946_b1737734514495">SECOND</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b11827348304495">MINUTE</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b18463161884495">HOUR</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b18422197734495">DAY</strong>, <strong id="dli_08_0429__en-us_topic_0000001262335946_b9955578934495">MONTH </strong>or <strong id="dli_08_0429__en-us_topic_0000001262335946_b981639444495">YEAR</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row929224815401"><td class="cellrowborder" valign="top" width="22.65226522652265%" headers="mcps1.3.28.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1429215480403">Time point</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li13292154818407"><strong id="dli_08_0429__en-us_topic_0000001262335946_b16292164816409">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul7292104813406"><li id="dli_08_0429__en-us_topic_0000001262335946_li929214486409">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_li1029218488406">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table14292748144018" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p429304818408">result3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p192931348144010">-2</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section1698193003115"><a name="dli_08_0429__en-us_topic_0000001262335946_section1698193003115"></a><a name="en-us_topic_0000001262335946_section1698193003115"></a><h4 class="sectiontitle">CONVERT_TZ</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1569923013314"><li id="dli_08_0429__en-us_topic_0000001262335946_li11699123013113"><strong id="dli_08_0429__en-us_topic_0000001262335946_b96991630183110">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p7699103017311">Converts a datetime<strong id="dli_08_0429__en-us_topic_0000001262335946_b16826032104495"> string1</strong> (with default ISO timestamp format <strong id="dli_08_0429__en-us_topic_0000001262335946_b14305350814495">'yyyy-MM-dd HH:mm:ss'</strong>) from time zone <strong id="dli_08_0429__en-us_topic_0000001262335946_b6092046424495">string2</strong> to time zone <strong id="dli_08_0429__en-us_topic_0000001262335946_b17475893234495">string3</strong>.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li126991130183112"><strong id="dli_08_0429__en-us_topic_0000001262335946_b76991730183113">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen19699183063112">STRING <strong id="dli_08_0429__en-us_topic_0000001262335946_b14518182153116">CONVERT_TZ</strong>(string1, string2, string3)</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li196997302317"><strong id="dli_08_0429__en-us_topic_0000001262335946_b969913308314">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table106991730123112" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p569920302317">Data Types</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_0429__en-us_topic_0000001262335946_p106991330163115">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row15699103073116"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.29.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1170033017311">SQL timestamp. If the value does not meet the format requirements, <strong id="dli_08_0429__en-us_topic_0000001262335946_b18853287634495">NULL</strong> is returned.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row1700133015313"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.29.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p17700193043114">Time zone before conversion. The format of time zone should be either an abbreviation such as <strong id="dli_08_0429__en-us_topic_0000001262335946_b6379059704495">PST</strong>, a full name such as <strong id="dli_08_0429__en-us_topic_0000001262335946_b13075558424495">America/Los_Angeles</strong>, or a custom ID such as <strong id="dli_08_0429__en-us_topic_0000001262335946_b4592168364495">GMT-08:00</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row1993420401324"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.29.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p10472144514324">Time zone after conversion. The format of time zone should be either an abbreviation such as <strong id="dli_08_0429__en-us_topic_0000001262335946_b10674835254495">PST</strong>, a full name such as <strong id="dli_08_0429__en-us_topic_0000001262335946_b1662505354495">America/Los_Angeles</strong>, or a custom ID such as <strong id="dli_08_0429__en-us_topic_0000001262335946_b15833514664495">GMT-08:00</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li8700113013114"><strong id="dli_08_0429__en-us_topic_0000001262335946_b370011303316">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul2700183093118"><li id="dli_08_0429__en-us_topic_0000001262335946_li1700113014315">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_li127001630173113">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table14700183015315" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p9701183043119">result2</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1770111309310">1997-04-25 02:00:00</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section01032914372"><a name="dli_08_0429__en-us_topic_0000001262335946_section01032914372"></a><a name="en-us_topic_0000001262335946_section01032914372"></a><h4 class="sectiontitle">FROM_UNIXTIME</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1510311923717"><li id="dli_08_0429__en-us_topic_0000001262335946_li1210311916377"><strong id="dli_08_0429__en-us_topic_0000001262335946_b910339123715">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p111037913711">Returns a representation of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b5138549274495">numeric</strong> argument as a value in string format.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li910315920371"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1910314933719">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1710318973714">STRING <strong id="dli_08_0429__en-us_topic_0000001262335946_b202669973418">FROM_UNIXTIME</strong>(numeric[, string])</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li81038983710"><strong id="dli_08_0429__en-us_topic_0000001262335946_b11103139103710">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table91031893377" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p7103109183716">Data Types</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_0429__en-us_topic_0000001262335946_p21041596374">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row1010416913371"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.30.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_b12354912404495">UNIX_TIMESTAMP()</strong> function.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row810411916372"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.30.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1910419183713">Time. If this parameter is not specified, the default time format is <strong id="dli_08_0429__en-us_topic_0000001262335946_b4044523654495">yyyy-MM-dd HH:mm:ss</strong> format.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li61043923715"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1104139103719">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul121045973717"><li id="dli_08_0429__en-us_topic_0000001262335946_li210439143714">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1010589103716">SELECT
|
|
FROM_UNIXTIME(44) AS `result`,
|
|
FROM_UNIXTIME(44, 'yyyy:MM:dd') AS `result2`
|
|
FROM testtable;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li3105199153710">Test Result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table16105496379" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1610514953719">result2</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p171051399378">1970:01:01</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section166571146145016"><a name="dli_08_0429__en-us_topic_0000001262335946_section166571146145016"></a><a name="en-us_topic_0000001262335946_section166571146145016"></a><h4 class="sectiontitle">UNIX_TIMESTAMP</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1565814665017"><li id="dli_08_0429__en-us_topic_0000001262335946_li19658846195016"><strong id="dli_08_0429__en-us_topic_0000001262335946_b146581346125012">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p1165813468507">Gets current Unix timestamp in seconds. The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b8531927684495">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li265810461501"><strong id="dli_08_0429__en-us_topic_0000001262335946_b9658546125012">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1658164645020">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b14595191254011">UNIX_TIMESTAMP</strong>()</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li965864615503"><strong id="dli_08_0429__en-us_topic_0000001262335946_b56581446185013">Input parameters</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p481774245115">None</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1765904625012"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1965924611507">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul13659164614509"><li id="dli_08_0429__en-us_topic_0000001262335946_li106591746185012">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1665964615509">SELECT
|
|
UNIX_TIMESTAMP() AS `result`
|
|
FROM
|
|
table;</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1565974611508">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table17659134614502" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1166074695013">result</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1366010461502">1635401982</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section175599271533"><a name="dli_08_0429__en-us_topic_0000001262335946_section175599271533"></a><a name="en-us_topic_0000001262335946_section175599271533"></a><h4 class="sectiontitle">UNIX_TIMESTAMP(string1[, string2])</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1955915279316"><li id="dli_08_0429__en-us_topic_0000001262335946_li195591227936"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1555915277314">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p1955912720316">Converts date time <strong id="dli_08_0429__en-us_topic_0000001262335946_b13931170594495">string1</strong> in format <strong id="dli_08_0429__en-us_topic_0000001262335946_b21044409934495">string2</strong> to Unix timestamp (in seconds). The return value is of the <strong id="dli_08_0429__en-us_topic_0000001262335946_b15862237534495">BIGINT</strong> type.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li555942710316"><strong id="dli_08_0429__en-us_topic_0000001262335946_b165594272318">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen1356019271239">BIGINT <strong id="dli_08_0429__en-us_topic_0000001262335946_b10746144164110">UNIX_TIMESTAMP</strong>(string1[, string2])</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1656020272313"><strong id="dli_08_0429__en-us_topic_0000001262335946_b2056018272034">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table1697682813211" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p097619288322">Data Types</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_0429__en-us_topic_0000001262335946_p12976428163216">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row179761228133212"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.32.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p169764281324">SQL timestamp string. An error is reported if the value does not comply with the <strong id="dli_08_0429__en-us_topic_0000001262335946_b15016256284495">string2</strong> format.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row5976628153212"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.32.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p13977172873220">Time. If this parameter is not specified, the default time format is <strong id="dli_08_0429__en-us_topic_0000001262335946_b18019713974495">yyyy-MM-dd HH:mm:ss</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1556015275318"><strong id="dli_08_0429__en-us_topic_0000001262335946_b45601271738">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul1156017270317"><li id="dli_08_0429__en-us_topic_0000001262335946_li125603271037">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_li256011271430">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table10560627636" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p59761811354">result3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p997618813514">861897600</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section1871816161526"><a name="dli_08_0429__en-us_topic_0000001262335946_section1871816161526"></a><a name="en-us_topic_0000001262335946_section1871816161526"></a><h4 class="sectiontitle">TO_DATE</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul97184166529"><li id="dli_08_0429__en-us_topic_0000001262335946_li9718016165211"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1271831645214">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p1871812161524">Converts a date <strong id="dli_08_0429__en-us_topic_0000001262335946_b19314930864495">string1</strong> with format <strong id="dli_08_0429__en-us_topic_0000001262335946_b3664285244495">string2</strong> to a date.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li471811617525"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1871817161525">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen187181316135217">DATE <strong id="dli_08_0429__en-us_topic_0000001262335946_b382512684516">TO_DATE</strong>(string1[, string2])</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li10718916155219"><strong id="dli_08_0429__en-us_topic_0000001262335946_b7718816135212">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table1171813164529" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1371819160522">Data Types</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_0429__en-us_topic_0000001262335946_p6719101618526">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row27194160527"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.33.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p3719121605214">SQL timestamp string. If the value is not in the required format, an error is reported.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row371917169526"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.33.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p2719816135218">Format. If this parameter is not specified, the default time format is <strong id="dli_08_0429__en-us_topic_0000001262335946_b6648715524495">yyyy-MM-dd</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li571913166524"><strong id="dli_08_0429__en-us_topic_0000001262335946_b871915167528">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul8719516195219"><li id="dli_08_0429__en-us_topic_0000001262335946_li071917163528">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_li167204169524">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table3720116195214" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p472061615217">result3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p872071616527">1997-04-25</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="dli_08_0429__en-us_topic_0000001262335946_section1374114020551"><a name="dli_08_0429__en-us_topic_0000001262335946_section1374114020551"></a><a name="en-us_topic_0000001262335946_section1374114020551"></a><h4 class="sectiontitle">TO_TIMESTAMP</h4><ul id="dli_08_0429__en-us_topic_0000001262335946_ul637410405551"><li id="dli_08_0429__en-us_topic_0000001262335946_li12374114014558"><strong id="dli_08_0429__en-us_topic_0000001262335946_b16374340105513">Function</strong><p id="dli_08_0429__en-us_topic_0000001262335946_p18313720144911">Converts date time <strong id="dli_08_0429__en-us_topic_0000001262335946_b15929791574495">string1</strong> with format <strong id="dli_08_0429__en-us_topic_0000001262335946_b17363039664495">string2</strong> to a timestamp.</p>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li20374740155520"><strong id="dli_08_0429__en-us_topic_0000001262335946_b1237514017556">Description</strong><pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_screen18375144075516">TIMESTAMP <strong id="dli_08_0429__en-us_topic_0000001262335946_b8855713205019">TO_TIMESTAMP</strong>(string1[, string2])</pre>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li43759408556"><strong id="dli_08_0429__en-us_topic_0000001262335946_b3375104020552">Input parameters</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table15375040115511" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p6375440205511">Data Types</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_0429__en-us_topic_0000001262335946_p1637584025518">Parameters</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_row137554045517"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.34.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p9375940155510">SQL timestamp string. If the value is not in the required format, <strong id="dli_08_0429__en-us_topic_0000001262335946_b20783308134495">NULL</strong> is returned.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0429__en-us_topic_0000001262335946_row537564019551"><td class="cellrowborder" valign="top" width="22.132213221322132%" headers="mcps1.3.34.2.3.2.1.4.1.1 "><p id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p1837684075519">Date format. If this parameter is not specified, the default format is <strong id="dli_08_0429__en-us_topic_0000001262335946_b6181699374495">yyyy-MM-dd HH:mm:ss</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0429__en-us_topic_0000001262335946_li1337654019555"><strong id="dli_08_0429__en-us_topic_0000001262335946_b737615407558">Example</strong><ul id="dli_08_0429__en-us_topic_0000001262335946_ul15376134055514"><li id="dli_08_0429__en-us_topic_0000001262335946_li037684075520">Test statement<pre class="screen" id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_li143761940165517">Test result
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0429__en-us_topic_0000001262335946_table1037617406551" frame="border" border="1" rules="all"><thead align="left"><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_p53774408551">result3</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0429__en-us_topic_0000001262335946_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_0426.html">Built-In Functions</a></div>
|
|
</div>
|
|
</div>
|
|
|