vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0014.html
Lu, Huayi e6fa411af0 DWS DEV 830.201 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2024-05-16 07:24:04 +00:00

723 lines
74 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001233510097"></a><a name="EN-US_TOPIC_0000001233510097"></a>
<h1 class="topictitle1">Date/Time Types</h1>
<div id="body8662426"><p id="EN-US_TOPIC_0000001233510097__a314c4bfcb00445b39a0f87cd54ba1cfe"><a href="#EN-US_TOPIC_0000001233510097__te36aedd5ecb747abb055a0d329a83c75">Table 1</a> lists date and time types supported by <span id="EN-US_TOPIC_0000001233510097__text1331508950">GaussDB(DWS)</span>. For the operators and built-in functions of the types, see <a href="dws_06_0035.html">Date and Time Processing Functions and Operators</a>.</p>
<div class="note" id="EN-US_TOPIC_0000001233510097__n858c3d4911ce48499be08024b6eca4cc"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233510097__a46fe6abf76c342f495f285826606672d">If the time format of another database is different from that of <span id="EN-US_TOPIC_0000001233510097__text1846817280">GaussDB(DWS)</span>, modify the value of the <span id="EN-US_TOPIC_0000001233510097__ph858335917203"><strong id="EN-US_TOPIC_0000001233510097__b12744355688">DateStyle</strong></span> parameter to keep them consistent.</p>
</div></div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001233510097__te36aedd5ecb747abb055a0d329a83c75"></a><a name="te36aedd5ecb747abb055a0d329a83c75"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233510097__te36aedd5ecb747abb055a0d329a83c75" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Date/Time Types</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233510097__r0139b9e239924f0087a0ee44729a958a"><th align="left" class="cellrowborder" valign="top" width="27.939999999999998%" id="mcps1.3.3.2.4.1.1"><p id="EN-US_TOPIC_0000001233510097__a9d0ab4ade4f54c48bdaaeb2c54b76a27"><strong id="EN-US_TOPIC_0000001233510097__b84235270691445">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45.79%" id="mcps1.3.3.2.4.1.2"><p id="EN-US_TOPIC_0000001233510097__a02d74cfcee3040729d2ca948717ed838"><strong id="EN-US_TOPIC_0000001233510097__b842352706212013">Description</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="26.27%" id="mcps1.3.3.2.4.1.3"><p id="EN-US_TOPIC_0000001233510097__a51cd9acb70dc4ad59aa35dd70b5843c0"><strong id="EN-US_TOPIC_0000001233510097__b84235270618324">Storage Space</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001233510097__r56b62dad85d24ab7a612d6e0742493f0"><td class="cellrowborder" valign="top" width="27.939999999999998%" headers="mcps1.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__a2988920000614a89b0476756a9384d43">DATE</p>
</td>
<td class="cellrowborder" valign="top" width="45.79%" headers="mcps1.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__ad08ec13ac0574b39a2d1f49fa54c4d87">In Oracle compatibility mode, it is equivalent to timestamp(0) and records the date and time.</p>
<p id="EN-US_TOPIC_0000001233510097__p679545616315">In other modes, it records the date.</p>
</td>
<td class="cellrowborder" valign="top" width="26.27%" headers="mcps1.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__p26251740123413">In Oracle compatibility mode, it occupies 8 bytes.</p>
<p id="EN-US_TOPIC_0000001233510097__a16c86dddb555417a875b7635064e2b27">In Oracle compatibility mode, it occupies 4 bytes.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r48f8be09fca44ecbb0385b513f397af8"><td class="cellrowborder" valign="top" width="27.939999999999998%" headers="mcps1.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__a59be4c93e6364fdba5670d0318d005e9">TIME [(p)] [WITHOUT TIME ZONE]</p>
</td>
<td class="cellrowborder" valign="top" width="45.79%" headers="mcps1.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__a9a7dbc7f8e7640bd8ca8e7af055891ec">Specifies time within one day.</p>
<p id="EN-US_TOPIC_0000001233510097__acbc47155fd8c4fd0b536f2857d4baed7"><strong id="EN-US_TOPIC_0000001233510097__b842352706104641">p</strong> indicates the precision after the decimal point. The value ranges from 0 to 6.</p>
</td>
<td class="cellrowborder" valign="top" width="26.27%" headers="mcps1.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__a3ca19c2ac91a47698cee9bb2585ee18f">8 bytes</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__rcf39c5b859ab4d1bb3b3f5b647e58662"><td class="cellrowborder" valign="top" width="27.939999999999998%" headers="mcps1.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__aa07f5acd845949f9919e2ad6101f670c">TIME [(p)] [WITH TIME ZONE]</p>
</td>
<td class="cellrowborder" valign="top" width="45.79%" headers="mcps1.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__a4b4db98f9f14498f8d1326415de6c9bf">Specifies time within one day (with time zone).</p>
<p id="EN-US_TOPIC_0000001233510097__aecf7b91a0e0a4fa8ac88d1459b2e7dca"><strong id="EN-US_TOPIC_0000001233510097__b463106707">p</strong> indicates the precision after the decimal point. The value ranges from 0 to 6.</p>
</td>
<td class="cellrowborder" valign="top" width="26.27%" headers="mcps1.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__a4d09e18f9133449492d093aafa60d6cc">12 bytes</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r643e5bbeeb72482b9f5b2d239cc1f53a"><td class="cellrowborder" valign="top" width="27.939999999999998%" headers="mcps1.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__a90de7bae6e314c5d9b4e8ff88775a92e">TIMESTAMP[(p)] [WITHOUT TIME ZONE]</p>
</td>
<td class="cellrowborder" valign="top" width="45.79%" headers="mcps1.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__a6873edfe3bad445f8efecd295b609338">Specifies the date and time.</p>
<p id="EN-US_TOPIC_0000001233510097__a12f42877b2214bd8ab950487753f287e"><strong id="EN-US_TOPIC_0000001233510097__b1307601543">p</strong> indicates the precision after the decimal point. The value ranges from 0 to 6.</p>
</td>
<td class="cellrowborder" valign="top" width="26.27%" headers="mcps1.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__ae516b1e8ea81488d9299ab724e0036fe">8 bytes</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r20a05dbbdd3b41c5a6c6ccd77eb5eef5"><td class="cellrowborder" valign="top" width="27.939999999999998%" headers="mcps1.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__aaba04dae851e477cb0db09ea6e03c8b2">TIMESTAMP[(p)][WITH TIME ZONE]</p>
</td>
<td class="cellrowborder" valign="top" width="45.79%" headers="mcps1.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__aff470c33457943df8c22eb8094e683ec">Specifies the date and time (with time zone). TIMESTAMP is also called TIMESTAMPTZ.</p>
<p id="EN-US_TOPIC_0000001233510097__a26f89aac6ec0495ca89cb86accaabae0"><strong id="EN-US_TOPIC_0000001233510097__b563688738">p</strong> indicates the precision after the decimal point. The value ranges from 0 to 6.</p>
</td>
<td class="cellrowborder" valign="top" width="26.27%" headers="mcps1.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__a18bea8615eab400cb1f6e107024687b9">8 bytes</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r28d0c58a5f9d47de9d2ae69d1d6d92b4"><td class="cellrowborder" valign="top" width="27.939999999999998%" headers="mcps1.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__a319d0a74682b4fda92946edfcd729ada">SMALLDATETIME</p>
</td>
<td class="cellrowborder" valign="top" width="45.79%" headers="mcps1.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__a492ac1709d034781be569069a2667da8">Specifies the date and time (without time zone).</p>
<p id="EN-US_TOPIC_0000001233510097__ae29b93c083674d268e82c91b528bf09b">The precision level is minute. 31s to 59s are rounded into 1 minute.</p>
</td>
<td class="cellrowborder" valign="top" width="26.27%" headers="mcps1.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__a6af95d9faa5d46d8a75f1940da7dc76c">8 bytes</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r8bd159aed501439599e1e36a47d5de1d"><td class="cellrowborder" valign="top" width="27.939999999999998%" headers="mcps1.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__a0869b4b190e64c8282486d906491dc8e">INTERVAL DAY (l) TO SECOND (p)</p>
</td>
<td class="cellrowborder" valign="top" width="45.79%" headers="mcps1.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__a86c5b7663fac40dba1301c047fe24e34">Specifies the time interval (X days X hours X minutes X seconds).</p>
<ul id="EN-US_TOPIC_0000001233510097__u05a9d15754994bf5a486e4666c51c958"><li id="EN-US_TOPIC_0000001233510097__l8b4cadd6f32241f09fe9302cb1ed95b4"><strong id="EN-US_TOPIC_0000001233510097__b842352706105746">l</strong>: indicates the precision of days. The value ranges from 0 to 6. To adapt to Oracle syntax, the precision functions are not supported.</li><li id="EN-US_TOPIC_0000001233510097__la094cab712c64434b577c6f861a74a10"><strong id="EN-US_TOPIC_0000001233510097__b84235270610752">p</strong>: indicates the precision of seconds. The value ranges from 0 to 6. The digit 0 at the end of a decimal number is not displayed.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="26.27%" headers="mcps1.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__a5076f94050784b8bb9b5d43606c6652f">16 bytes</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__rc34a5cd761fa4728aae036a6a25dbc81"><td class="cellrowborder" valign="top" width="27.939999999999998%" headers="mcps1.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__a57e3616d61c0445c88d826d02005c160">INTERVAL [FIELDS] [ (p) ]</p>
</td>
<td class="cellrowborder" valign="top" width="45.79%" headers="mcps1.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__a72c7c556066b4e248b1919b993d6e19a">Specifies the time interval.</p>
<ul id="EN-US_TOPIC_0000001233510097__ueb1b92905e3c4d678563412368c787bb"><li id="EN-US_TOPIC_0000001233510097__l3bc8bfe777e74ca7abe741d28b1981d0">fields: <strong id="EN-US_TOPIC_0000001233510097__b84235270610830">YEAR</strong>, <strong id="EN-US_TOPIC_0000001233510097__b84235270610835">MONTH</strong>, <strong id="EN-US_TOPIC_0000001233510097__b84235270610839">DAY</strong>, <strong id="EN-US_TOPIC_0000001233510097__b84235270610844">HOUR</strong>, <strong id="EN-US_TOPIC_0000001233510097__b84235270610851">MINUTE</strong>, <strong id="EN-US_TOPIC_0000001233510097__b84235270610857">SECOND</strong>, <strong id="EN-US_TOPIC_0000001233510097__b8423527061097">DAY TO HOUR</strong>, <strong id="EN-US_TOPIC_0000001233510097__b84235270610915">DAY TO MINUTE</strong>, <strong id="EN-US_TOPIC_0000001233510097__b84235270610952">DAY TO SECOND</strong>, <strong id="EN-US_TOPIC_0000001233510097__b84235270610114">HOUR TO MINUTE</strong>, <strong id="EN-US_TOPIC_0000001233510097__b842352706101110">HOUR TO SECOND</strong>, and <strong id="EN-US_TOPIC_0000001233510097__b842352706101116">MINUTE TO SECOND</strong>.</li></ul>
<ul id="EN-US_TOPIC_0000001233510097__ucb39618990c949c7a286546f519c1480"><li id="EN-US_TOPIC_0000001233510097__ldc189c68b5e44516a8be8b62ac8b9503"><strong id="EN-US_TOPIC_0000001233510097__b84235270610187">p</strong>: indicates the precision of seconds. The value ranges from 0 to 6. <strong id="EN-US_TOPIC_0000001233510097__b842352706101223">p</strong> takes effect only when fields are <strong id="EN-US_TOPIC_0000001233510097__b842352706101821">SECOND</strong>, <strong id="EN-US_TOPIC_0000001233510097__b842352706101836">DAY TO SECOND</strong>, <strong id="EN-US_TOPIC_0000001233510097__b842352706101851">HOUR TO SECOND</strong>, or <strong id="EN-US_TOPIC_0000001233510097__b842352706101856">MINUTE TO SECOND</strong>. The digit 0 at the end of a decimal number is not displayed.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="26.27%" headers="mcps1.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__a1725da3c1b854183b1e49bdfefabebef">12 bytes</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__row144417485416"><td class="cellrowborder" valign="top" width="27.939999999999998%" headers="mcps1.3.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__p4445748144">reltime</p>
</td>
<td class="cellrowborder" valign="top" width="45.79%" headers="mcps1.3.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__p660982815360">Relative time interval. The format is:</p>
<p id="EN-US_TOPIC_0000001233510097__p844554814414"><em id="EN-US_TOPIC_0000001233510097__i5411145151419">X</em> years <em id="EN-US_TOPIC_0000001233510097__i17554175301414">X</em> months <em id="EN-US_TOPIC_0000001233510097__i1925935731414">X</em> days <em id="EN-US_TOPIC_0000001233510097__i1194218113158">XX:XX:XX</em></p>
<ul id="EN-US_TOPIC_0000001233510097__ul26193620613"><li id="EN-US_TOPIC_0000001233510097__li56115362618">The Julian calendar is used. It specifies that a year has 365.25 days and a month has 30 days. The relative time interval needs to be calculated based on the input value. The output format is POSTGRES.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="26.27%" headers="mcps1.3.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__p344517481945">4 bytes</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0000001233510097__a93b6871eb56941b48d05c8498532d0a5">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510097__sfd6a93b8553c47ca81432df6ab995de7"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span>
<span class="normal">23</span>
<span class="normal">24</span>
<span class="normal">25</span>
<span class="normal">26</span>
<span class="normal">27</span>
<span class="normal">28</span>
<span class="normal">29</span>
<span class="normal">30</span>
<span class="normal">31</span>
<span class="normal">32</span>
<span class="normal">33</span>
<span class="normal">34</span>
<span class="normal">35</span>
<span class="normal">36</span>
<span class="normal">37</span>
<span class="normal">38</span>
<span class="normal">39</span>
<span class="normal">40</span>
<span class="normal">41</span>
<span class="normal">42</span>
<span class="normal">43</span>
<span class="normal">44</span>
<span class="normal">45</span>
<span class="normal">46</span>
<span class="normal">47</span>
<span class="normal">48</span>
<span class="normal">49</span>
<span class="normal">50</span>
<span class="normal">51</span>
<span class="normal">52</span>
<span class="normal">53</span>
<span class="normal">54</span>
<span class="normal">55</span>
<span class="normal">56</span>
<span class="normal">57</span>
<span class="normal">58</span>
<span class="normal">59</span>
<span class="normal">60</span>
<span class="normal">61</span>
<span class="normal">62</span>
<span class="normal">63</span></pre></div></td><td class="code"><div><pre><span></span><span class="c1">--Create a table:</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">date_type_tab</span><span class="p">(</span><span class="n">coll</span><span class="w"> </span><span class="nb">date</span><span class="p">);</span>
<span class="c1">--Insert data:</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">date_type_tab</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="nb">date</span><span class="w"> </span><span class="s1">'12-10-2010'</span><span class="p">);</span>
<span class="c1">-- View data:</span>
<span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">date_type_tab</span><span class="p">;</span>
<span class="w"> </span><span class="n">coll</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2010</span><span class="o">-</span><span class="mi">12</span><span class="o">-</span><span class="mi">10</span><span class="w"> </span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="c1">-- Delete the tables:</span>
<span class="k">DROP</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">date_type_tab</span><span class="p">;</span>
<span class="c1">--Create a table:</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">time_type_tab</span><span class="w"> </span><span class="p">(</span><span class="n">da</span><span class="w"> </span><span class="k">time</span><span class="w"> </span><span class="k">without</span><span class="w"> </span><span class="k">time</span><span class="w"> </span><span class="k">zone</span><span class="w"> </span><span class="p">,</span><span class="n">dai</span><span class="w"> </span><span class="k">time</span><span class="w"> </span><span class="k">with</span><span class="w"> </span><span class="k">time</span><span class="w"> </span><span class="k">zone</span><span class="p">,</span><span class="n">dfgh</span><span class="w"> </span><span class="k">timestamp</span><span class="w"> </span><span class="k">without</span><span class="w"> </span><span class="k">time</span><span class="w"> </span><span class="k">zone</span><span class="p">,</span><span class="n">dfga</span><span class="w"> </span><span class="k">timestamp</span><span class="w"> </span><span class="k">with</span><span class="w"> </span><span class="k">time</span><span class="w"> </span><span class="k">zone</span><span class="p">,</span><span class="w"> </span><span class="n">vbg</span><span class="w"> </span><span class="n">smalldatetime</span><span class="p">);</span>
<span class="c1">--Insert data:</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">time_type_tab</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="s1">'21:21:21'</span><span class="p">,</span><span class="s1">'21:21:21 pst'</span><span class="p">,</span><span class="s1">'2010-12-12'</span><span class="p">,</span><span class="s1">'2013-12-11 pst'</span><span class="p">,</span><span class="s1">'2003-04-12 04:05:06'</span><span class="p">);</span>
<span class="c1">-- View data:</span>
<span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">time_type_tab</span><span class="p">;</span>
<span class="w"> </span><span class="n">da</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">dai</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">dfgh</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">dfga</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">vbg</span><span class="w"> </span>
<span class="c1">----------+-------------+---------------------+------------------------+---------------------</span>
<span class="w"> </span><span class="mi">21</span><span class="p">:</span><span class="mi">21</span><span class="p">:</span><span class="mi">21</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">21</span><span class="p">:</span><span class="mi">21</span><span class="p">:</span><span class="mi">21</span><span class="o">-</span><span class="mi">08</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">2010</span><span class="o">-</span><span class="mi">12</span><span class="o">-</span><span class="mi">12</span><span class="w"> </span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">2013</span><span class="o">-</span><span class="mi">12</span><span class="o">-</span><span class="mi">11</span><span class="w"> </span><span class="mi">16</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span><span class="o">+</span><span class="mi">08</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">2003</span><span class="o">-</span><span class="mi">04</span><span class="o">-</span><span class="mi">12</span><span class="w"> </span><span class="mi">04</span><span class="p">:</span><span class="mi">05</span><span class="p">:</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="c1">-- Delete the tables:</span>
<span class="k">DROP</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">time_type_tab</span><span class="p">;</span>
<span class="c1">--Create a table:</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">day_type_tab</span><span class="w"> </span><span class="p">(</span><span class="n">a</span><span class="w"> </span><span class="nb">int</span><span class="p">,</span><span class="n">b</span><span class="w"> </span><span class="nb">INTERVAL</span><span class="w"> </span><span class="k">DAY</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="k">SECOND</span><span class="w"> </span><span class="p">(</span><span class="mi">4</span><span class="p">));</span><span class="w"> </span>
<span class="c1">--Insert data:</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">day_type_tab</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="nb">INTERVAL</span><span class="w"> </span><span class="s1">'3'</span><span class="w"> </span><span class="k">DAY</span><span class="p">);</span>
<span class="c1">-- View data:</span>
<span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">day_type_tab</span><span class="p">;</span>
<span class="w"> </span><span class="n">a</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">b</span><span class="w"> </span>
<span class="c1">---+--------</span>
<span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">3</span><span class="w"> </span><span class="n">days</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="c1">-- Delete the tables:</span>
<span class="k">DROP</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">day_type_tab</span><span class="p">;</span>
<span class="c1">--Create a table:</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">year_type_tab</span><span class="p">(</span><span class="n">a</span><span class="w"> </span><span class="nb">int</span><span class="p">,</span><span class="w"> </span><span class="n">b</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="k">year</span><span class="w"> </span><span class="p">(</span><span class="mi">6</span><span class="p">));</span>
<span class="c1">--Insert data:</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">year_type_tab</span><span class="w"> </span><span class="k">VALUES</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span><span class="nb">interval</span><span class="w"> </span><span class="s1">'2'</span><span class="w"> </span><span class="k">year</span><span class="p">);</span>
<span class="c1">-- View data:</span>
<span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">year_type_tab</span><span class="p">;</span>
<span class="w"> </span><span class="n">a</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">b</span><span class="w"> </span>
<span class="c1">---+---------</span>
<span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="n">years</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="c1">-- Delete the tables:</span>
<span class="k">DROP</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">year_type_tab</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001233510097__s188b896036cd4d2a954226868f3b8808"><h4 class="sectiontitle">Date Input</h4><p id="EN-US_TOPIC_0000001233510097__a3656dccbfbd54059869e62232878230d">Date and time input is accepted in almost any reasonable formats, including ISO 8601, SQL-compatible, and traditional POSTGRES. The system allows you to customize the sequence of day, month, and year in the date input. Set the <strong id="EN-US_TOPIC_0000001233510097__b842352706102029">DateStyle</strong> parameter to <strong id="EN-US_TOPIC_0000001233510097__b842352706102037">MDY</strong> to select month-day-year interpretation, <strong id="EN-US_TOPIC_0000001233510097__b842352706102047">DMY</strong> to select day-month-year interpretation, or <strong id="EN-US_TOPIC_0000001233510097__b842352706102052">YMD</strong> to select year-month-day interpretation.</p>
<p id="EN-US_TOPIC_0000001233510097__a1e66988228d147faa86a9c042d0bbd81">Remember that any date or time literal input needs to be enclosed with single quotes, and the syntax is as follows:</p>
<p id="EN-US_TOPIC_0000001233510097__ae2a50b39a51e4c83ac279d142a66aad8">type [ ( p ) ] 'value'</p>
<p id="EN-US_TOPIC_0000001233510097__a956f816ed49e4c55aa9b431504600448">The <strong id="EN-US_TOPIC_0000001233510097__en-us_topic_0085032383_b84235270611438">p</strong> that can be selected in the precision statement is an integer, indicating the number of fractional digits in the <strong id="EN-US_TOPIC_0000001233510097__en-us_topic_0085032383_b842352706182648">seconds</strong> column. <a href="#EN-US_TOPIC_0000001233510097__tc495b297873743f4b54c2a2dc171b42a">Table 2</a> shows some possible inputs for the <strong id="EN-US_TOPIC_0000001233510097__en-us_topic_0085032383_b842352706103752">date</strong> type.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001233510097__tc495b297873743f4b54c2a2dc171b42a"></a><a name="tc495b297873743f4b54c2a2dc171b42a"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233510097__tc495b297873743f4b54c2a2dc171b42a" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Date input</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233510097__r607aef13a09540f1861455cf0c740d73"><th align="left" class="cellrowborder" valign="top" width="24.62%" id="mcps1.3.6.6.2.3.1.1"><p id="EN-US_TOPIC_0000001233510097__a95ca49a97455496fa4a4084a5462d867">Example</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="75.38%" id="mcps1.3.6.6.2.3.1.2"><p id="EN-US_TOPIC_0000001233510097__ada364ba2373a4019b8ea80b435749530">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001233510097__rb9d8c075d82c481c84eaf818757273d8"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a46dddcadd16748fc98423710d1db4baf">1999-01-08</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a159ad3e24f0245fdaae5ef348db30056">ISO 8601 (recommended format). January 8, 1999 in any mode</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r3881cafc8ca54fe486a0fc1e8b81191c"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a8fff7138af404746832a20d0c6672fed">January 8, 1999</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__aaabce0c59b0c43ad91b4adb5570b8c2f">Unambiguous in any date input mode</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r2a7cccdf204d4d7a9afd20e0b6a783c3"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a8726aa96d1dc4c139450808fede41c82">1/8/1999</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a3d4ed2150f74481d83d3371c6f028d96">January 8 in <strong id="EN-US_TOPIC_0000001233510097__b842352706104043">MDY</strong> mode. August 1 in <strong id="EN-US_TOPIC_0000001233510097__b842352706104047">DMY</strong> mode</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__ra5e8126b4dfa473eb58ead4d39e327ca"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__ad3bbeab3ec4345fab0aa329ec53c7ebf">1/18/1999</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a28d35f4980c945ffa82df1ce1d6f92ba">January 18 in <strong id="EN-US_TOPIC_0000001233510097__b842352706104218">MDY</strong> mode, rejected in other modes</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__re8dde9558e294847818fd4dd41a01c68"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__ac50257995f4448e8b13bfe58a1de9ab8">01/02/03</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><ul id="EN-US_TOPIC_0000001233510097__u9add64db99534f94ba588e0b752c53ce"><li id="EN-US_TOPIC_0000001233510097__l23876616a8f14de597443b0b3d34abc7">January 2, 2003 in <strong id="EN-US_TOPIC_0000001233510097__b842352706104338">MDY</strong> mode</li><li id="EN-US_TOPIC_0000001233510097__l8f9394d3b7bd4d79a655f553049151c0">February 1, 2003 in <strong id="EN-US_TOPIC_0000001233510097__b842352706104354">DMY</strong> mode</li><li id="EN-US_TOPIC_0000001233510097__lbe8f8278b2584935b653682e267011bf">February 3, 2001 in <strong id="EN-US_TOPIC_0000001233510097__b84235270610444">YMD</strong> mode</li></ul>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r77a25932c39a4ab7a422785d4e8e7ab8"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__af784bda05afe49c6bb8158077b66d054">1999-Jan-08</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__ad5532e025e2b413b8ade7f93c7996a99">January 8 in any mode</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r0a04c6cf6355481ab912305c4f216c63"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a0fd4d5e787bf472f82c1fc51520135b4">Jan-08-1999</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__ab4a947090395452fa42936b1f951e0d1">January 8 in any mode</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r3f088a6a902e4fff8c0473bba89b003c"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__abba3e85cd4474f23b7fa99769c7af1b0">08-Jan-1999</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__ad5f581caabfb4470ace13186dd16b244">January 8 in any mode</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r82c5bcc6f717476c9ab37fa7ccfbdf9c"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__ae545d824031d491c88f8a158dcf978a0">99-Jan-08</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a317098efdc8740e2bb754230f7f0cfab">January 8 in <strong id="EN-US_TOPIC_0000001233510097__b842352706104511">YMD</strong> mode, else error</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r1d7b89f4b7de4da495fa87ceceaafd03"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a2e0f2c60c61a4b1d96e2b760fd6cea3c">08-Jan-99</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__ad9692dec4aea494c8a6e60c5aca7462a">January 8, except error in <strong id="EN-US_TOPIC_0000001233510097__b842352706104550">YMD</strong> mode</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__rb917dab3e60449a49b0f87d8a9ca2aec"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__ac0163acb23c14d24908ebbf91faea9fe">Jan-08-99</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a592782b201bf434495fe79e5cb65b8e4">January 8, except error in <strong id="EN-US_TOPIC_0000001233510097__b110069254">YMD</strong> mode</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__rf997221348a64ebea10e0176118bd9b3"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__acc769e8427564bbca3aa961dc4061ba4">19990108</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__aed74ab12ec584478aa528dd0e41a2724">ISO 8601. January 8, 1999 in any mode</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__rf741b39b1360416ea9fdca7e4874c107"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a87a5a4b202b6457f966787ab7c295aab">990108</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a1ee3f470a1a945c4ad882f14a2c1142e">ISO 8601. January 8, 1999 in any mode</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r6483edd623b94d5b9af81c99ab13a476"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a4ef5821fd6a14652b61d41c727c0e1c5">1999.008</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a99b40689293e48e6a95da9f9ff22ea0d">Year and day of year</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__rcf5d0c8486fa48daa53bef5ddbc42431"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a24e8712a670d447b8214ace69f954153">J2451187</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a177fc18f9beb4c7db7844199efac5558">Julian date</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r61aa64e875bb46aaa92ccc317f59632e"><td class="cellrowborder" valign="top" width="24.62%" headers="mcps1.3.6.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a113ee4e002044f52b278e604cd95ca80">January 8, 99 BC</p>
</td>
<td class="cellrowborder" valign="top" width="75.38%" headers="mcps1.3.6.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a650efbac5c644a5b89f782bd71fdb3c1">Year 99 BC</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0000001233510097__ad0bfd309f1f646dda18219d15d81e8bc">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510097__s48d52b85ee0246afb671fbf843251f99"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span>
<span class="normal">23</span>
<span class="normal">24</span>
<span class="normal">25</span>
<span class="normal">26</span>
<span class="normal">27</span>
<span class="normal">28</span>
<span class="normal">29</span>
<span class="normal">30</span>
<span class="normal">31</span>
<span class="normal">32</span>
<span class="normal">33</span>
<span class="normal">34</span>
<span class="normal">35</span>
<span class="normal">36</span>
<span class="normal">37</span></pre></div></td><td class="code"><div><pre><span></span><span class="c1">--Create a table:</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">date_type_tab</span><span class="p">(</span><span class="n">coll</span><span class="w"> </span><span class="nb">date</span><span class="p">);</span>
<span class="c1">--Insert data:</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">date_type_tab</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="nb">date</span><span class="w"> </span><span class="s1">'12-10-2010'</span><span class="p">);</span>
<span class="c1">-- View data:</span>
<span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">date_type_tab</span><span class="p">;</span>
<span class="w"> </span><span class="n">coll</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2010</span><span class="o">-</span><span class="mi">12</span><span class="o">-</span><span class="mi">10</span><span class="w"> </span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="c1">-- View the date format:</span>
<span class="k">SHOW</span><span class="w"> </span><span class="n">datestyle</span><span class="p">;</span>
<span class="w"> </span><span class="n">DateStyle</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="n">ISO</span><span class="p">,</span><span class="w"> </span><span class="n">MDY</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="c1">-- Configure the date format:</span>
<span class="k">SET</span><span class="w"> </span><span class="n">datestyle</span><span class="o">=</span><span class="s1">'YMD'</span><span class="p">;</span>
<span class="k">SET</span>
<span class="c1">-- Insert data:</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">date_type_tab</span><span class="w"> </span><span class="k">VALUES</span><span class="p">(</span><span class="nb">date</span><span class="w"> </span><span class="s1">'2010-12-11'</span><span class="p">);</span>
<span class="c1">-- View data:</span>
<span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">date_type_tab</span><span class="p">;</span>
<span class="w"> </span><span class="n">coll</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2010</span><span class="o">-</span><span class="mi">12</span><span class="o">-</span><span class="mi">10</span><span class="w"> </span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span>
<span class="w"> </span><span class="mi">2010</span><span class="o">-</span><span class="mi">12</span><span class="o">-</span><span class="mi">11</span><span class="w"> </span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">2</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
<span class="c1">-- Delete the tables:</span>
<span class="k">DROP</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">date_type_tab</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001233510097__s8fb08b8fffd6456c9ef8b2054c933223"><h4 class="sectiontitle">Times</h4><p id="EN-US_TOPIC_0000001233510097__a4ff50eb675f3413181f8cecb6f7619df">The time-of-day types are <strong id="EN-US_TOPIC_0000001233510097__b84235270614148">TIME [(p)] [WITHOUT TIME ZONE]</strong> and <strong id="EN-US_TOPIC_0000001233510097__b842352706141425">TIME [(p)] [WITH TIME ZONE]</strong>. <strong id="EN-US_TOPIC_0000001233510097__b842352706141618">TIME</strong> alone is equivalent to <strong id="EN-US_TOPIC_0000001233510097__b842352706141624">TIME WITHOUT TIME ZONE</strong>.</p>
<p id="EN-US_TOPIC_0000001233510097__a45c965abc31a41cbb6005a66b0d1e2a4">If a time zone is specified in the input for <strong id="EN-US_TOPIC_0000001233510097__en-us_topic_0085032383_b842352706142450">TIME WITHOUT TIME ZONE</strong>, it is silently ignored.</p>
<p id="EN-US_TOPIC_0000001233510097__a27c9f34c42ef4160bf41d6cef09e1838">For details about the time input types, see <a href="#EN-US_TOPIC_0000001233510097__t24429c065d474feba61c1b0e490f9dac">Table 3</a>. For details about time zone input types, see <a href="#EN-US_TOPIC_0000001233510097__t63d0318275dc486081a76f7677ab0a5f">Table 4</a>.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001233510097__t24429c065d474feba61c1b0e490f9dac"></a><a name="t24429c065d474feba61c1b0e490f9dac"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233510097__t24429c065d474feba61c1b0e490f9dac" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Time input</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233510097__r43f631932e7e4450a1378a83f53db662"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.7.5.2.3.1.1"><p id="EN-US_TOPIC_0000001233510097__ac811369e35d540caa2a3f3abe8353323">Example</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.7.5.2.3.1.2"><p id="EN-US_TOPIC_0000001233510097__ac4ddb247f850496ebd387f6de60b19c3">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001233510097__ra44d66b60bc6481fa871f239484b0023"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a65207ac4d8c74dc8bc388924284dd427">05:06.8</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__ad0b51170be864984b341ed049b87428e">ISO 8601</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__rade58da5b1b24e3ba446161d798057f1"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a99e0783971874dbe94ad2eb62db0fc5d">4:05:06</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__aa5d6dc8e5e8943a0b2dcb48a1117444a">ISO 8601</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__rd0439b8acc4943748c83b77fe7757c35"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a8b41fc8083bf483c9e00cf37683e89d1">4:05</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a20b882ff63a0440faf2ed193925ffaf0">ISO 8601</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r9064be6c24a242f59d08415d3ae1210c"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a87265777154d4a339c618a1eca1b67b2">40506</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__aef45827e53e24484bf85c2c11df578ab">ISO 8601</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r25640f6dd7464e53a38bd2a435bba160"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a037d0d9b266d43578376b74c19214456">4:05 AM</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__aaba739f539d34762ac495b3560b4d2b8">Same as 04:05. AM does not affect value</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r4aacbbf2d6fe4dcdb1e57c3f9287b457"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__ad3ce091a5e19486fb07d292988c6fd6b">4:05 PM</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__ad102e37e9c6947079f3189930ca2ba67">Same as 16:05. Input hour must be &lt;= 12</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r939a7a9ebbf84194b1dc535fcbe77ebd"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__af1cdd4d9e17c4a0eb65a4f1fd34b000f">04:05:06.789-8</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__ae850dfa2a2634b668c3361e7bd7c4ac2">ISO 8601</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r5a8747f12a714e64bfbd1b18c7abbef8"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a1e9d369959154a2f92d56bc995e08b21">04:05:06-08:00</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a491a98d3043045ddb98265231556a1c5">ISO 8601</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__rf65104a62fa849179046df84c23a4441"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__af6daa6b5953b4b1988b04c6d870b3b37">04:05-08:00</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a1e5042cdd8114a91815704500659a289">ISO 8601</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__rdce688076e974773bad797761393bd54"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__af0526ec457d440ac9fae17cf69422f14">040506-08</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__afa879373bc4c4db4af022281e88687c8">ISO 8601</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r65f7b671916747cba855947d13050c5b"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__acb7f8d15f5104388a49d4e78d0e688b9">04:05:06 PST</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.7.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a64e07fb6d14948f383fb278c026d2cb3">Time zone specified by abbreviation</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001233510097__t63d0318275dc486081a76f7677ab0a5f"></a><a name="t63d0318275dc486081a76f7677ab0a5f"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233510097__t63d0318275dc486081a76f7677ab0a5f" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Time zone input</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233510097__r6e75bc425adc45959da9d99cca16cc31"><th align="left" class="cellrowborder" valign="top" width="40.98%" id="mcps1.3.7.6.2.3.1.1"><p id="EN-US_TOPIC_0000001233510097__a4a0019331cba4e3ea2e608232e425425">Example</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.019999999999996%" id="mcps1.3.7.6.2.3.1.2"><p id="EN-US_TOPIC_0000001233510097__a3de030ff79ea4e8a97be4e9f7ac0638a">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001233510097__r82fe9c310f1e41dcb95203464953a53a"><td class="cellrowborder" valign="top" width="40.98%" headers="mcps1.3.7.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__ad9b61dee965c4406bd097c9090173223">PST</p>
</td>
<td class="cellrowborder" valign="top" width="59.019999999999996%" headers="mcps1.3.7.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__ad09487d909fe450289ec02af2fc40c92">Abbreviation (for Pacific Standard Time)</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r7b8ab2af05e942da8cbf0460aa8105dd"><td class="cellrowborder" valign="top" width="40.98%" headers="mcps1.3.7.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a8c32567d40ee47cf8c0a6a8910da111e">-8:00</p>
</td>
<td class="cellrowborder" valign="top" width="59.019999999999996%" headers="mcps1.3.7.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__af40d2d4502924dfe94a23902fce7db0f">ISO-8601 offset for PST</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__rbac02667cb6840129bd2147c88ad1f23"><td class="cellrowborder" valign="top" width="40.98%" headers="mcps1.3.7.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a814f6da5f75648f9a7812f90e13976e6">-800</p>
</td>
<td class="cellrowborder" valign="top" width="59.019999999999996%" headers="mcps1.3.7.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a5fedf5ea86bb4357be1be87cd16e1f33">ISO-8601 offset for PST</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r298a8fec6a3b41ccaa8f9c0d859a93c7"><td class="cellrowborder" valign="top" width="40.98%" headers="mcps1.3.7.6.2.3.1.1 "><p id="EN-US_TOPIC_0000001233510097__a6728d737b6304e93884c51104f960c3a">-8</p>
</td>
<td class="cellrowborder" valign="top" width="59.019999999999996%" headers="mcps1.3.7.6.2.3.1.2 "><p id="EN-US_TOPIC_0000001233510097__a1d1c8d0548a041b98cfff5e36270b8ee">ISO-8601 offset for PST</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0000001233510097__aa46f84718c25416883bd6d370af8c8b7">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510097__sb21c72e822224418ab9e9e0252bde741"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">time</span><span class="w"> </span><span class="s1">'04:05:06'</span><span class="p">;</span>
<span class="w"> </span><span class="k">time</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="mi">04</span><span class="p">:</span><span class="mi">05</span><span class="p">:</span><span class="mi">06</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="k">time</span><span class="w"> </span><span class="s1">'04:05:06 PST'</span><span class="p">;</span>
<span class="w"> </span><span class="k">time</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="mi">04</span><span class="p">:</span><span class="mi">05</span><span class="p">:</span><span class="mi">06</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="k">time</span><span class="w"> </span><span class="k">with</span><span class="w"> </span><span class="k">time</span><span class="w"> </span><span class="k">zone</span><span class="w"> </span><span class="s1">'04:05:06 PST'</span><span class="p">;</span>
<span class="w"> </span><span class="n">timetz</span><span class="w"> </span>
<span class="c1">-------------</span>
<span class="w"> </span><span class="mi">04</span><span class="p">:</span><span class="mi">05</span><span class="p">:</span><span class="mi">06</span><span class="o">-</span><span class="mi">08</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001233510097__sb3c42bc431894c47abf347d34b8b8875"><h4 class="sectiontitle">Special Values</h4><p id="EN-US_TOPIC_0000001233510097__ac6281164a5b04189bb20c5596349c14b">The special values supported by <span id="EN-US_TOPIC_0000001233510097__text1264066993">GaussDB(DWS)</span> are converted to common date/time values when being read. For details, see <a href="#EN-US_TOPIC_0000001233510097__t5e86ad23ea5649969935ea26bf746e0f">Table 5</a>.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001233510097__t5e86ad23ea5649969935ea26bf746e0f"></a><a name="t5e86ad23ea5649969935ea26bf746e0f"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233510097__t5e86ad23ea5649969935ea26bf746e0f" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Special Values</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233510097__r8eb3b8545862414e9fd06e4650b36396"><th align="left" class="cellrowborder" valign="top" width="17.599999999999998%" id="mcps1.3.8.3.2.4.1.1"><p id="EN-US_TOPIC_0000001233510097__aea30a13e092e41fa82b8eb17ceb85989">Input String</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="29.43%" id="mcps1.3.8.3.2.4.1.2"><p id="EN-US_TOPIC_0000001233510097__ae4aaf3bbb4a349c39e0e813af78b84e6">Applicable Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="52.96999999999999%" id="mcps1.3.8.3.2.4.1.3"><p id="EN-US_TOPIC_0000001233510097__aeea1522191fb467aaa298a5994f2c9f8">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001233510097__rd85ff95443594f3e9bd335deac142b0b"><td class="cellrowborder" valign="top" width="17.599999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__a65309b4be2c346a09d634420aa6cbe93">epoch</p>
</td>
<td class="cellrowborder" valign="top" width="29.43%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__a419e9a58b4484bd297b28ef428abc3ee">date, timestamp</p>
</td>
<td class="cellrowborder" valign="top" width="52.96999999999999%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__a094645ffc34c4580bd89f37db4abfc44">1970-01-01 00:00:00+00 (Unix system time zero)</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r3777412513df487da38fc5a957b86ab3"><td class="cellrowborder" valign="top" width="17.599999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__a073e3f0ce68d433a869ec886ddde69f6">infinity</p>
</td>
<td class="cellrowborder" valign="top" width="29.43%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__acfb62448b48d4926ab6f0de4833ccdae">timestamp</p>
</td>
<td class="cellrowborder" valign="top" width="52.96999999999999%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__a46e3e12644d549099ad2cf43a026f795">Later than any other timestamps</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__rba4df475e2204eb59bcf1d31ca188b04"><td class="cellrowborder" valign="top" width="17.599999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__ad43c19bc996043cc9cbeaf0910f4956b">-infinity</p>
</td>
<td class="cellrowborder" valign="top" width="29.43%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__a47920c23a1e24a4a85a37e4d1973be0b">timestamp</p>
</td>
<td class="cellrowborder" valign="top" width="52.96999999999999%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__a446dc0e9cb75439a86267d81c4348e09">Earlier than any other timestamps</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r8c7b92cc0dd84772b359d9e7de4c7a15"><td class="cellrowborder" valign="top" width="17.599999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__ae38dc71871b34be89f8de56db0926f85">now</p>
</td>
<td class="cellrowborder" valign="top" width="29.43%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__af25fbb4a2b5846f6a734aedc4bb4b2ed">date, time, timestamp</p>
</td>
<td class="cellrowborder" valign="top" width="52.96999999999999%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__ad528d8c0e66e46c8aa67fe3c24c6d60f">Start time of the current transaction</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r3ea30f71f7e74a0797030ef394136de2"><td class="cellrowborder" valign="top" width="17.599999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__a3d50a641ba9443b1ba9bf9a1adcca1e1">today</p>
</td>
<td class="cellrowborder" valign="top" width="29.43%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__afb00c86797434d32a069b0450e6831fd">date, timestamp</p>
</td>
<td class="cellrowborder" valign="top" width="52.96999999999999%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__aea05483774d748879830fca54f99f9b9">Today midnight</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r5becda5349654571a95f75a4047d9049"><td class="cellrowborder" valign="top" width="17.599999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__a0a49f3b53de24317b0d84b047e740add">tomorrow</p>
</td>
<td class="cellrowborder" valign="top" width="29.43%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__acf98ab846d46408c877e86dd77f2e881">date, timestamp</p>
</td>
<td class="cellrowborder" valign="top" width="52.96999999999999%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__a69a7f97953f04cb8a5ca3fe23cd3a99f">Tomorrow midnight</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r4cbeae3d6bb5419ebe1bd84e6e3be068"><td class="cellrowborder" valign="top" width="17.599999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__a4795583e96e646fdaf6977e9fe1e7786">yesterday</p>
</td>
<td class="cellrowborder" valign="top" width="29.43%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__a3103d9b2f3864331b71aaae62795ea35">date, timestamp</p>
</td>
<td class="cellrowborder" valign="top" width="52.96999999999999%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__aaf16e65507674525a09a6069cc0d3a78">Yesterday midnight</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__r0e5830fd2ec04582b2e21fdbe121f7fa"><td class="cellrowborder" valign="top" width="17.599999999999998%" headers="mcps1.3.8.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__a89852e4de4574bd0892d2a44a70ee913">allballs</p>
</td>
<td class="cellrowborder" valign="top" width="29.43%" headers="mcps1.3.8.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__a71b18429feb64601a979d48fcc1d5fca">time</p>
</td>
<td class="cellrowborder" valign="top" width="52.96999999999999%" headers="mcps1.3.8.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__accccb5a558fa448ebdf84483814d95ca">00:00:00.00 UTC</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001233510097__section1947184682711"><h4 class="sectiontitle">Interval Input</h4><p id="EN-US_TOPIC_0000001233510097__p11469124610274">The input of <strong id="EN-US_TOPIC_0000001233510097__b68259310179">reltime</strong> can be any valid interval in TEXT format. It can be a number (negative numbers and decimals are also allowed) or a specific time, which must be in SQL standard format, ISO-8601 format, or POSTGRES format. In addition, the text input needs to be enclosed with single quotation marks ('').</p>
<p id="EN-US_TOPIC_0000001233510097__p246934613276">For details, see <a href="#EN-US_TOPIC_0000001233510097__table1747116463276">Table 6</a>.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001233510097__table1747116463276"></a><a name="table1747116463276"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233510097__table1747116463276" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Interval input</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233510097__row146914611277"><th align="left" class="cellrowborder" valign="top" width="30.303030303030305%" id="mcps1.3.9.4.2.4.1.1"><p id="EN-US_TOPIC_0000001233510097__p174691446172714">Input</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="31.313131313131315%" id="mcps1.3.9.4.2.4.1.2"><p id="EN-US_TOPIC_0000001233510097__p446914682711">Output</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="38.38383838383839%" id="mcps1.3.9.4.2.4.1.3"><p id="EN-US_TOPIC_0000001233510097__p124691546122712">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001233510097__row5469124611272"><td class="cellrowborder" valign="top" width="30.303030303030305%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__p54699468271">60</p>
</td>
<td class="cellrowborder" valign="top" width="31.313131313131315%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__p34691946152712">2 mons</p>
</td>
<td class="cellrowborder" rowspan="3" valign="top" width="38.38383838383839%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__p346964614279">Numbers are used to indicate intervals. The default unit is day. Decimals and negative numbers are also allowed. Particularly, a negative interval syntactically means how long before.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__row14691346122719"><td class="cellrowborder" valign="top" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__p1469174617276">31.25</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__p1846924615270">1 mons 1 days 06:00:00</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__row1246964617272"><td class="cellrowborder" valign="top" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__p44699467271">-365</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__p11469124612272">-12 mons -5 days</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__row1146915468274"><td class="cellrowborder" valign="top" width="30.303030303030305%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__p18469184618277">1 years 1 mons 8 days 12:00:00</p>
</td>
<td class="cellrowborder" valign="top" width="31.313131313131315%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__p20469446152719">1 years 1 mons 8 days 12:00:00</p>
</td>
<td class="cellrowborder" rowspan="3" valign="top" width="38.38383838383839%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__p1469174642719">Intervals are in POSTGRES format. They can contain both positive and negative numbers and are case-insensitive. Output is a simplified POSTGRES interval converted from the input.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__row16469246112711"><td class="cellrowborder" valign="top" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__p1646974672712">-13 months -10 hours</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__p1446914467279">-1 years -25 days -04:00:00</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__row44691346132718"><td class="cellrowborder" valign="top" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__p0469446122718">-2 YEARS +5 MONTHS 10 DAYS</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__p1346974613278">-1 years -6 mons -25 days -06:00:00</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__row14471144615278"><td class="cellrowborder" valign="top" width="30.303030303030305%" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__p5469144642716">P-1.1Y10M</p>
</td>
<td class="cellrowborder" valign="top" width="31.313131313131315%" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__p104711946162714">-3 mons -5 days -06:00:00</p>
</td>
<td class="cellrowborder" rowspan="2" valign="top" width="38.38383838383839%" headers="mcps1.3.9.4.2.4.1.3 "><p id="EN-US_TOPIC_0000001233510097__p15471134610272">Intervals are in ISO-8601 format. They can contain both positive and negative numbers and are case-insensitive. Output is a simplified POSTGRES interval converted from the input.</p>
<p id="EN-US_TOPIC_0000001233510097__p144711546152719"></p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233510097__row947114612716"><td class="cellrowborder" valign="top" headers="mcps1.3.9.4.2.4.1.1 "><p id="EN-US_TOPIC_0000001233510097__p04717465272">-12H</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.9.4.2.4.1.2 "><p id="EN-US_TOPIC_0000001233510097__p947114611276">-12:00:00</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0000001233510097__p24711646162711">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233510097__screen20914027202820"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span>
<span class="normal">23</span>
<span class="normal">24</span>
<span class="normal">25</span></pre></div></td><td class="code"><div><pre><span></span><span class="c1">-- Create a table.</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">reltime_type_tab</span><span class="p">(</span><span class="n">col1</span><span class="w"> </span><span class="nb">character</span><span class="p">(</span><span class="mi">30</span><span class="p">),</span><span class="w"> </span><span class="n">col2</span><span class="w"> </span><span class="n">reltime</span><span class="p">);</span>
<span class="c1">-- Insert data.</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">reltime_type_tab</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="s1">'90'</span><span class="p">,</span><span class="w"> </span><span class="s1">'90'</span><span class="p">);</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">reltime_type_tab</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="s1">'-366'</span><span class="p">,</span><span class="w"> </span><span class="s1">'-366'</span><span class="p">);</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">reltime_type_tab</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="s1">'1975.25'</span><span class="p">,</span><span class="w"> </span><span class="s1">'1975.25'</span><span class="p">);</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">reltime_type_tab</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="s1">'-2 YEARS +5 MONTHS 10 DAYS'</span><span class="p">,</span><span class="w"> </span><span class="s1">'-2 YEARS +5 MONTHS 10 DAYS'</span><span class="p">);</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">reltime_type_tab</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="s1">'30 DAYS 12:00:00'</span><span class="p">,</span><span class="w"> </span><span class="s1">'30 DAYS 12:00:00'</span><span class="p">);</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">reltime_type_tab</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="s1">'P-1.1Y10M'</span><span class="p">,</span><span class="w"> </span><span class="s1">'P-1.1Y10M'</span><span class="p">);</span>
<span class="c1">-- View data.</span>
<span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">reltime_type_tab</span><span class="p">;</span>
<span class="w"> </span><span class="n">col1</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">col2</span><span class="w"> </span>
<span class="c1">--------------------------------+-------------------------------------</span>
<span class="w"> </span><span class="mi">1975</span><span class="p">.</span><span class="mi">25</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">5</span><span class="w"> </span><span class="n">years</span><span class="w"> </span><span class="mi">4</span><span class="w"> </span><span class="n">mons</span><span class="w"> </span><span class="mi">29</span><span class="w"> </span><span class="n">days</span>
<span class="w"> </span><span class="o">-</span><span class="mi">2</span><span class="w"> </span><span class="n">YEARS</span><span class="w"> </span><span class="o">+</span><span class="mi">5</span><span class="w"> </span><span class="n">MONTHS</span><span class="w"> </span><span class="mi">10</span><span class="w"> </span><span class="n">DAYS</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">-</span><span class="mi">1</span><span class="w"> </span><span class="n">years</span><span class="w"> </span><span class="o">-</span><span class="mi">6</span><span class="w"> </span><span class="n">mons</span><span class="w"> </span><span class="o">-</span><span class="mi">25</span><span class="w"> </span><span class="n">days</span><span class="w"> </span><span class="o">-</span><span class="mi">06</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span>
<span class="w"> </span><span class="n">P</span><span class="o">-</span><span class="mi">1</span><span class="p">.</span><span class="mi">1</span><span class="n">Y10M</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">-</span><span class="mi">3</span><span class="w"> </span><span class="n">mons</span><span class="w"> </span><span class="o">-</span><span class="mi">5</span><span class="w"> </span><span class="n">days</span><span class="w"> </span><span class="o">-</span><span class="mi">06</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span>
<span class="w"> </span><span class="o">-</span><span class="mi">366</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">-</span><span class="mi">1</span><span class="w"> </span><span class="n">years</span><span class="w"> </span><span class="o">-</span><span class="mi">18</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span>
<span class="w"> </span><span class="mi">90</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">3</span><span class="w"> </span><span class="n">mons</span>
<span class="w"> </span><span class="mi">30</span><span class="w"> </span><span class="n">DAYS</span><span class="w"> </span><span class="mi">12</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="n">mon</span><span class="w"> </span><span class="mi">12</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">6</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
<span class="c1">-- Delete tables.</span>
<span class="k">DROP</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">reltime_type_tab</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0008.html">Data Types</a></div>
</div>
</div>
View Git Blame Copy Permalink