doc-exports/docs/dws/dev/dws_06_0035.html
Lu, Huayi a24ca60074 DWS DEVELOPER 811 version
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2023-01-19 13:37:49 +00:00

1464 lines
167 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<a name="EN-US_TOPIC_0000001099150944"></a><a name="EN-US_TOPIC_0000001099150944"></a>
<h1 class="topictitle1">Date and Time Processing Functions and Operators</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001099150944__sa4ff9d16bc80420db551f4f9f8c80161"><h4 class="sectiontitle">Date and Time Operators</h4><div class="warning" id="EN-US_TOPIC_0000001099150944__nf5abf2bc432f4b3c8fdf6c720f31e08c"><span class="warningtitle"><img src="public_sys-resources/warning_3.0-en-us.png"> </span><div class="warningbody"><p id="EN-US_TOPIC_0000001099150944__a26dffac09780468285dea67f95b5e888">When the user uses date/time operators, explicit type prefixes are modified for corresponding operands to ensure that the operands parsed by the database are consistent with what the user expects, and no unexpected results occur.</p>
<p id="EN-US_TOPIC_0000001099150944__ad150ae005da54b74a0af7db82b50a0d5">For example, abnormal mistakes will occur in the following example without an explicit data type.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s3a3a796558af403e8953cd04d3574ceb"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">date</span><span class="w"> </span><span class="s1">'2001-10-01'</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="s1">'7'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</div></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001099150944__t655afb3fb598412dbb7b1bba2554860d" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Time and date operators</caption><thead align="left"><tr id="EN-US_TOPIC_0000001099150944__rc180008c99d042738e794490060ef2d3"><th align="left" class="cellrowborder" valign="top" width="8%" id="mcps1.3.2.2.3.1.1"><p id="EN-US_TOPIC_0000001099150944__a00e9e1e176ed4b6d8120a31708e001f3">Operators</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="92%" id="mcps1.3.2.2.3.1.2"><p id="EN-US_TOPIC_0000001099150944__aec67bddd35174de9a91c88aeded5b29b">Examples</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001099150944__raab0f820fcde4608943c8f90634b9092"><td class="cellrowborder" rowspan="7" valign="top" width="8%" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__ae814dc250ce44e0682605d00ca3d0269">+</p>
</td>
<td class="cellrowborder" valign="top" width="92%" headers="mcps1.3.2.2.3.1.2 "><p id="EN-US_TOPIC_0000001099150944__p15607103722517">Add a date with an integer to obtain the date after 7 days.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s4b812aee65174bb582c643110c0079fe"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">date</span><span class="w"> </span><span class="s1">'2001-09-28'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nb">integer</span><span class="w"> </span><span class="s1">'7'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2001</span><span class="o">-</span><span class="mi">10</span><span class="o">-</span><span class="mi">05</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__rd841aea8b9764360bf4a74ddd92b9f00"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p69841941112813">Add a date with an interval to obtain the time after 1 hour.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sd5d89ea272a845a492ef95d227836b1f"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">date</span><span class="w"> </span><span class="s1">'2001-09-28'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 hour'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2001</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">28</span><span class="w"> </span><span class="mi">01</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__r0334b32f0dca4489977bf5799864e889"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p188701258163512">Add a date with a time to obtain a specific time.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sf45826a416d24d33b9401196401b7df1"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">date</span><span class="w"> </span><span class="s1">'2001-09-28'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="k">time</span><span class="w"> </span><span class="s1">'03:00'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2001</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">28</span><span class="w"> </span><span class="mi">03</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row10212193815383"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p13563143161511">Add a date with an interval to obtain the time after one month.</p>
<p id="EN-US_TOPIC_0000001099150944__p1876480153215">If the sum or subtraction results fall beyond the date range of a month, the result will be rounded to the last day of the month.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__screen2382102293"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">date</span><span class="w"> </span><span class="s1">'2021-01-31'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 month'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"></span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2021</span><span class="o">-</span><span class="mi">02</span><span class="o">-</span><span class="mi">28</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__screen41307317339"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">date</span><span class="w"> </span><span class="s1">'2021-02-28'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 month'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"></span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2021</span><span class="o">-</span><span class="mi">03</span><span class="o">-</span><span class="mi">28</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__r9666917681d9411391e6d91da94cdd15"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p393719282183">Add two intervals to obtain the sum.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s849214c960574848b7eb26e65664826d"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 day'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 hour'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">----------------</span>
<span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="k">day</span><span class="w"> </span><span class="mi">01</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__r5bbcf4a20e8c40aea5ac237a74ba4286"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p2990163314186">Add a timestamp with an interval to obtain the time after 23 hours.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s6f12fa1379e74a52968b279848a57210"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'2001-09-28 01:00'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'23 hours'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2001</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">29</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__r06d2030f4e554278b5932c46bee23d39"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p15274105851817">Add a time with an interval to obtain the time after three hours.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s6cb557002cfa42af802ed877b761c0fd"><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></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">'01:00'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'3 hours'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</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">00</span><span class="p">:</span><span class="mi">00</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__rc6ef9fcbc47f4a32a828dc957a88bc45"><td class="cellrowborder" rowspan="9" valign="top" width="8%" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__aa8d10b628cf54725a88e56ab53590423">-</p>
</td>
<td class="cellrowborder" valign="top" width="92%" headers="mcps1.3.2.2.3.1.2 "><p id="EN-US_TOPIC_0000001099150944__p415634715286">Subtract a date from another to obtain the difference.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sf6722291d9e2482c8c8fab32e8cf70cc"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">date</span><span class="w"> </span><span class="s1">'2001-10-01'</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="nb">date</span><span class="w"> </span><span class="s1">'2001-09-28'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">3</span><span class="w"> </span><span class="n">days</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__r6a9ead6945f04246b2d129bc1f704770"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p58361851102814">Subtract an integer from a date, the return is a timestamp type.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sed026bd88e0942349b5b15594acf60d9"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">date</span><span class="w"> </span><span class="s1">'2001-10-01'</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="nb">integer</span><span class="w"> </span><span class="s1">'7'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2001</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">24</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__r558d2c27d2074e879d42035fb6660ef7"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1352215565289">Subtract an interval from a date to obtain the time difference.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s6d994b05c9c54161bf74cacae634ec10"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">date</span><span class="w"> </span><span class="s1">'2001-09-28'</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 hour'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2001</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">27</span><span class="w"> </span><span class="mi">23</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__r89b2506550e94508bd9371d16cdc7634"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p146576014297">Subtract a time from another time to obtain the time difference.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s79d25af6be1b4d93a8fd0f290f4c125e"><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></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">'05:00'</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="k">time</span><span class="w"> </span><span class="s1">'03:00'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="mi">02</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__r63f87b6e4e874ec0803e7094d3e3d2bf"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1329174122911">Subtract an interval from a time to obtain the time difference.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s3610b1313da04a769d256a786bde2c5f"><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></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">'05:00'</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'2 hours'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="mi">03</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__rb3be3a35f2a54cafae118bbc8f88b7b0"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p765318172913">Subtract an interval from a timestamp to obtain the date difference.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sc94cad01869d42d08456dc7e5842641a"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'2001-09-28 23:00'</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'23 hours'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2001</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">28</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__rc1a8aaaedcc842a4a4b6bd8864e9b8ed"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p16700343145411">Subtract an interval from another interval to obtain the time difference.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s71882b787f234b688b957156c384dc57"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 day'</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 hour'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="mi">23</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row72751923182012"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p422894919546">Subtract a timestamp from another timestamp to obtain the time difference.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__screen459863416207"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'2001-09-29 03:00'</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'2001-09-27 12:00'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">----------------</span>
<span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="k">day</span><span class="w"> </span><span class="mi">15</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__r1011e50d830e4165abf26316924626f4"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1191128143917">Obtain the time at the previous day.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__screen677203018209"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">select</span><span class="w"> </span><span class="n">now</span><span class="p">()</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 day'</span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"></span>
<span class="c1">-------------------------------</span>
<span class="w"> </span><span class="mi">2022</span><span class="o">-</span><span class="mi">08</span><span class="o">-</span><span class="mi">08</span><span class="w"> </span><span class="mi">01</span><span class="p">:</span><span class="mi">46</span><span class="p">:</span><span class="mi">15</span><span class="p">.</span><span class="mi">555406</span><span class="o">+</span><span class="mi">00</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__r1451e8564f8d4aef82e101dda9086e31"><td class="cellrowborder" rowspan="3" valign="top" width="8%" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__a9cd9faf75f9340a99c16625ce4eacdf3">*</p>
</td>
<td class="cellrowborder" valign="top" width="92%" headers="mcps1.3.2.2.3.1.2 "><p id="EN-US_TOPIC_0000001099150944__p85551437171212">Multiply an interval by a quantity:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sb3a61e1ef63b4340a987d746734578e0"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="mi">900</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 second'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="mi">00</span><span class="p">:</span><span class="mi">15</span><span class="p">:</span><span class="mi">00</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__rbb9e1b53db604497b9f5fcd79e5f3dd9"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s47d995137862447594f6e0e7a64f0c34"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="mi">21</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 day'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------</span>
<span class="w"> </span><span class="mi">21</span><span class="w"> </span><span class="n">days</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__ra957c6916bd34ab39b559954985e9237"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.3.1.1 "><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sdb5c65fb9e984d3fb330dc9def27e403"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">double</span><span class="w"> </span><span class="k">precision</span><span class="w"> </span><span class="s1">'3.5'</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 hour'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="mi">03</span><span class="p">:</span><span class="mi">30</span><span class="p">:</span><span class="mi">00</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__r26bc4200b9624354acf8f3d5dd3c580d"><td class="cellrowborder" valign="top" width="8%" headers="mcps1.3.2.2.3.1.1 "><p id="EN-US_TOPIC_0000001099150944__adb6e702ad3ef460e973dd92d7d3f4291">/</p>
</td>
<td class="cellrowborder" valign="top" width="92%" headers="mcps1.3.2.2.3.1.2 "><p id="EN-US_TOPIC_0000001099150944__p14521132561010">Divide an interval by a quantity to obtain a time segment.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__se54eef4090c24273a49bec06a20c8481"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 hour'</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="n">double</span><span class="w"> </span><span class="k">precision</span><span class="w"> </span><span class="s1">'1.5'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="mi">00</span><span class="p">:</span><span class="mi">40</span><span class="p">:</span><span class="mi">00</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="EN-US_TOPIC_0000001099150944__s4407fdacc1724beda8f698fafe65a4f9"><h4 class="sectiontitle">Time/Date functions</h4><ul id="EN-US_TOPIC_0000001099150944__u876a0fb4ac484ef8a1882657b40f83d7"><li id="EN-US_TOPIC_0000001099150944__l77cb9aee82f34b59abc483907d77f94b">age(timestamp, timestamp)<p id="EN-US_TOPIC_0000001099150944__ac41b0605a8e049c0b0a995d392ebb1dd"><a name="EN-US_TOPIC_0000001099150944__l77cb9aee82f34b59abc483907d77f94b"></a><a name="l77cb9aee82f34b59abc483907d77f94b"></a>Description: Subtracts arguments, producing a result in YYYY-MM-DD format. If the result is negative, the returned result is also negative.</p>
<p id="EN-US_TOPIC_0000001099150944__ab9e70d85a7fa43edaa06f2eda1014b82">Return type: interval</p>
<p id="EN-US_TOPIC_0000001099150944__a5da71350c87440028ffa8d24e3c17cf6">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s8b964ac2ad22485985831df921b67081"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">age</span><span class="p">(</span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'2001-04-10'</span><span class="p">,</span><span class="w"> </span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'1957-06-13'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">age</span><span class="w"> </span>
<span class="c1">-------------------------</span>
<span class="w"> </span><span class="mi">43</span><span class="w"> </span><span class="n">years</span><span class="w"> </span><span class="mi">9</span><span class="w"> </span><span class="n">mons</span><span class="w"> </span><span class="mi">27</span><span class="w"> </span><span class="n">days</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l694d844a60454af797471a2f7a036128">age(timestamp)<p id="EN-US_TOPIC_0000001099150944__a37c97294cffe4f7e876a4d6b3c8c46d8"><a name="EN-US_TOPIC_0000001099150944__l694d844a60454af797471a2f7a036128"></a><a name="l694d844a60454af797471a2f7a036128"></a>Description: Subtracts from <strong id="EN-US_TOPIC_0000001099150944__en-us_topic_0058965855_b842352706104556">current_date</strong></p>
<p id="EN-US_TOPIC_0000001099150944__a0024e23426374fcebb7b644ccc15431f">Return type: interval</p>
<p id="EN-US_TOPIC_0000001099150944__aea569c880b5a4e6285e0d12b6e8d7a76">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__scc13c7e1614b4b43b8ec01ba17cf3354"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">age</span><span class="p">(</span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'1957-06-13'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">age</span><span class="w"> </span>
<span class="c1">-------------------------</span>
<span class="w"> </span><span class="mi">60</span><span class="w"> </span><span class="n">years</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="n">mons</span><span class="w"> </span><span class="mi">18</span><span class="w"> </span><span class="n">days</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__li789946175814">timestampdiff(field, timestamp1, timestamp2)<p id="EN-US_TOPIC_0000001099150944__p134009121903"><a name="EN-US_TOPIC_0000001099150944__li789946175814"></a><a name="li789946175814"></a>Description: Subtracts <strong id="EN-US_TOPIC_0000001099150944__b1990344022712">timestamp1</strong> from <strong id="EN-US_TOPIC_0000001099150944__b1355314436270">timestamp2</strong> and returns the difference in the unit of <strong id="EN-US_TOPIC_0000001099150944__b148891649162715">field</strong>. If the difference is negative, this function returns it normally. The <strong id="EN-US_TOPIC_0000001099150944__b16924194943016">field</strong> can be <strong id="EN-US_TOPIC_0000001099150944__b17522125583015">day</strong>, <strong id="EN-US_TOPIC_0000001099150944__b55111458163016">month</strong>, <strong id="EN-US_TOPIC_0000001099150944__b13417228313">quarter</strong>, <strong id="EN-US_TOPIC_0000001099150944__b13406543120">day</strong>, <strong id="EN-US_TOPIC_0000001099150944__b28717783117">week</strong>, <strong id="EN-US_TOPIC_0000001099150944__b688281015314">hour</strong>, <strong id="EN-US_TOPIC_0000001099150944__b10786201403116">minute</strong>, <strong id="EN-US_TOPIC_0000001099150944__b341613180317">second</strong>, or <strong id="EN-US_TOPIC_0000001099150944__b189301222123116">microsecond</strong>.</p>
<p id="EN-US_TOPIC_0000001099150944__p740014127017">Return type: bigint</p>
<p id="EN-US_TOPIC_0000001099150944__p740014121608">For example:</p>
<pre class="screen" id="EN-US_TOPIC_0000001099150944__screen245120519815"><span id="EN-US_TOPIC_0000001099150944__text166018559128"></span>SELECT timestampdiff(day, timestamp '2001-02-01', timestamp '2003-05-01 12:05:55');
timestampdiff
---------------
819
(1 row)</pre>
</li><li id="EN-US_TOPIC_0000001099150944__l0b4160f178d5452b97e866a9968b6638">clock_timestamp()<p id="EN-US_TOPIC_0000001099150944__ab305ba3b389e4d3fb204bdfe20f95d74"><a name="EN-US_TOPIC_0000001099150944__l0b4160f178d5452b97e866a9968b6638"></a><a name="l0b4160f178d5452b97e866a9968b6638"></a>Description: Specifies the current timestamp of the real-time clock.</p>
<p id="EN-US_TOPIC_0000001099150944__a713e38a1bdc24781839bffedee7d0d3b">Return type: timestamp with time zone</p>
<p id="EN-US_TOPIC_0000001099150944__ae46c903bc35344d6b52f895782264341">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sc81945acfa6641388403c6bed39fc606"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">clock_timestamp</span><span class="p">();</span><span class="w"></span>
<span class="w"> </span><span class="n">clock_timestamp</span><span class="w"> </span>
<span class="c1">-------------------------------</span>
<span class="w"> </span><span class="mi">2017</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">01</span><span class="w"> </span><span class="mi">16</span><span class="p">:</span><span class="mi">57</span><span class="p">:</span><span class="mi">36</span><span class="p">.</span><span class="mi">636205</span><span class="o">+</span><span class="mi">08</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l09d627b8d4a048aaabd4b20556cd7165">current_date<p id="EN-US_TOPIC_0000001099150944__af22bae86220d4534a0a99cbd502a9880"><a name="EN-US_TOPIC_0000001099150944__l09d627b8d4a048aaabd4b20556cd7165"></a><a name="l09d627b8d4a048aaabd4b20556cd7165"></a>Description: Current date</p>
<p id="EN-US_TOPIC_0000001099150944__a5ac6d8b9850c480ea6f67ad6a60d7dbf">Return type: date</p>
<p id="EN-US_TOPIC_0000001099150944__a3221672fada547e98795ea4ba71463fc">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s94edd8bbd74f4091a82300a891eb0814"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">current_date</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="nb">date</span><span class="w"> </span>
<span class="c1">------------</span>
<span class="w"> </span><span class="mi">2017</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">01</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l2979016975e647a98f6b32bfb38a8c1a">current_time<p id="EN-US_TOPIC_0000001099150944__aaacb7ab6bb694b7fa9248bad3539ebc4"><a name="EN-US_TOPIC_0000001099150944__l2979016975e647a98f6b32bfb38a8c1a"></a><a name="l2979016975e647a98f6b32bfb38a8c1a"></a>Description: Current time</p>
<p id="EN-US_TOPIC_0000001099150944__a076f8c648a194e6cb8e2b77d0c962fc8">Return type: time with time zone</p>
<p id="EN-US_TOPIC_0000001099150944__a935af1cb55f3443aa3957bed3415ed9b">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s9a197bd84f784f7c83aa4a5ac2961c8a"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">current_time</span><span class="p">;</span><span class="w"></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">16</span><span class="p">:</span><span class="mi">58</span><span class="p">:</span><span class="mi">07</span><span class="p">.</span><span class="mi">086215</span><span class="o">+</span><span class="mi">08</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l8dcecc8e79bd42a79721f42ed0b24bc7">current_timestamp<p id="EN-US_TOPIC_0000001099150944__ae87b2b540aad42cd9b97a9e138f1728b"><a name="EN-US_TOPIC_0000001099150944__l8dcecc8e79bd42a79721f42ed0b24bc7"></a><a name="l8dcecc8e79bd42a79721f42ed0b24bc7"></a>Description: Specifies the current date and time.</p>
<p id="EN-US_TOPIC_0000001099150944__aeeec2a750a8d4218866e9617e41c825e">Return type: timestamp with time zone</p>
<p id="EN-US_TOPIC_0000001099150944__a3b8cb39270e546888d53e5302c2f8cab">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s806dc11cd3934660b7a415af32003424"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">current_timestamp</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="n">pg_systimestamp</span><span class="w"> </span>
<span class="c1">------------------------------</span>
<span class="w"> </span><span class="mi">2017</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">01</span><span class="w"> </span><span class="mi">16</span><span class="p">:</span><span class="mi">58</span><span class="p">:</span><span class="mi">19</span><span class="p">.</span><span class="mi">22173</span><span class="o">+</span><span class="mi">08</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l94cd0a7eab414b8b921afd431dfa4720">date_part(text, timestamp)<p id="EN-US_TOPIC_0000001099150944__a523de77d68b44e9c896db2d74d6e5477"><a name="EN-US_TOPIC_0000001099150944__l94cd0a7eab414b8b921afd431dfa4720"></a><a name="l94cd0a7eab414b8b921afd431dfa4720"></a>Description:</p>
<p id="EN-US_TOPIC_0000001099150944__a812657c3fbed42feb5d3740a7480e076">Description: Obtains the hour.</p>
<p id="EN-US_TOPIC_0000001099150944__a438c42d6a1f340a9ac377fb8dde42dbb">Equivalent to <strong id="EN-US_TOPIC_0000001099150944__en-us_topic_0058965855_b842352706103558_3">extract(field from timestamp)</strong>.</p>
<p id="EN-US_TOPIC_0000001099150944__ae685b7c652ec426bb6b7eecc99f01dd8">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001099150944__a12343112833c4c7ca94d9f5430570882">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s55d2e371a9ac4e7a9a26a2788b78fbae"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">date_part</span><span class="p">(</span><span class="s1">'hour'</span><span class="p">,</span><span class="w"> </span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">20</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__lcbadb09ef7c24de79577de12cd7e5a1c">date_part(text, interval)<p id="EN-US_TOPIC_0000001099150944__a86c2d8ca1750455cb126194f9c87d651"><a name="EN-US_TOPIC_0000001099150944__lcbadb09ef7c24de79577de12cd7e5a1c"></a><a name="lcbadb09ef7c24de79577de12cd7e5a1c"></a>Description:</p>
<p id="EN-US_TOPIC_0000001099150944__a16b13f2b6e8f41bb949f35ff00061645">Obtains the month. If the value is greater than 12, obtain the remainder after it is divided by 12.</p>
<p id="EN-US_TOPIC_0000001099150944__a88574f7c33c04acaaf0ce621ee91a7b4">Equivalent to <strong id="EN-US_TOPIC_0000001099150944__b1973188601">extract(field from timestamp)</strong>.</p>
<p id="EN-US_TOPIC_0000001099150944__a2f1b8d7b93814d37aa4c22d957ca88f4">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001099150944__aa3c4538e0bee415a865c05b75527bdb2">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__scc1aadca003f473d862a1855238d2835"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">date_part</span><span class="p">(</span><span class="s1">'month'</span><span class="p">,</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'2 years 3 months'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">3</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__ldffe7ecad14648eab3c70b8d06568eef">date_trunc(text, timestamp)<p id="EN-US_TOPIC_0000001099150944__a1698aef0c83343f4a34ca5a99721208d"><a name="EN-US_TOPIC_0000001099150944__ldffe7ecad14648eab3c70b8d06568eef"></a><a name="ldffe7ecad14648eab3c70b8d06568eef"></a>Description: Truncates to the precision specified by <strong id="EN-US_TOPIC_0000001099150944__b8423527061825">text</strong>.</p>
<p id="EN-US_TOPIC_0000001099150944__a226672c07b5e40cf829ef8c5e82f345b">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001099150944__a594277b6f7774ecc934a045ba3aeb0b2">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s73c49171be364f1a96a52d0fd2416e02"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">date_trunc</span><span class="p">(</span><span class="s1">'hour'</span><span class="p">,</span><span class="w"> </span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_trunc</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2001</span><span class="o">-</span><span class="mi">02</span><span class="o">-</span><span class="mi">16</span><span class="w"> </span><span class="mi">20</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__li585692513377">trunc(timestamp)<p id="EN-US_TOPIC_0000001099150944__p1849614510377"><a name="EN-US_TOPIC_0000001099150944__li585692513377"></a><a name="li585692513377"></a>Description: By default, the data is intercepted by day.</p>
<p id="EN-US_TOPIC_0000001099150944__p5814123412386">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__screen12672171215111"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">trunc</span><span class="p">(</span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"> </span><span class="n">trunc</span><span class="w"></span>
<span class="c1">---------------------</span>
<span class="mi">2001</span><span class="o">-</span><span class="mi">02</span><span class="o">-</span><span class="mi">16</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__lc801444f92d1455d9990eccc185f26bc">extract(field from timestamp)<p id="EN-US_TOPIC_0000001099150944__afa04826eee1841c4b6cf6f6b0725d68c"><a name="EN-US_TOPIC_0000001099150944__lc801444f92d1455d9990eccc185f26bc"></a><a name="lc801444f92d1455d9990eccc185f26bc"></a>Description: Obtains the hour.</p>
<p id="EN-US_TOPIC_0000001099150944__aa113a3e7d97b44638619c925f496c3c6">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001099150944__a2567787cc778448ea8997beb92f642d8">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s6d369891dbcf4bc58b8b7d22b260c352"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">extract</span><span class="p">(</span><span class="n">hour</span><span class="w"> </span><span class="k">from</span><span class="w"> </span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">20</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__ld6fd1263c4b0472db0675a51d334250d">extract(field from interval)<p id="EN-US_TOPIC_0000001099150944__a1aa85464f0d342a8a91ef536f9750662"><a name="EN-US_TOPIC_0000001099150944__ld6fd1263c4b0472db0675a51d334250d"></a><a name="ld6fd1263c4b0472db0675a51d334250d"></a>Description: Obtains the month. If the value is greater than 12, obtain the remainder after it is divided by 12.</p>
<p id="EN-US_TOPIC_0000001099150944__a748b45bfc8df46168fbf9c17358097e3">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001099150944__aa4a696f3723340a8a373406aa3d7b131">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s9dc044782f0c465da9639a473a9f7741"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">extract</span><span class="p">(</span><span class="k">month</span><span class="w"> </span><span class="k">from</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'2 years 3 months'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">3</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__la08757200dfd4beeb08331c80336a169">isfinite(date)<p id="EN-US_TOPIC_0000001099150944__a3463e0d50ee240b19abb15f2d29f444c"><a name="EN-US_TOPIC_0000001099150944__la08757200dfd4beeb08331c80336a169"></a><a name="la08757200dfd4beeb08331c80336a169"></a>Description: Tests for valid date.</p>
<p id="EN-US_TOPIC_0000001099150944__a4c75d2025ec84f14b910d31ff6482e76">Return type: <span id="EN-US_TOPIC_0000001099150944__text1446316316483">boolean</span></p>
<p id="EN-US_TOPIC_0000001099150944__aee66dfe406d540dea656659d4c3e78f3">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s73c3715157e247bfb5b3ccec456260a4"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">isfinite</span><span class="p">(</span><span class="nb">date</span><span class="w"> </span><span class="s1">'2001-02-16'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">isfinite</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="n">t</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__lc85d34963b404994ab2b30440647343b">isfinite(timestamp)<p id="EN-US_TOPIC_0000001099150944__aa0b99063538d4027b28ff149c308ace2"><a name="EN-US_TOPIC_0000001099150944__lc85d34963b404994ab2b30440647343b"></a><a name="lc85d34963b404994ab2b30440647343b"></a>Description: Tests for valid timestamp.</p>
<p id="EN-US_TOPIC_0000001099150944__ada16a0980f0a47b491e81f9c65efec53">Return type: <span id="EN-US_TOPIC_0000001099150944__text6588213104812">boolean</span></p>
<p id="EN-US_TOPIC_0000001099150944__aa8469b508ae04c8f8151a3174f878e59">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__se07bb238d95c43a98e5d9879c2b34660"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">isfinite</span><span class="p">(</span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'2001-02-16 21:28:30'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">isfinite</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="n">t</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l9f88557fcffb4eec9b3886cdabd71f32">isfinite(interval)<p id="EN-US_TOPIC_0000001099150944__ab55621e08ce84f5eaaba0b9d82799daf"><a name="EN-US_TOPIC_0000001099150944__l9f88557fcffb4eec9b3886cdabd71f32"></a><a name="l9f88557fcffb4eec9b3886cdabd71f32"></a>Description: Tests for valid interval.</p>
<p id="EN-US_TOPIC_0000001099150944__a4669503e1af844bc8d0b5884f33493f8">Return type: <span id="EN-US_TOPIC_0000001099150944__text1177417196485">boolean</span></p>
<p id="EN-US_TOPIC_0000001099150944__a3cfb3d7cee8245969006feca631a5e6e">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s153a6e305d844444acfceebb30d8bc35"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">isfinite</span><span class="p">(</span><span class="nb">interval</span><span class="w"> </span><span class="s1">'4 hours'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">isfinite</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="n">t</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l37728bb596254fb8842c729a3c4bd5f2">justify_days(interval)<p id="EN-US_TOPIC_0000001099150944__a6550aaa0dd284b379d24c030887d40ca"><a name="EN-US_TOPIC_0000001099150944__l37728bb596254fb8842c729a3c4bd5f2"></a><a name="l37728bb596254fb8842c729a3c4bd5f2"></a>Description: Adjusts interval to 30-day time periods are represented as months</p>
<p id="EN-US_TOPIC_0000001099150944__a69b6b8878d234a59935bc7c98051f73f">Return type: interval</p>
<p id="EN-US_TOPIC_0000001099150944__a6b8c7dcd085d41e88fb7845c39759535">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__scb9324c42a374a5480cfd8fe774228b4"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">justify_days</span><span class="p">(</span><span class="nb">interval</span><span class="w"> </span><span class="s1">'35 days'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">justify_days</span><span class="w"> </span>
<span class="c1">--------------</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">5</span><span class="w"> </span><span class="n">days</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l4a14068a46094ee0bfa666a1bb5f4d29">justify_hours(interval)<p id="EN-US_TOPIC_0000001099150944__a268ca66a2bd2479e868d2806e6526912"><a name="EN-US_TOPIC_0000001099150944__l4a14068a46094ee0bfa666a1bb5f4d29"></a><a name="l4a14068a46094ee0bfa666a1bb5f4d29"></a>Description: Adjusts interval to 24-hour time periods are represented as days</p>
<p id="EN-US_TOPIC_0000001099150944__a4c7577c005b646e6837c658b037186cf">Return type: interval</p>
<p id="EN-US_TOPIC_0000001099150944__aa453d2b410bf49468fd015b3112d5735">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s8570e03021464b0a89f2b712e9a73f9a"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">JUSTIFY_HOURS</span><span class="p">(</span><span class="nb">INTERVAL</span><span class="w"> </span><span class="s1">'27 HOURS'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">justify_hours</span><span class="w"> </span>
<span class="c1">----------------</span>
<span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="k">day</span><span class="w"> </span><span class="mi">03</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__lc5342c3c73844465a9aa322dde5457fe">justify_interval(interval)<p id="EN-US_TOPIC_0000001099150944__aa06f170e991b4194a95b8a10a6235c98"><a name="EN-US_TOPIC_0000001099150944__lc5342c3c73844465a9aa322dde5457fe"></a><a name="lc5342c3c73844465a9aa322dde5457fe"></a>Description: Adjusts <strong id="EN-US_TOPIC_0000001099150944__b961682234">interval</strong> using <strong id="EN-US_TOPIC_0000001099150944__b46210818232">justify_days</strong> and <strong id="EN-US_TOPIC_0000001099150944__b6633816238">justify_hours</strong>.</p>
<p id="EN-US_TOPIC_0000001099150944__a45446786cbdf44f38f5d358b37f8fca1">Return type: interval</p>
<p id="EN-US_TOPIC_0000001099150944__a94c7dc7b2f20479bb843fb05bb27efd3">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sdc9ef8881faa435daec26e6def7f3e40"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">JUSTIFY_INTERVAL</span><span class="p">(</span><span class="nb">INTERVAL</span><span class="w"> </span><span class="s1">'1 MON -1 HOUR'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">justify_interval</span><span class="w"> </span>
<span class="c1">------------------</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="mi">23</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__ld3b089af810b4ed295dcf774760510a0">localtime<p id="EN-US_TOPIC_0000001099150944__adf7e9173feb645dbb0b19e905f52cfd1"><a name="EN-US_TOPIC_0000001099150944__ld3b089af810b4ed295dcf774760510a0"></a><a name="ld3b089af810b4ed295dcf774760510a0"></a>Description: Current time</p>
<p id="EN-US_TOPIC_0000001099150944__a154a8bc6fdd64e28ba3ecffd6e4c6267">Return type: time</p>
<p id="EN-US_TOPIC_0000001099150944__aa3dd37500f3a465da5b6636d98e70bb1">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s56c0375f77ea4298b4b3923daeccacbe"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">localtime</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"></span>
<span class="c1">----------------</span>
<span class="w"> </span><span class="mi">16</span><span class="p">:</span><span class="mi">05</span><span class="p">:</span><span class="mi">55</span><span class="p">.</span><span class="mi">664681</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l70a7a369b1be40b5bb1a5a7016aa307e">localtimestamp<p id="EN-US_TOPIC_0000001099150944__a46099442f78144a0963318ead70ae762"><a name="EN-US_TOPIC_0000001099150944__l70a7a369b1be40b5bb1a5a7016aa307e"></a><a name="l70a7a369b1be40b5bb1a5a7016aa307e"></a>Description: Specifies the current date and time.</p>
<p id="EN-US_TOPIC_0000001099150944__a38ef5674c05b48f6992d655f174e1d89">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001099150944__addca4b23adbc4049bed0c7c6cdd34674">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sc83a6946ac8548bbb5b96c0453508b4a"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">localtimestamp</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">timestamp</span><span class="w"> </span>
<span class="c1">----------------------------</span>
<span class="w"> </span><span class="mi">2017</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">01</span><span class="w"> </span><span class="mi">17</span><span class="p">:</span><span class="mi">03</span><span class="p">:</span><span class="mi">30</span><span class="p">.</span><span class="mi">781902</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__le00349de454c4975940c65756b5a3e66">now()<p id="EN-US_TOPIC_0000001099150944__a94bdc87643c5434eb25f35cfae71e3b5"><a name="EN-US_TOPIC_0000001099150944__le00349de454c4975940c65756b5a3e66"></a><a name="le00349de454c4975940c65756b5a3e66"></a>Description: Timestamp indicating the start of the current transaction.</p>
<p id="EN-US_TOPIC_0000001099150944__ae4a9969ab8994f1483f2a8ae8d789eb7">Return type: timestamp with time zone</p>
<p id="EN-US_TOPIC_0000001099150944__a5be2a4466fda417097a751e89d482ad4">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s58a9b1e8e1de4cf2976a7d7fe9c8ac75"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">now</span><span class="p">();</span><span class="w"></span>
<span class="w"> </span><span class="n">now</span><span class="w"> </span>
<span class="c1">-------------------------------</span>
<span class="w"> </span><span class="mi">2017</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">01</span><span class="w"> </span><span class="mi">17</span><span class="p">:</span><span class="mi">03</span><span class="p">:</span><span class="mi">42</span><span class="p">.</span><span class="mi">549426</span><span class="o">+</span><span class="mi">08</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l2e6de494af134dc098380e93e5b89264">numtodsinterval(num, interval_unit)<p id="EN-US_TOPIC_0000001099150944__a2f23d38e29dc472aba62234b619df9c0"><a name="EN-US_TOPIC_0000001099150944__l2e6de494af134dc098380e93e5b89264"></a><a name="l2e6de494af134dc098380e93e5b89264"></a>Description: Converts a number to the interval type. <strong id="EN-US_TOPIC_0000001099150944__b84235270620148">num</strong> is a numeric-typed number. <strong id="EN-US_TOPIC_0000001099150944__b8423527062028">interval_unit</strong> is a string in the following format: 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND'</p>
<p id="EN-US_TOPIC_0000001099150944__p656525774711">You can set the <strong id="EN-US_TOPIC_0000001099150944__b173520398163">IntervalStyle</strong> parameter to <strong id="EN-US_TOPIC_0000001099150944__b1566152815374">oracle</strong> to be compatible with the interval output format of the function in the Oracle database.</p>
<p id="EN-US_TOPIC_0000001099150944__ac371b8f3dc1a4e98abd3e23e0813b28e">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s7ee87a8f93f04bfe89922fc3017b2c22"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">numtodsinterval</span><span class="p">(</span><span class="mi">100</span><span class="p">,</span><span class="w"> </span><span class="s1">'HOUR'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">numtodsinterval</span><span class="w"> </span>
<span class="c1">-----------------</span>
<span class="w"> </span><span class="mi">100</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
<span class="k">SET</span><span class="w"> </span><span class="n">intervalstyle</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">oracle</span><span class="p">;</span><span class="w"></span>
<span class="k">SET</span><span class="w"></span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">numtodsinterval</span><span class="p">(</span><span class="mi">100</span><span class="p">,</span><span class="w"> </span><span class="s1">'HOUR'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">numtodsinterval</span><span class="w"></span>
<span class="c1">-------------------------------</span>
<span class="w"> </span><span class="o">+</span><span class="mi">000000004</span><span class="w"> </span><span class="mi">04</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">000000000</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__lf1dea7a18aa04c4e9a1da540e31b33f4">pg_sleep(seconds)<p id="EN-US_TOPIC_0000001099150944__a69bdb4897ec14d7e8600e8506a4bb4ed"><a name="EN-US_TOPIC_0000001099150944__lf1dea7a18aa04c4e9a1da540e31b33f4"></a><a name="lf1dea7a18aa04c4e9a1da540e31b33f4"></a>Description: Specifies the delay time of the server thread in unit of second.</p>
<p id="EN-US_TOPIC_0000001099150944__a5f3d26f04c2d4c5d9101e67f25f03da4">Return type: void</p>
<p id="EN-US_TOPIC_0000001099150944__a684f49c98db8499a91fffb56fa8c843a">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s3a5add43999c417d803ceec75e8d3699"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">pg_sleep</span><span class="p">(</span><span class="mi">10</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">pg_sleep</span><span class="w"> </span>
<span class="c1">----------</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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__lde150a51973a4d50a6c2b6b5778b64df">statement_timestamp()<p id="EN-US_TOPIC_0000001099150944__acc49e71fbcce44e4a07a914c2547b592"><a name="EN-US_TOPIC_0000001099150944__lde150a51973a4d50a6c2b6b5778b64df"></a><a name="lde150a51973a4d50a6c2b6b5778b64df"></a>Description: Specifies the current date and time.</p>
<p id="EN-US_TOPIC_0000001099150944__af61ce84dba2043158c0449a36c187dd1">Return type: timestamp with time zone</p>
<p id="EN-US_TOPIC_0000001099150944__a7208e0fb9e4e44c6b50ef0ee34d085f7">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s0c7a132fffa24872b87977851173b391"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">statement_timestamp</span><span class="p">();</span><span class="w"></span>
<span class="w"> </span><span class="n">statement_timestamp</span><span class="w"> </span>
<span class="c1">-------------------------------</span>
<span class="w"> </span><span class="mi">2017</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">01</span><span class="w"> </span><span class="mi">17</span><span class="p">:</span><span class="mi">04</span><span class="p">:</span><span class="mi">39</span><span class="p">.</span><span class="mi">119267</span><span class="o">+</span><span class="mi">08</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l9f974ee57ae8460e929386513c9bf6a5">sysdate<p id="EN-US_TOPIC_0000001099150944__a3626c71037664bf0b99da55ef9a9cd15"><a name="EN-US_TOPIC_0000001099150944__l9f974ee57ae8460e929386513c9bf6a5"></a><a name="l9f974ee57ae8460e929386513c9bf6a5"></a>Description: Specifies the current date and time.</p>
<p id="EN-US_TOPIC_0000001099150944__afc26df9f73234ea2affaff8e8537af76">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001099150944__a360a4e372862405196576e72687c7846">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sb886c87436034d3da3c3dc199ad4b076"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">sysdate</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="n">sysdate</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2017</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">01</span><span class="w"> </span><span class="mi">17</span><span class="p">:</span><span class="mi">04</span><span class="p">:</span><span class="mi">49</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l057a28e53b4c40d4a3a0723abcb17381">timeofday()<p id="EN-US_TOPIC_0000001099150944__acd763b9abfd6484dbf50fd0046808e2d"><a name="EN-US_TOPIC_0000001099150944__l057a28e53b4c40d4a3a0723abcb17381"></a><a name="l057a28e53b4c40d4a3a0723abcb17381"></a>Description: Current date and time (like <strong id="EN-US_TOPIC_0000001099150944__b842352706105217">clock_timestamp</strong>, but returned as a <strong id="EN-US_TOPIC_0000001099150944__b842352706105226">text</strong> string)</p>
<p id="EN-US_TOPIC_0000001099150944__acc335bbbf9ec466bb13304c4dbc6aaaf">Return type: text</p>
<p id="EN-US_TOPIC_0000001099150944__ac3e97d0f2847433b83ee4641c4465506">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s687f51a2baa14893b80cb197d7c69f7e"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">timeofday</span><span class="p">();</span><span class="w"></span>
<span class="w"> </span><span class="n">timeofday</span><span class="w"> </span>
<span class="c1">-------------------------------------</span>
<span class="w"> </span><span class="n">Fri</span><span class="w"> </span><span class="n">Sep</span><span class="w"> </span><span class="mi">01</span><span class="w"> </span><span class="mi">17</span><span class="p">:</span><span class="mi">05</span><span class="p">:</span><span class="mi">01</span><span class="p">.</span><span class="mi">167506</span><span class="w"> </span><span class="mi">2017</span><span class="w"> </span><span class="n">CST</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__ld614684efa8d4a8d9805a84ef9d541e5">transaction_timestamp()<p id="EN-US_TOPIC_0000001099150944__aa77ff81adf5341e488f4896f48e73caa"><a name="EN-US_TOPIC_0000001099150944__ld614684efa8d4a8d9805a84ef9d541e5"></a><a name="ld614684efa8d4a8d9805a84ef9d541e5"></a>Description: Current date and time (equivalent to <strong id="EN-US_TOPIC_0000001099150944__b84235270610596">current_timestamp</strong>)</p>
<p id="EN-US_TOPIC_0000001099150944__ad1e09384a2cf4cb9a280164573e6228e">Return type: timestamp with time zone</p>
<p id="EN-US_TOPIC_0000001099150944__a9530a864abf14b1f878acd34bff3cdab">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sf791ab8fe0d440f6b2d138d9436b9312"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">transaction_timestamp</span><span class="p">();</span><span class="w"></span>
<span class="w"> </span><span class="n">transaction_timestamp</span><span class="w"> </span>
<span class="c1">-------------------------------</span>
<span class="w"> </span><span class="mi">2017</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">01</span><span class="w"> </span><span class="mi">17</span><span class="p">:</span><span class="mi">05</span><span class="p">:</span><span class="mi">13</span><span class="p">.</span><span class="mi">534454</span><span class="o">+</span><span class="mi">08</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__lee66b6fa01074024808e2570ecf3ff0f">add_months(d,n)<p id="EN-US_TOPIC_0000001099150944__a724e9848c8a14877af05ddd891c58dc4"><a name="EN-US_TOPIC_0000001099150944__lee66b6fa01074024808e2570ecf3ff0f"></a><a name="lee66b6fa01074024808e2570ecf3ff0f"></a>Description: Calculates the time point day and time of nth months.</p>
<p id="EN-US_TOPIC_0000001099150944__a0a98341a35104d85aca68a8f2246c16f">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001099150944__ad93930e67d8946a5b8f72abfe1272efe">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s57fda36034a843899b23524455102e55"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">add_months</span><span class="p">(</span><span class="n">to_date</span><span class="p">(</span><span class="s1">'2017-5-29'</span><span class="p">,</span><span class="w"> </span><span class="s1">'yyyy-mm-dd'</span><span class="p">),</span><span class="w"> </span><span class="mi">11</span><span class="p">)</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">dual</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="n">add_months</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2018</span><span class="o">-</span><span class="mi">04</span><span class="o">-</span><span class="mi">29</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__laa59fd853d134d6997a3d6a0f489e32c">last_day(d)<p id="EN-US_TOPIC_0000001099150944__a51e40e97b5e24d13b77920038a9328c5"><a name="EN-US_TOPIC_0000001099150944__laa59fd853d134d6997a3d6a0f489e32c"></a><a name="laa59fd853d134d6997a3d6a0f489e32c"></a>Description: Calculates the time of the last day in the month.</p>
<ul id="EN-US_TOPIC_0000001099150944__ul16899354154517"><li id="EN-US_TOPIC_0000001099150944__li1489915444513">In the ORA- or TD-compatible mode, the return type is timestamp.</li><li id="EN-US_TOPIC_0000001099150944__li88991454104510">In the MySQL-compatible mode, the return type is date.</li></ul>
<p id="EN-US_TOPIC_0000001099150944__acab9e731ba20478c80f4cc41a2ea9904">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s37de551c2d4345548b7b1421f5d3f307"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">select</span><span class="w"> </span><span class="n">last_day</span><span class="p">(</span><span class="n">to_date</span><span class="p">(</span><span class="s1">'2017-01-01'</span><span class="p">,</span><span class="w"> </span><span class="s1">'YYYY-MM-DD'</span><span class="p">))</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="n">cal_result</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="n">cal_result</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2017</span><span class="o">-</span><span class="mi">01</span><span class="o">-</span><span class="mi">31</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<ul id="EN-US_TOPIC_0000001099150944__ub209c949949945d8aabe0187ed013ae9"><li id="EN-US_TOPIC_0000001099150944__l75e2a76a02cc437890bbb1fc81eb6cfc">next_day(x,y)<p id="EN-US_TOPIC_0000001099150944__ac55d7d696bbb4b0fb06aabd2529a468d"><a name="EN-US_TOPIC_0000001099150944__l75e2a76a02cc437890bbb1fc81eb6cfc"></a><a name="l75e2a76a02cc437890bbb1fc81eb6cfc"></a>Description: Calculates the time of the next week y started from x</p>
<ul id="EN-US_TOPIC_0000001099150944__ul131790108540"><li id="EN-US_TOPIC_0000001099150944__li71804100543">In the ORA- or TD-compatible mode, the return type is timestamp.</li><li id="EN-US_TOPIC_0000001099150944__li1180710195415">In the MySQL-compatible mode, the return type is date.</li></ul>
<p id="EN-US_TOPIC_0000001099150944__a2df9901d26c44c36ad80a9cf9dd84f51">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s9b1904b90ca043fdae8ab936f3d18368"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">select</span><span class="w"> </span><span class="n">next_day</span><span class="p">(</span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'2017-05-25 00:00:00'</span><span class="p">,</span><span class="s1">'Sunday'</span><span class="p">)</span><span class="k">AS</span><span class="w"> </span><span class="n">cal_result</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="n">cal_result</span><span class="w"> </span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2017</span><span class="o">-</span><span class="mi">05</span><span class="o">-</span><span class="mi">28</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__li18530195381417">to_days(timestamp)<p id="EN-US_TOPIC_0000001099150944__p1091637203710"><a name="EN-US_TOPIC_0000001099150944__li18530195381417"></a><a name="li18530195381417"></a>Description: Returns the number of days from the first day of year 0 to a specified date.</p>
<p id="EN-US_TOPIC_0000001099150944__p628118253363">Return type: int</p>
<p id="EN-US_TOPIC_0000001099150944__p826029161516">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__screen1326182981514"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">to_days</span><span class="p">(</span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'2008-10-07'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">to_days</span><span class="w"></span>
<span class="c1">---------</span>
<span class="w"> </span><span class="mi">733687</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
<div class="section" id="EN-US_TOPIC_0000001099150944__s46aae9f2fd354b0881ea30d645533c72"><a name="EN-US_TOPIC_0000001099150944__s46aae9f2fd354b0881ea30d645533c72"></a><a name="s46aae9f2fd354b0881ea30d645533c72"></a><h4 class="sectiontitle">EXTRACT</h4><p id="EN-US_TOPIC_0000001099150944__a2a42c7b0db8a4385a1b5f0b9ca31ca16"><strong id="EN-US_TOPIC_0000001099150944__a1389a7c6f10f4e908b0930aa7cd1e69a">EXTRACT(</strong><em id="EN-US_TOPIC_0000001099150944__ac9bf5af929fd4f75a94101133184750b">field </em><strong id="EN-US_TOPIC_0000001099150944__a9bd77c3240114c8b81d7e060a912e210">FROM </strong><em id="EN-US_TOPIC_0000001099150944__acd843a3181b24fb29495159f5d89792b">source</em><strong id="EN-US_TOPIC_0000001099150944__a5f00c4f3ec7541398e13d4a4451cc859">)</strong></p>
<p id="EN-US_TOPIC_0000001099150944__af89794a380554ab5a6e39f77975de12f">The <strong id="EN-US_TOPIC_0000001099150944__b84235270611021">extract</strong> function retrieves subcolumns such as year or hour from date/time values. <strong id="EN-US_TOPIC_0000001099150944__b84235270611115">source</strong> must be a value expression of type <strong id="EN-US_TOPIC_0000001099150944__b84235270611315">timestamp</strong>, <strong id="EN-US_TOPIC_0000001099150944__b84235270611323">time</strong>, or <strong id="EN-US_TOPIC_0000001099150944__b84235270611330">interval</strong>. (Expressions of type <strong id="EN-US_TOPIC_0000001099150944__b84235270611347">date</strong> are cast to <strong id="EN-US_TOPIC_0000001099150944__b84235270611358">timestamp</strong> and can therefore be used as well.) <strong id="EN-US_TOPIC_0000001099150944__b84235270611435">field</strong> is an identifier or string that selects what column to extract from the source value. The <strong id="EN-US_TOPIC_0000001099150944__b84235270611518">extract</strong> function returns values of type <strong id="EN-US_TOPIC_0000001099150944__b84235270611529">double precision</strong>. The following are valid field names:</p>
<ul id="EN-US_TOPIC_0000001099150944__ub747f59c268745d3b3fa68249fe000c4"><li id="EN-US_TOPIC_0000001099150944__l74fbca2704d044c48cc4ac9b7da5e413">century<p id="EN-US_TOPIC_0000001099150944__a0a1bc9d50f4247fbb78320984cc4394f"><a name="EN-US_TOPIC_0000001099150944__l74fbca2704d044c48cc4ac9b7da5e413"></a><a name="l74fbca2704d044c48cc4ac9b7da5e413"></a>Century</p>
<p id="EN-US_TOPIC_0000001099150944__a60eb92fe9fc849cca66a575038146f76">The first century starts at 0001-01-01 00:00:00 AD. This definition applies to all Gregorian calendar countries. There is no century number 0. You go from <strong id="EN-US_TOPIC_0000001099150944__b842352706142422">-1</strong> century to <strong id="EN-US_TOPIC_0000001099150944__b842352706142425">1</strong> century.</p>
<p id="EN-US_TOPIC_0000001099150944__af6e68d7eca77456ab596fdce0fb7f70c">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sb2070d27ce8c41c08934de26886dc07a"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">CENTURY</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2000-12-16 12:21:13'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">20</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__lfdeaf693ae8243dca30c2fa148dd5a04">day<ul id="EN-US_TOPIC_0000001099150944__uc233183729ad4aac9c35f25c225119f8"><li id="EN-US_TOPIC_0000001099150944__l41e0f52b93ae4f39b7e069b2658723e1">For <strong id="EN-US_TOPIC_0000001099150944__b842352706111252">timestamp</strong> values, the day (of the month) column (131)<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sa342f06e7e8a43b78aaabe9c9f42d38f"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">DAY</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">16</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__lbf4583033bc24b30b218cfbcf11b0391">For <strong id="EN-US_TOPIC_0000001099150944__b842352706111335">interval</strong> values, the number of days<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s4f1112629cb24d208de9889401e4166b"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">DAY</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="nb">INTERVAL</span><span class="w"> </span><span class="s1">'40 days 1 minute'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">40</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</li><li id="EN-US_TOPIC_0000001099150944__lf6bc3581aa0248c88f74ff60a846bb0d">decade<p id="EN-US_TOPIC_0000001099150944__a3e695d0ac7ff4872b1e2fec67ec96ab6"><a name="EN-US_TOPIC_0000001099150944__lf6bc3581aa0248c88f74ff60a846bb0d"></a><a name="lf6bc3581aa0248c88f74ff60a846bb0d"></a>Year column divided by 10</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s71ffa785f0ae4bd78223215723c4c980"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">DECADE</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">200</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l01fcb235656c462587761c68a3d1243b">dow<p id="EN-US_TOPIC_0000001099150944__a34dd1fcc185741bc89b1a994b5543484"><a name="EN-US_TOPIC_0000001099150944__l01fcb235656c462587761c68a3d1243b"></a><a name="l01fcb235656c462587761c68a3d1243b"></a>Day of the week as Sunday(<strong id="EN-US_TOPIC_0000001099150944__b842352706111418">0</strong>) to Saturday (<strong id="EN-US_TOPIC_0000001099150944__b842352706111422">6</strong>)</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s122dcd1e3b6347c4a55910569a947b3e"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">DOW</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">5</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l9893be68c4024a41be182827f434210a">doy<p id="EN-US_TOPIC_0000001099150944__a2542925c37d64619a7a8a1aee2aa9315"><a name="EN-US_TOPIC_0000001099150944__l9893be68c4024a41be182827f434210a"></a><a name="l9893be68c4024a41be182827f434210a"></a>Day of the year (1365 or 366)</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s57066c1dd58f47708b53fd98dfc49144"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">DOY</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">47</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l10e1ecd3d85d4f6b86b4bc261d0d290f">epoch<ul id="EN-US_TOPIC_0000001099150944__u67d14cf4099144a8a423ad428bef0527"><li id="EN-US_TOPIC_0000001099150944__l4301fe94bfad48018a3805dbe13017e1">For <strong id="EN-US_TOPIC_0000001099150944__b842352706113955">timestamp with time zone</strong> values, the number of seconds since 1970-01-01 00:00:00 UTC (can be negative);<p id="EN-US_TOPIC_0000001099150944__a713ba48ed14c49e5acf7670015c5a5b5">for <strong id="EN-US_TOPIC_0000001099150944__b84235270611411">date</strong> and <strong id="EN-US_TOPIC_0000001099150944__b84235270611416">timestamp</strong> values, the number of seconds since 1970-01-01 00:00:00 local time;</p>
<p id="EN-US_TOPIC_0000001099150944__a84498f6ba1cf4964bdb17a6c09f4d394">for <strong id="EN-US_TOPIC_0000001099150944__b842352706114140">interval</strong> values, the total number of seconds in the interval.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sf9584756749144a89279bf0596b2e2ef"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">EPOCH</span><span class="w"> </span><span class="k">FROM</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="w"> </span><span class="s1">'2001-02-16 20:38:40.12-08'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">--------------</span>
<span class="w"> </span><span class="mi">982384720</span><span class="p">.</span><span class="mi">12</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s11391e49bcc4410586df6d8366efa67d"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">EPOCH</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="nb">INTERVAL</span><span class="w"> </span><span class="s1">'5 days 3 hours'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">442800</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__lac794eb5df5c476c8499370a5150b0c6">Way to convert an epoch value back to a timestamp<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s905a183064d34e0591a2bbdae51777cf"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</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="w"> </span><span class="s1">'epoch'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">982384720</span><span class="p">.</span><span class="mi">12</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="nb">INTERVAL</span><span class="w"> </span><span class="s1">'1 second'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------------</span>
<span class="w"> </span><span class="mi">2001</span><span class="o">-</span><span class="mi">02</span><span class="o">-</span><span class="mi">17</span><span class="w"> </span><span class="mi">12</span><span class="p">:</span><span class="mi">38</span><span class="p">:</span><span class="mi">40</span><span class="p">.</span><span class="mi">12</span><span class="o">+</span><span class="mi">08</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</li><li id="EN-US_TOPIC_0000001099150944__l200073a9fc9240b09ee1966efe7149a1">hour<p id="EN-US_TOPIC_0000001099150944__ae723373534634557829efc88688fc71c"><a name="EN-US_TOPIC_0000001099150944__l200073a9fc9240b09ee1966efe7149a1"></a><a name="l200073a9fc9240b09ee1966efe7149a1"></a>Hour column (023)</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__se0fffc08901b4c3b924160b5b2aa911d"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">HOUR</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">20</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l09a53823c10543a2965777215b67567d">isodow<p id="EN-US_TOPIC_0000001099150944__a2da4d87c8d124d619c2bb32bd5c817e9"><a name="EN-US_TOPIC_0000001099150944__l09a53823c10543a2965777215b67567d"></a><a name="l09a53823c10543a2965777215b67567d"></a>Day of the week (17)</p>
<p id="EN-US_TOPIC_0000001099150944__a19f2ad91cf9d47508d6c0731cb14d27b">Monday is 1 and Sunday is 7.</p>
<div class="note" id="EN-US_TOPIC_0000001099150944__n0d0f5b3a69194f918b4c43de8da9e248"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001099150944__a5ce6e34208a74c53a2f2cbb77918977f">This is identical to <strong id="EN-US_TOPIC_0000001099150944__b842352706114435">dow</strong> except for Sunday.</p>
</div></div>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s7f83a56fe7244a5281e0831a8bbb1ddd"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">ISODOW</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-18 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">7</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l48911d76fc1b4de2a92d72f71fbf2ef9">isoyear<p id="EN-US_TOPIC_0000001099150944__a5dc24f2ef3404863a2371e5a2c78b609"><a name="EN-US_TOPIC_0000001099150944__l48911d76fc1b4de2a92d72f71fbf2ef9"></a><a name="l48911d76fc1b4de2a92d72f71fbf2ef9"></a>The ISO 8601 year that the date falls in (not applicable to intervals).</p>
<p id="EN-US_TOPIC_0000001099150944__aef342aeca7564300ab6a7f63a49d27d1">Each ISO year begins with the Monday of the week containing the 4th of January, so in early January or late December the ISO year may be different from the Gregorian year. See the <strong id="EN-US_TOPIC_0000001099150944__b84235270614155">week</strong> column for more information.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__saa369da365814dc8a8a8b8878e2b526b"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">ISOYEAR</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="nb">DATE</span><span class="w"> </span><span class="s1">'2006-01-01'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">2005</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sbe10957f8f7a4224b0ce79622229ed5a"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">ISOYEAR</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="nb">DATE</span><span class="w"> </span><span class="s1">'2006-01-02'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">2006</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l5d31cf10f0114c798450e0c3df45439d">microseconds<p id="EN-US_TOPIC_0000001099150944__a258b761133144c19a0489e50c56c1e47"><a name="EN-US_TOPIC_0000001099150944__l5d31cf10f0114c798450e0c3df45439d"></a><a name="l5d31cf10f0114c798450e0c3df45439d"></a>The seconds column, including fractional parts, multiplied by 1,000,000</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s56622fcd1fcb4c1cbe735b0556b6fe48"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">MICROSECONDS</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIME</span><span class="w"> </span><span class="s1">'17:12:28.5'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">28500000</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l9ee66d7c47294d3daa184d9c5678d40f">millennium<p id="EN-US_TOPIC_0000001099150944__aee02b6aad43946c1b71ba112e2bb8d11"><a name="EN-US_TOPIC_0000001099150944__l9ee66d7c47294d3daa184d9c5678d40f"></a><a name="l9ee66d7c47294d3daa184d9c5678d40f"></a>Millennium</p>
<p id="EN-US_TOPIC_0000001099150944__a84ea4fcb74a74566ad7dca62cb612585">Years in the 1900s are in the second millennium. The third millennium started from January 1, 2001.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s7ed4a25c448b4ab5af039dd249cef7fa"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">MILLENNIUM</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">3</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l52acf6f09f904cf3977574ecea2eb87c">milliseconds<p id="EN-US_TOPIC_0000001099150944__a23a53be0e6624a359261b75f863ab77e"><a name="EN-US_TOPIC_0000001099150944__l52acf6f09f904cf3977574ecea2eb87c"></a><a name="l52acf6f09f904cf3977574ecea2eb87c"></a>The seconds column, including fractional parts, multiplied by 1000. Note that this includes full seconds.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s93c9e740655143a392956da6dcf7860b"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">MILLISECONDS</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIME</span><span class="w"> </span><span class="s1">'17:12:28.5'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">28500</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l6ebf066614fc41ddb087055341a3838a">minute<p id="EN-US_TOPIC_0000001099150944__a113fb023b2a94ebdb5ee5b33e51f83d5"><a name="EN-US_TOPIC_0000001099150944__l6ebf066614fc41ddb087055341a3838a"></a><a name="l6ebf066614fc41ddb087055341a3838a"></a>Minutes column (059)</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s3816acbe23ec42f985a1d00db80ac6dc"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">MINUTE</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">38</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l259415f0112d49b9bff6db0f85475970">month<p id="EN-US_TOPIC_0000001099150944__a2869d269d475485bb7ea8afc6ae71548"><a name="EN-US_TOPIC_0000001099150944__l259415f0112d49b9bff6db0f85475970"></a><a name="l259415f0112d49b9bff6db0f85475970"></a>For <strong id="EN-US_TOPIC_0000001099150944__b8423527061486">timestamp</strong> values, the number of the month within the year (112);</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__secbc6c7bfeee4fd8b4b0b8d0524455d9"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">MONTH</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">2</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001099150944__a37e4df3ec3534ab385d3aee111b2fba6">For <strong id="EN-US_TOPIC_0000001099150944__b8423527061495">interval</strong> values, the number of months, modulo 12 (011)</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s8d29984c93de4b44902c38d406b4dca3"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">MONTH</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="nb">INTERVAL</span><span class="w"> </span><span class="s1">'2 years 13 months'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">1</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l130327713e724976a70893da444e0366">quarter<p id="EN-US_TOPIC_0000001099150944__a595bbddb1f1e403eaea83f929a96543c"><a name="EN-US_TOPIC_0000001099150944__l130327713e724976a70893da444e0366"></a><a name="l130327713e724976a70893da444e0366"></a>Quarter of the year (14) that the date is in</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s3cb352bc05d84cafb97d1852db89ff49"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">QUARTER</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">1</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__l96f29bbd5e234401add476914d38b829">second<p id="EN-US_TOPIC_0000001099150944__a8bc52015d6604442a5d93ca6bffc3d6f"><a name="EN-US_TOPIC_0000001099150944__l96f29bbd5e234401add476914d38b829"></a><a name="l96f29bbd5e234401add476914d38b829"></a>Seconds column, including fractional parts (059)</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__sc62a761cbf58471c92c529c51f2677c7"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">SECOND</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIME</span><span class="w"> </span><span class="s1">'17:12:28.5'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">28</span><span class="p">.</span><span class="mi">5</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__labf658092c1447a5b918f60e7b024dd4">timezone<p id="EN-US_TOPIC_0000001099150944__a58d7120730514ce4b28c541b45598cb5"><a name="EN-US_TOPIC_0000001099150944__labf658092c1447a5b918f60e7b024dd4"></a><a name="labf658092c1447a5b918f60e7b024dd4"></a>The time zone offset from UTC, measured in seconds. Positive values correspond to time zones east of UTC, negative values to zones west of UTC.</p>
</li><li id="EN-US_TOPIC_0000001099150944__la52456e144bb418796c745e0a61eebba">timezone_hour<p id="EN-US_TOPIC_0000001099150944__a80fdafa9ccf74e4db01c12549e73362e"><a name="EN-US_TOPIC_0000001099150944__la52456e144bb418796c745e0a61eebba"></a><a name="la52456e144bb418796c745e0a61eebba"></a>The hour component of the time zone offset</p>
</li><li id="EN-US_TOPIC_0000001099150944__l287f29fbc38649c9886cc52b29c03c9c">timezone_minute<p id="EN-US_TOPIC_0000001099150944__a0db073d5176a43c3b1bfa72fd521a1c3"><a name="EN-US_TOPIC_0000001099150944__l287f29fbc38649c9886cc52b29c03c9c"></a><a name="l287f29fbc38649c9886cc52b29c03c9c"></a>The minute component of the time zone offset</p>
</li><li id="EN-US_TOPIC_0000001099150944__la5d0ae2eab66457c8e43ce78fd256508">week<p id="EN-US_TOPIC_0000001099150944__a32e387ccd1af4d7ca1adad509d46b678"><a name="EN-US_TOPIC_0000001099150944__la5d0ae2eab66457c8e43ce78fd256508"></a><a name="la5d0ae2eab66457c8e43ce78fd256508"></a>The number of the week of the year that the day is in. By definition (ISO 8601), the first week of a year contains January 4 of that year. (The ISO-8601 week starts on Monday.) In other words, the first Thursday of a year is in week 1 of that year.</p>
<p id="EN-US_TOPIC_0000001099150944__a84ad432aaeb545c3a6867097d5385132">Because of this, it is possible for early January dates to be part of the 52nd or 53rd week of the previous year, and late December dates to be part of the 1st week of the next year. For example, <strong id="EN-US_TOPIC_0000001099150944__b842352706142712">2005-01-01</strong> is part of the 53rd week of year 2004, <strong id="EN-US_TOPIC_0000001099150944__b842352706142742">2006-01-01</strong> is part of the 52nd week of year 2005, and <strong id="EN-US_TOPIC_0000001099150944__b842352706142817">2012-12-31</strong> is part of the 1st week of year 2013. You are advised to use the columns <strong id="EN-US_TOPIC_0000001099150944__b84235270695433">isoyear</strong> and <strong id="EN-US_TOPIC_0000001099150944__b84235270695442">week</strong> together to ensure consistency.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__scba37cbccb93453c87b7aace5b46b611"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">WEEK</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">7</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150944__lf63ea954260f456dbcb67838edec39aa">year<p id="EN-US_TOPIC_0000001099150944__a003fe8734eaa4233ba147de4e70af573"><a name="EN-US_TOPIC_0000001099150944__lf63ea954260f456dbcb67838edec39aa"></a><a name="lf63ea954260f456dbcb67838edec39aa"></a>Year column</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s87c7559221e04d69b2315a692582c003"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">YEAR</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">2001</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001099150944__s6e862f9edf6b459f87da0ba7432d4244"><h4 class="sectiontitle">date_part</h4><p id="EN-US_TOPIC_0000001099150944__ac207817e3f254379912108bcf9582dd9">The <strong id="EN-US_TOPIC_0000001099150944__b84235270614365">date_part</strong> function is modeled on the traditional Ingres equivalent to the SQL-standard function <strong id="EN-US_TOPIC_0000001099150944__b842352706143618">extract</strong>:</p>
<p id="EN-US_TOPIC_0000001099150944__ac8dc090f2eeb46df92d055204f831795"><strong id="EN-US_TOPIC_0000001099150944__a962a2af75fbb4d61856c3f3cda05a0f6">date_part('</strong><em id="EN-US_TOPIC_0000001099150944__a54dc4bc560e04b92908b15ab94fff735">field</em><strong id="EN-US_TOPIC_0000001099150944__a82b41e5b5cd24641948ec7f797f4b5c6">', </strong><em id="EN-US_TOPIC_0000001099150944__a898e89e39de04e7ca9e26e3e41220da3">source</em><strong id="EN-US_TOPIC_0000001099150944__a7f0eaef707ae41a69f05130a6e87f966">)</strong></p>
<p id="EN-US_TOPIC_0000001099150944__aad51d5d86f7b48dd94bce69720919b1c">Note that the <strong id="EN-US_TOPIC_0000001099150944__b84235270614371">field</strong> must be a string, rather than a name. The valid field names are the same as those for <strong id="EN-US_TOPIC_0000001099150944__b84235270614383">extract</strong>. For details, see <a href="#EN-US_TOPIC_0000001099150944__s46aae9f2fd354b0881ea30d645533c72">EXTRACT</a>.</p>
<p id="EN-US_TOPIC_0000001099150944__a00fe76bb42c0441eb1127e565ea87167">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s75db025691524627a44c8cb67d2cae41"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">date_part</span><span class="p">(</span><span class="s1">'day'</span><span class="p">,</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">16</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__s760054d5cc6b43f3942cafc430ba4df2"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">date_part</span><span class="p">(</span><span class="s1">'hour'</span><span class="p">,</span><span class="w"> </span><span class="nb">INTERVAL</span><span class="w"> </span><span class="s1">'4 hours 3 minutes'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">4</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001099150944__section42717263203"><h4 class="sectiontitle">date_format</h4><p id="EN-US_TOPIC_0000001099150944__p20406857172011"><strong id="EN-US_TOPIC_0000001099150944__b1058071682213">date_format(</strong>timestamp, fmt<strong id="EN-US_TOPIC_0000001099150944__b174061657182015">)</strong></p>
<p id="EN-US_TOPIC_0000001099150944__p15406165717201">Converts a date into a string in the format specified by <strong id="EN-US_TOPIC_0000001099150944__b1736751185414">fmt</strong>.</p>
<p id="EN-US_TOPIC_0000001099150944__p0406157132012">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150944__screen95761392517"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">date_format</span><span class="p">(</span><span class="s1">'2009-10-04 22:23:00'</span><span class="p">,</span><span class="w"> </span><span class="s1">'%M %D %W'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_format</span><span class="w"></span>
<span class="c1">--------------------</span>
<span class="w"> </span><span class="n">October</span><span class="w"> </span><span class="mi">4</span><span class="n">th</span><span class="w"> </span><span class="n">Sunday</span><span class="w"></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="w"></span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">date_format</span><span class="p">(</span><span class="s1">'2021-02-20 08:30:45'</span><span class="p">,</span><span class="w"> </span><span class="s1">'%Y-%m-%d %H:%i:%S'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_format</span><span class="w"></span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2021</span><span class="o">-</span><span class="mi">02</span><span class="o">-</span><span class="mi">20</span><span class="w"> </span><span class="mi">08</span><span class="p">:</span><span class="mi">30</span><span class="p">:</span><span class="mi">45</span><span class="w"></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="w"></span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">date_format</span><span class="p">(</span><span class="s1">'2021-02-20 18:10:15'</span><span class="p">,</span><span class="w"> </span><span class="s1">'%r-%T'</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">date_format</span><span class="w"></span>
<span class="c1">----------------------</span>
<span class="w"> </span><span class="mi">06</span><span class="p">:</span><span class="mi">10</span><span class="p">:</span><span class="mi">15</span><span class="w"> </span><span class="n">PM</span><span class="o">-</span><span class="mi">18</span><span class="p">:</span><span class="mi">10</span><span class="p">:</span><span class="mi">15</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001099150944__p155715508364">The following table describes the patterns of date parameter values. They can be used for the <strong id="EN-US_TOPIC_0000001099150944__b108351340193813">date_format</strong>, <strong id="EN-US_TOPIC_0000001099150944__b19461174243813">time_format</strong>, <strong id="EN-US_TOPIC_0000001099150944__b94381744193817">str_to_date</strong>, <strong id="EN-US_TOPIC_0000001099150944__b10206184623814">str_to_time</strong>, and <strong id="EN-US_TOPIC_0000001099150944__b1633404943820">from_unixtime</strong> functions.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001099150944__table81381552269" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Output formats of date_format</caption><thead align="left"><tr id="EN-US_TOPIC_0000001099150944__row7139550262"><th align="left" class="cellrowborder" valign="top" width="13.86%" id="mcps1.3.7.7.2.4.1.1"><p id="EN-US_TOPIC_0000001099150944__p201391355267">Format</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="38.440000000000005%" id="mcps1.3.7.7.2.4.1.2"><p id="EN-US_TOPIC_0000001099150944__p41393519268">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="47.699999999999996%" id="mcps1.3.7.7.2.4.1.3"><p id="EN-US_TOPIC_0000001099150944__p18224123717550">Value</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001099150944__row2013919512269"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p913919511267">%a</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p113919542617">Abbreviated week name</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p13224123711555">Sun...Sat</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row2139250262"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p121398572616">%b</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p141396515266">Abbreviated month name</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p142241375555">Jan...Dec</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row6139165142616"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p61396514263">%c</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p11139105102614">Month</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p52249371559">0...12</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row2139352268"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p377512720413">%D</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p1213918542618">Date with a suffix</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p3224937195519">0th, 1st, 2nd, 3rd, ...</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row513916582616"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p14818107164115">%d</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p7754165916527">Day in a month (two digits)</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p10224153725518">00...31</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row181394572617"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p385815712410">%e</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p113925192615">Day in a month</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p10224133725518">0...31</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row81396532610"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1088817719415">%f</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p1813919572610">Microsecond</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p7224537165512">000000...999999</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row71398518261"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p149166764116">%H</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p1313914516264">Hour, in 24-hour format</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p422416372553">00...23</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row313910517260"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p179431979418">%h</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p171401558269">Hour, in 12-hour format</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p6224103715514">01...12</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row414011592610"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p497113719415">%I</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p414017552612">Hour, in 12-hour format, same as <strong id="EN-US_TOPIC_0000001099150944__b628133410412">%h</strong></p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p182241037165514">01...12</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row1714013502617"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p635811413">%i</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p1114012572613">Minute</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p32251237125518">00...59</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row19140859263"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1631088410">%j</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p314015192615">Day in a year</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p152255377551">001...366</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row114019514264"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1358283416">%k</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p31401959260">Hour, in 24-hour format, same as <strong id="EN-US_TOPIC_0000001099150944__b222790465">%H</strong></p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p22258375554">0...23</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row31403519261"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p2842810416">%l</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p3140958266">Hour, in 12-hour format, same as <strong id="EN-US_TOPIC_0000001099150944__b1470820381465">%h</strong></p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p822533713551">1...12</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row1140115172610"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p911113824115">%M</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p161401152262">Month name</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p32257373558">January...December</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row111402052261"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1013820864113">%m</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p16333121665517">Month (two digits)</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p1422516371554">00...12</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row101401556264"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p17167198114117">%p</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p1814016519267">Morning and afternoon</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p422543716556">AM PM</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row1114015132616"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p20469121310418">%r</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p114085202617">Time, in 12-hour format</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p222543714556">hh::mm::ss AM/PM</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row11140253262"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1251421324119">%S</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p1414013582620">Second</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p1122511377556">00...59</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row8140185102614"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1554441374110">%s</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p1714019516267">Second, same as <strong id="EN-US_TOPIC_0000001099150944__b165622052111319">%S</strong></p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p12225123725516">00...59</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row21403510268"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p35737137418">%T</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p214035172615">Time, in 24-hour format</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p922553713553">hh::mm::ss</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row814015132613"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p3603131314413">%U</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p814065112614">Week (Sunday is the first day of a week)</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p1622543710551">00...53</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row114016514262"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1063351319419">%u</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p41412552615">Week (Monday is the first day of a week)</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p72251337105519">00...53</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row61411256262"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p13665151304119">%V</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p1314115512614">Week (Sunday is the first day of a week). It is used together with <strong id="EN-US_TOPIC_0000001099150944__b159344573163">%X</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p12225173715516">01...53</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row214125102611"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p5694613174113">%v</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p7141205182617">Week (Monday is the first day of a week). It is used together with <strong id="EN-US_TOPIC_0000001099150944__b313231281716">%x</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p22259375553">01...53</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row121416517264"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p117227132417">%W</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p5141115162613">Week name</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p12251637115520">Sunday...Saturday</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row91418515269"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p6751181316418">%w</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p191417514268">Day of a week. The value is <strong id="EN-US_TOPIC_0000001099150944__b19311138181819">0</strong> for Sunday.</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p622514371556">0...6</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row15141125132616"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1779121324119">%X</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p1014111562616">Year (four digits). It is used together with <strong id="EN-US_TOPIC_0000001099150944__b59114192119">%V</strong>. Sunday is the first day of a week.</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p8225123718556">-</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row16141135142615"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1680841320416">%x</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p1314165152610">Year (four digits). It is used together with <strong id="EN-US_TOPIC_0000001099150944__b7302194092113">%v</strong>. Monday is the first day of a week.</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p7225123765518">-</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row7141175182619"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p13837513144115">%Y</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p5141451268">Year (four digits)</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p16225113735512">-</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row21415582614"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p148652131411">%y</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p014175112612">Year (two digits)</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p1822583775519">-</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row191412542615"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p12894111384117">%%</p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p614119572616">Character '%'</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p172251237155513">Character '%'</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001099150944__row81411657263"><td class="cellrowborder" valign="top" width="13.86%" headers="mcps1.3.7.7.2.4.1.1 "><p id="EN-US_TOPIC_0000001099150944__p1992361354110">%<em id="EN-US_TOPIC_0000001099150944__i072918398432">x</em></p>
</td>
<td class="cellrowborder" valign="top" width="38.440000000000005%" headers="mcps1.3.7.7.2.4.1.2 "><p id="EN-US_TOPIC_0000001099150944__p181417517266">'<em id="EN-US_TOPIC_0000001099150944__i1931612231761">x</em>': any character apart from the preceding ones</p>
</td>
<td class="cellrowborder" valign="top" width="47.699999999999996%" headers="mcps1.3.7.7.2.4.1.3 "><p id="EN-US_TOPIC_0000001099150944__p122633712553">Character '<em id="EN-US_TOPIC_0000001099150944__i636317560167">x</em>'</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="notice" id="EN-US_TOPIC_0000001099150944__note1428012423197"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001099150944__p19280142191914">In the preceding table, <strong id="EN-US_TOPIC_0000001099150944__b480317158277">%U</strong>, <strong id="EN-US_TOPIC_0000001099150944__b1097421862711">%u</strong>, <strong id="EN-US_TOPIC_0000001099150944__b6964162114279">%V</strong>, <strong id="EN-US_TOPIC_0000001099150944__b180462422718">%v</strong>, <strong id="EN-US_TOPIC_0000001099150944__b1360462820275">%X</strong>, and <strong id="EN-US_TOPIC_0000001099150944__b6102163218272">%x</strong> are not supported currently.</p>
</div></div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0027.html">Functions and Operators</a></div>
</div>
</div>