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

1118 lines
107 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001495991685"></a><a name="EN-US_TOPIC_0000001495991685"></a>
<h1 class="topictitle1">Time/Date functions</h1>
<div id="body0000001495991685"><div class="section" id="EN-US_TOPIC_0000001495991685__section8765194211428"><h4 class="sectiontitle">age(timestamp, timestamp)</h4><p id="EN-US_TOPIC_0000001495991685__p17764842124210">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_0000001495991685__p97641242104214">Return type: interval</p>
<p id="EN-US_TOPIC_0000001495991685__p7764742104218">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen14765342184218"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section1517664019424"><h4 class="sectiontitle">age(timestamp)</h4><p id="EN-US_TOPIC_0000001495991685__p7176340194218">Description: Subtracts from <strong id="EN-US_TOPIC_0000001495991685__b1082897993723">current_date</strong></p>
<p id="EN-US_TOPIC_0000001495991685__p9176134034211">Return type: interval</p>
<p id="EN-US_TOPIC_0000001495991685__p19176134034220">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen11176540194210"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section12597367428"><a name="EN-US_TOPIC_0000001495991685__section12597367428"></a><a name="section12597367428"></a><h4 class="sectiontitle">adddate(date, interval | int)</h4><p id="EN-US_TOPIC_0000001495991685__p056936184212">Description: Returns the result of a given datetime plus the time interval of a specified unit. The default unit is day (when the second parameter is an integer).</p>
<p id="EN-US_TOPIC_0000001495991685__p35610366427">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001495991685__p18561636174214">Example:</p>
<p id="EN-US_TOPIC_0000001495991685__p7561036154219">When the input parameter is of the text type:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen358136184211"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span>
<span class="normal">23</span>
<span class="normal">24</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">adddate</span><span class="p">(</span><span class="s1">'2020-11-13'</span><span class="p">,</span><span class="w"> </span><span class="mi">10</span><span class="p">);</span>
<span class="w"> </span><span class="n">adddate</span>
<span class="c1">------------</span>
<span class="w"> </span><span class="mi">2020</span><span class="o">-</span><span class="mi">11</span><span class="o">-</span><span class="mi">23</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">adddate</span><span class="p">(</span><span class="s1">'2020-11-13'</span><span class="p">,</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1'</span><span class="w"> </span><span class="k">month</span><span class="p">);</span>
<span class="w"> </span><span class="n">adddate</span>
<span class="c1">------------</span>
<span class="w"> </span><span class="mi">2020</span><span class="o">-</span><span class="mi">12</span><span class="o">-</span><span class="mi">13</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">adddate</span><span class="p">(</span><span class="s1">'2020-11-13 12:15:16'</span><span class="p">,</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1'</span><span class="w"> </span><span class="k">month</span><span class="p">);</span>
<span class="w"> </span><span class="n">adddate</span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2020</span><span class="o">-</span><span class="mi">12</span><span class="o">-</span><span class="mi">13</span><span class="w"> </span><span class="mi">12</span><span class="p">:</span><span class="mi">15</span><span class="p">:</span><span class="mi">16</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">adddate</span><span class="p">(</span><span class="s1">'2020-11-13'</span><span class="p">,</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1'</span><span class="w"> </span><span class="k">minute</span><span class="p">);</span>
<span class="w"> </span><span class="n">adddate</span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2020</span><span class="o">-</span><span class="mi">11</span><span class="o">-</span><span class="mi">13</span><span class="w"> </span><span class="mi">00</span><span class="p">:</span><span class="mi">01</span><span class="p">:</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001495991685__p1358163610422">When the input parameter is of the date type:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1259163610429"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">adddate</span><span class="p">(</span><span class="k">current_date</span><span class="p">,</span><span class="w"> </span><span class="mi">10</span><span class="p">);</span>
<span class="w"> </span><span class="n">adddate</span>
<span class="c1">------------</span>
<span class="w"> </span><span class="mi">2021</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">24</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">adddate</span><span class="p">(</span><span class="nb">date</span><span class="w"> </span><span class="s1">'2020-11-13'</span><span class="p">,</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1'</span><span class="w"> </span><span class="k">month</span><span class="p">);</span>
<span class="w"> </span><span class="n">adddate</span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2020</span><span class="o">-</span><span class="mi">12</span><span class="o">-</span><span class="mi">13</span><span class="w"> </span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section14108183084217"><a name="EN-US_TOPIC_0000001495991685__section14108183084217"></a><a name="section14108183084217"></a><h4 class="sectiontitle">subdate(date, interval | int)</h4><p id="EN-US_TOPIC_0000001495991685__p16105133011424">Description: Returns the result of a given datetime minus the time interval of a specified unit. The default unit is day (when the second parameter is an integer).</p>
<p id="EN-US_TOPIC_0000001495991685__p510533094216">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001495991685__p15105133064218">Example:</p>
<p id="EN-US_TOPIC_0000001495991685__p18105153010429">When the input parameter is of the text type:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1310863013429"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span>
<span class="normal">23</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">subdate</span><span class="p">(</span><span class="s1">'2020-11-13'</span><span class="p">,</span><span class="w"> </span><span class="mi">10</span><span class="p">);</span>
<span class="w"> </span><span class="n">subdate</span>
<span class="c1">------------</span>
<span class="w"> </span><span class="mi">2020</span><span class="o">-</span><span class="mi">11</span><span class="o">-</span><span class="mi">03</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">subdate</span><span class="p">(</span><span class="s1">'2020-11-13'</span><span class="p">,</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'2'</span><span class="w"> </span><span class="k">month</span><span class="p">);</span>
<span class="w"> </span><span class="n">subdate</span>
<span class="c1">------------</span>
<span class="w"> </span><span class="mi">2020</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">13</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">subdate</span><span class="p">(</span><span class="s1">'2020-11-13 12:15:16'</span><span class="p">,</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1'</span><span class="w"> </span><span class="k">month</span><span class="p">);</span>
<span class="w"> </span><span class="n">subdate</span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2020</span><span class="o">-</span><span class="mi">10</span><span class="o">-</span><span class="mi">13</span><span class="w"> </span><span class="mi">12</span><span class="p">:</span><span class="mi">15</span><span class="p">:</span><span class="mi">16</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">subdate</span><span class="p">(</span><span class="s1">'2020-11-13'</span><span class="p">,</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'2'</span><span class="w"> </span><span class="k">minute</span><span class="p">);</span>
<span class="w"> </span><span class="n">subdate</span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2020</span><span class="o">-</span><span class="mi">11</span><span class="o">-</span><span class="mi">12</span><span class="w"> </span><span class="mi">23</span><span class="p">:</span><span class="mi">58</span><span class="p">:</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001495991685__p11108630174214">When the input parameter is of the date type:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen17108830134217"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">subdate</span><span class="p">(</span><span class="k">current_date</span><span class="p">,</span><span class="w"> </span><span class="mi">10</span><span class="p">);</span>
<span class="w"> </span><span class="n">subdate</span>
<span class="c1">------------</span>
<span class="w"> </span><span class="mi">2021</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">05</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">subdate</span><span class="p">(</span><span class="k">current_date</span><span class="p">,</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1'</span><span class="w"> </span><span class="k">month</span><span class="p">);</span>
<span class="w"> </span><span class="n">subdate</span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2021</span><span class="o">-</span><span class="mi">08</span><span class="o">-</span><span class="mi">15</span><span class="w"> </span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section16746524154219"><h4 class="sectiontitle">date_add(date, interval)</h4><p id="EN-US_TOPIC_0000001495991685__p67461824134215">Description: Returns the result of a given datetime plus the time interval of a specified unit. It is equivalent to <a href="#EN-US_TOPIC_0000001495991685__section12597367428">adddate(date, interval | int)</a>.</p>
<p id="EN-US_TOPIC_0000001495991685__p197461624164215">Return type: timestamp</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section1810321912231"><h4 class="sectiontitle">date_sub(date, interval)</h4><p id="EN-US_TOPIC_0000001495991685__p9103101914236">Description: Returns the result of a given datetime minus the time interval of a specified unit. It is equivalent to <a href="#EN-US_TOPIC_0000001495991685__section14108183084217">subdate(date, interval | int)</a>.</p>
<p id="EN-US_TOPIC_0000001495991685__p610391942318">Return type: timestamp</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section13576152134214"><h4 class="sectiontitle">timestampadd(field, numeric, timestamp)</h4><p id="EN-US_TOPIC_0000001495991685__p5575521154218">Description: Adds an integer interval in the unit of <strong id="EN-US_TOPIC_0000001495991685__b61962731893723">field</strong> (the number of seconds can be a decimal) to a datetime expression. If the value is negative, the corresponding time interval is subtracted from the given datetime expression. The <strong id="EN-US_TOPIC_0000001495991685__b58454810893723">field</strong> can be <strong id="EN-US_TOPIC_0000001495991685__b42624093723">year</strong>, <strong id="EN-US_TOPIC_0000001495991685__b135557027693723">month</strong>, <strong id="EN-US_TOPIC_0000001495991685__b212551621893723">quarter</strong>, <strong id="EN-US_TOPIC_0000001495991685__b173689305593723">day</strong>, <strong id="EN-US_TOPIC_0000001495991685__b140485863893723">week</strong>, <strong id="EN-US_TOPIC_0000001495991685__b162956707393723">hour</strong>, <strong id="EN-US_TOPIC_0000001495991685__b42814384293723">minute</strong>, <strong id="EN-US_TOPIC_0000001495991685__b123741611993723">second</strong>, and <strong id="EN-US_TOPIC_0000001495991685__b204297536093723">microsecond</strong>.</p>
<p id="EN-US_TOPIC_0000001495991685__p125759218429">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001495991685__p3575112119428">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1957614218422"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">timestampadd</span><span class="p">(</span><span class="k">year</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2020-2-29'</span><span class="p">);</span>
<span class="w"> </span><span class="n">timestampadd</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">timestampadd</span><span class="p">(</span><span class="k">second</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">.</span><span class="mi">354156</span><span class="p">,</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2020-11-13'</span><span class="p">);</span>
<span class="w"> </span><span class="n">timestampadd</span>
<span class="c1">----------------------------</span>
<span class="w"> </span><span class="mi">2020</span><span class="o">-</span><span class="mi">11</span><span class="o">-</span><span class="mi">13</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">02</span><span class="p">.</span><span class="mi">354156</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section15781131716429"><h4 class="sectiontitle">timestampdiff(field, timestamp1, timestamp2)</h4><p id="EN-US_TOPIC_0000001495991685__p1781151714213">Description: Subtracts <strong id="EN-US_TOPIC_0000001495991685__b74249036593723">timestamp1</strong> from <strong id="EN-US_TOPIC_0000001495991685__b33710614293723">timestamp2</strong> and returns the difference in the unit of <strong id="EN-US_TOPIC_0000001495991685__b171713642393723">field</strong>. If the difference is negative, this function returns it normally. The <strong id="EN-US_TOPIC_0000001495991685__b192808795393723">field</strong> can be <strong id="EN-US_TOPIC_0000001495991685__b208781482793723">year</strong>, <strong id="EN-US_TOPIC_0000001495991685__b121206444993723">month</strong>, <strong id="EN-US_TOPIC_0000001495991685__b56211408593723">quarter</strong>, <strong id="EN-US_TOPIC_0000001495991685__b83370682193723">day</strong>, <strong id="EN-US_TOPIC_0000001495991685__b109089767093723">week</strong>, <strong id="EN-US_TOPIC_0000001495991685__b208144724593723">hour</strong>, <strong id="EN-US_TOPIC_0000001495991685__b141405105293723">minute</strong>, <strong id="EN-US_TOPIC_0000001495991685__b187227502793723">second</strong>, or <strong id="EN-US_TOPIC_0000001495991685__b487867393723">microsecond</strong>.</p>
<p id="EN-US_TOPIC_0000001495991685__p13781317104214">Return type: bigint</p>
<p id="EN-US_TOPIC_0000001495991685__p47811117184217">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1178161713428"><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">timestampdiff</span><span class="p">(</span><span class="k">day</span><span class="p">,</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-01'</span><span class="p">,</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2003-05-01 12:05:55'</span><span class="p">);</span>
<span class="w"> </span><span class="n">timestampdiff</span><span class="w"> </span>
<span class="c1">---------------</span>
<span class="w"> </span><span class="mi">819</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section1096511410425"><h4 class="sectiontitle">clock_timestamp()</h4><p id="EN-US_TOPIC_0000001495991685__p149658145428">Description: Specifies the current timestamp of the real-time clock.</p>
<p id="EN-US_TOPIC_0000001495991685__p1965141474215">Return type: timestamp with time zone</p>
<p id="EN-US_TOPIC_0000001495991685__p1996516145422">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1896501410423"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section1223911217426"><h4 class="sectiontitle">current_date</h4><p id="EN-US_TOPIC_0000001495991685__p723812126425">Description: Current date</p>
<p id="EN-US_TOPIC_0000001495991685__p1923891234215">Return type: date</p>
<p id="EN-US_TOPIC_0000001495991685__p15238512164212">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen62392012164218"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section629698124214"><h4 class="sectiontitle">current_time</h4><p id="EN-US_TOPIC_0000001495991685__p162957804212">Description: Current time</p>
<p id="EN-US_TOPIC_0000001495991685__p19295089421">Return type: time with time zone</p>
<p id="EN-US_TOPIC_0000001495991685__p172951484427">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen329615812425"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section75999514425"><a name="EN-US_TOPIC_0000001495991685__section75999514425"></a><a name="section75999514425"></a><h4 class="sectiontitle">current_timestamp</h4><p id="EN-US_TOPIC_0000001495991685__p1959915194211">Description: Specifies the current date and time.</p>
<p id="EN-US_TOPIC_0000001495991685__p65996512429">Return type: timestamp with time zone</p>
<p id="EN-US_TOPIC_0000001495991685__p85991516429">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen65991654426"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section203251134213"><h4 class="sectiontitle">datediff(date1, date2)</h4><p id="EN-US_TOPIC_0000001495991685__p16324151204212">Description: Returns the number of days between two given dates.</p>
<p id="EN-US_TOPIC_0000001495991685__p53241114424">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p1032419110428">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen632512154217"><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">datediff</span><span class="p">(</span><span class="nb">date</span><span class="w"> </span><span class="s1">'2020-11-13'</span><span class="p">,</span><span class="w"> </span><span class="nb">date</span><span class="w"> </span><span class="s1">'2012-10-16'</span><span class="p">);</span>
<span class="w"> </span><span class="n">datediff</span>
<span class="c1">----------</span>
<span class="w"> </span><span class="mi">2950</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section773513575411"><h4 class="sectiontitle">date_part(text, timestamp)</h4><p id="EN-US_TOPIC_0000001495991685__p142102052162514">Description: Obtains the precision specified by <strong id="EN-US_TOPIC_0000001495991685__b145711130162214">text</strong>.</p>
<p id="EN-US_TOPIC_0000001495991685__p87346571412"><strong id="EN-US_TOPIC_0000001495991685__b99026675293723">Equals</strong> <a href="#EN-US_TOPIC_0000001495991685__section7165144274119">extract(field from timestamp)</a>.</p>
<p id="EN-US_TOPIC_0000001495991685__p17734195720417">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001495991685__p177344579414">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen12735185714111"><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="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">20</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section346145214418"><h4 class="sectiontitle">date_part(text, interval)</h4><p id="EN-US_TOPIC_0000001495991685__p346195294113">Description: Obtains the precision specified by <strong id="EN-US_TOPIC_0000001495991685__b766743922218">text</strong>. If the value is greater than 12, obtain the remainder after it is divided by 12.</p>
<p id="EN-US_TOPIC_0000001495991685__p5461145218418"><strong id="EN-US_TOPIC_0000001495991685__b63158382193723">Equals</strong> <a href="#EN-US_TOPIC_0000001495991685__section7165144274119">extract(field from timestamp)</a></p>
<p id="EN-US_TOPIC_0000001495991685__p9461952194111">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001495991685__p174611152114118">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1461552204115"><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="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">3</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section178207487414"><h4 class="sectiontitle">date_trunc(text, timestamp)</h4><p id="EN-US_TOPIC_0000001495991685__p188201248184111">Description: Truncates to the precision specified by <strong id="EN-US_TOPIC_0000001495991685__b15099415493723">text</strong>.</p>
<p id="EN-US_TOPIC_0000001495991685__p58201948124117">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001495991685__p1482013481414">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen208201848164111"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span>
<span class="normal">23</span>
<span class="normal">24</span>
<span class="normal">25</span>
<span class="normal">26</span></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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="c1">-- Obtain the last day of last year.</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">date_trunc</span><span class="p">(</span><span class="s1">'day'</span><span class="p">,</span><span class="w"> </span><span class="n">date_trunc</span><span class="p">(</span><span class="s1">'year'</span><span class="p">,</span><span class="k">CURRENT_DATE</span><span class="p">)</span><span class="o">+</span><span class="w"> </span><span class="s1">'-1'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_trunc</span>
<span class="c1">------------------------</span>
<span class="w"> </span><span class="mi">2022</span><span class="o">-</span><span class="mi">12</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="o">+</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="c1">-- Obtain the first day of this year.</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">date_trunc</span><span class="p">(</span><span class="s1">'year'</span><span class="p">,</span><span class="k">CURRENT_DATE</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_trunc</span>
<span class="c1">------------------------</span>
<span class="w"> </span><span class="mi">2023</span><span class="o">-</span><span class="mi">01</span><span class="o">-</span><span class="mi">01</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="o">+</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="c1">-- Obtain the first day of last year.</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">date_trunc</span><span class="p">(</span><span class="s1">'year'</span><span class="p">,</span><span class="n">now</span><span class="p">()</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s1">'-1 year'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_trunc</span>
<span class="c1">------------------------</span>
<span class="w"> </span><span class="mi">2022</span><span class="o">-</span><span class="mi">01</span><span class="o">-</span><span class="mi">01</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="o">+</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section7562154514114"><h4 class="sectiontitle">trunc(timestamp)</h4><p id="EN-US_TOPIC_0000001495991685__p1556217454413">Description: By default, the data is intercepted by day.</p>
<p id="EN-US_TOPIC_0000001495991685__p17465112011567">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001495991685__p5562154514414">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen12562164534116"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section7165144274119"><a name="EN-US_TOPIC_0000001495991685__section7165144274119"></a><a name="section7165144274119"></a><h4 class="sectiontitle">extract(field from timestamp)</h4><p id="EN-US_TOPIC_0000001495991685__p4165542174113">Description: Obtains the value of <strong id="EN-US_TOPIC_0000001495991685__b1949116303284">field</strong> with the specified precision. For details about the valid values of <strong id="EN-US_TOPIC_0000001495991685__b266411368285">field</strong>, see <a href="dws_06_0310.html">EXTRACT</a>.</p>
<p id="EN-US_TOPIC_0000001495991685__p19165124217416">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001495991685__p15165144211419">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen116544213413"><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="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">20</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section6460153984113"><h4 class="sectiontitle">extract(field from interval)</h4><p id="EN-US_TOPIC_0000001495991685__p16459143934117">Description: Obtains the value of <strong id="EN-US_TOPIC_0000001495991685__b6750173702811">field</strong> with the specified precision. If the value is greater than 12, obtain the remainder after it is divided by 12. For details about the valid values of <strong id="EN-US_TOPIC_0000001495991685__b15165164112820">field</strong>, see <a href="dws_06_0310.html">EXTRACT</a>.</p>
<p id="EN-US_TOPIC_0000001495991685__p1045918396413">Return type: double precision</p>
<p id="EN-US_TOPIC_0000001495991685__p1945993944112">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen5460123974110"><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="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">3</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section257093620415"><h4 class="sectiontitle">day(date)</h4><p id="EN-US_TOPIC_0000001495991685__p35701836154114">Description: Obtains the number of days in the month in which <strong id="EN-US_TOPIC_0000001495991685__b85235887993723">date</strong> is located. This function is the same as the <strong id="EN-US_TOPIC_0000001495991685__b137514368493723">dayofmonth</strong> function.</p>
<p id="EN-US_TOPIC_0000001495991685__p135701036124111">Value range: 1 to 31</p>
<p id="EN-US_TOPIC_0000001495991685__p1357073634117">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p11570143611414">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1757023611415"><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">day</span><span class="p">(</span><span class="s1">'2020-06-28'</span><span class="p">);</span>
<span class="w"> </span><span class="k">day</span>
<span class="c1">-----</span>
<span class="w"> </span><span class="mi">28</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section139963334111"><h4 class="sectiontitle">dayofmonth(date)</h4><p id="EN-US_TOPIC_0000001495991685__p1598183314112">Description: Obtains the number of days in the month in which <strong id="EN-US_TOPIC_0000001495991685__b12566277393723">date</strong> is located.</p>
<p id="EN-US_TOPIC_0000001495991685__p19813374111">Value range: 1 to 31</p>
<p id="EN-US_TOPIC_0000001495991685__p19883314112">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p16982335418">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1991533114119"><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">dayofmonth</span><span class="p">(</span><span class="s1">'2020-06-28'</span><span class="p">);</span>
<span class="w"> </span><span class="n">dayofmonth</span>
<span class="c1">------------</span>
<span class="w"> </span><span class="mi">28</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section239773012414"><h4 class="sectiontitle">dayofweek(date)</h4><p id="EN-US_TOPIC_0000001495991685__p1939719306416">Description: Returns the week index corresponding to the given date, with Sunday as the start day of the week.</p>
<p id="EN-US_TOPIC_0000001495991685__p73971309411">Value range: 1 to 7</p>
<p id="EN-US_TOPIC_0000001495991685__p18397123084113">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p17397133012414">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen113971430134111"><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">dayofweek</span><span class="p">(</span><span class="s1">'2020-11-22'</span><span class="p">);</span>
<span class="w"> </span><span class="n">dayofweek</span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">1</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section0218276415"><h4 class="sectiontitle">dayofyear(date)</h4><p id="EN-US_TOPIC_0000001495991685__p2202724116">Description: Returns the number of days of a given date in the current year.</p>
<p id="EN-US_TOPIC_0000001495991685__p72927164113">Value range: 1 to 366</p>
<p id="EN-US_TOPIC_0000001495991685__p192192716418">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p122127174110">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen422273419"><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">dayofyear</span><span class="p">(</span><span class="s1">'2020-02-29'</span><span class="p">);</span>
<span class="w"> </span><span class="n">dayofyear</span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">60</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section184241723154112"><h4 class="sectiontitle">hour(timestamp with time zone)</h4><p id="EN-US_TOPIC_0000001495991685__p1042452318414">Description: Obtains the hour value in the time.</p>
<p id="EN-US_TOPIC_0000001495991685__p14249236418">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p9424523194117">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen17424323154115"><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">hour</span><span class="p">(</span><span class="n">timestamptz</span><span class="w"> </span><span class="s1">'2018-12-13 12:11:15+06'</span><span class="p">);</span>
<span class="w"> </span><span class="n">hour</span>
<span class="c1">------</span>
<span class="w"> </span><span class="mi">6</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section20894111974115"><h4 class="sectiontitle">isfinite(date)</h4><p id="EN-US_TOPIC_0000001495991685__p13894919194111">Description: Checks whether a date is finite.</p>
<p id="EN-US_TOPIC_0000001495991685__p2894419134114">Return type: <span id="EN-US_TOPIC_0000001495991685__text118941019184117">boolean</span></p>
<p id="EN-US_TOPIC_0000001495991685__p4894151964117">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1389411196418"><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></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="n">isfinite</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="n">t</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">isfinite</span><span class="p">(</span><span class="nb">date</span><span class="w"> </span><span class="s1">'infinity'</span><span class="p">);</span>
<span class="w"> </span><span class="n">isfinite</span>
<span class="c1">----------</span>
<span class="w"> </span><span class="n">f</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section3181115124110"><h4 class="sectiontitle">isfinite(timestamp)</h4><p id="EN-US_TOPIC_0000001495991685__p10179156415">Description: Checks whether a timestamp is finite.</p>
<p id="EN-US_TOPIC_0000001495991685__p16188156416">Return type: <span id="EN-US_TOPIC_0000001495991685__text1171815144117">boolean</span></p>
<p id="EN-US_TOPIC_0000001495991685__p3181154419">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen518101524117"><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></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="n">isfinite</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="n">t</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">isfinite</span><span class="p">(</span><span class="k">timestamp</span><span class="w"> </span><span class="s1">'infinity'</span><span class="p">);</span>
<span class="w"> </span><span class="n">isfinite</span>
<span class="c1">----------</span>
<span class="w"> </span><span class="n">f</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section104751710164115"><h4 class="sectiontitle">isfinite(interval)</h4><p id="EN-US_TOPIC_0000001495991685__p194751910124117">Description: Checks whether an interval is finite.</p>
<p id="EN-US_TOPIC_0000001495991685__p1047571015413">Return type: <span id="EN-US_TOPIC_0000001495991685__text104752010134110">boolean</span></p>
<p id="EN-US_TOPIC_0000001495991685__p64755104413">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen247531054117"><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="n">isfinite</span><span class="w"> </span>
<span class="c1">----------</span>
<span class="w"> </span><span class="n">t</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section1879823084018"><h4 class="sectiontitle">justify_days(interval)</h4><p id="EN-US_TOPIC_0000001495991685__p1679720308408">Description: Adjusts interval to 30-day time periods are represented as months</p>
<p id="EN-US_TOPIC_0000001495991685__p167974305404">Return type: interval</p>
<p id="EN-US_TOPIC_0000001495991685__p1779773064010">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1879815306403"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section776122320401"><h4 class="sectiontitle">justify_hours(interval)</h4><p id="EN-US_TOPIC_0000001495991685__p127622312403">Description: Adjusts interval to 24-hour time periods are represented as days</p>
<p id="EN-US_TOPIC_0000001495991685__p27613232408">Return type: interval</p>
<p id="EN-US_TOPIC_0000001495991685__p2076112313407">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen2766239401"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section106021053143819"><h4 class="sectiontitle">justify_interval(interval)</h4><p id="EN-US_TOPIC_0000001495991685__p1460235363818">Description: Adjusts <strong id="EN-US_TOPIC_0000001495991685__b90798265593723">interval</strong> using <strong id="EN-US_TOPIC_0000001495991685__b106311224293723">justify_days</strong> and <strong id="EN-US_TOPIC_0000001495991685__b213357559993723">justify_hours</strong>.</p>
<p id="EN-US_TOPIC_0000001495991685__p36023539386">Return type: interval</p>
<p id="EN-US_TOPIC_0000001495991685__p0602145383818">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen10602053183815"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section629684110382"><h4 class="sectiontitle">localtime</h4><p id="EN-US_TOPIC_0000001495991685__p62952419386">Description: Current time</p>
<p id="EN-US_TOPIC_0000001495991685__p92954419382">Return type: time</p>
<p id="EN-US_TOPIC_0000001495991685__p7295184183811">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen10296144103818"><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="p">;</span>
<span class="w"> </span><span class="k">time</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section9387337183815"><h4 class="sectiontitle">localtimestamp</h4><p id="EN-US_TOPIC_0000001495991685__p20386153703811">Description: Specifies the current date and time.</p>
<p id="EN-US_TOPIC_0000001495991685__p1038610378383">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001495991685__p1738663718386">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1838713763810"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section191111834163810"><h4 class="sectiontitle">makedate(year, dayofyear)</h4><p id="EN-US_TOPIC_0000001495991685__p2111734123813">Description: Returns a date value based on the given year and the number of days in a year.</p>
<p id="EN-US_TOPIC_0000001495991685__p18111103473816">Return type: date</p>
<p id="EN-US_TOPIC_0000001495991685__p5111934153811">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1811123419386"><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">makedate</span><span class="p">(</span><span class="mi">2020</span><span class="p">,</span><span class="w"> </span><span class="mi">60</span><span class="p">);</span>
<span class="w"> </span><span class="n">makedate</span>
<span class="c1">------------</span>
<span class="w"> </span><span class="mi">2020</span><span class="o">-</span><span class="mi">02</span><span class="o">-</span><span class="mi">29</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section189831530103816"><h4 class="sectiontitle">maketime(hour, minute, second)</h4><p id="EN-US_TOPIC_0000001495991685__p16983193033819">Description: Returns a value of the time type based on the given hour, minute, and second. The value of the time type in <span id="EN-US_TOPIC_0000001495991685__text190855893723">GaussDB(DWS)</span> ranges from 00:00:00 to 24:00:00. Therefore, this function is not available when the value of hour is greater than 24 or less than 0.</p>
<p id="EN-US_TOPIC_0000001495991685__p19831430103815">Return type: time</p>
<p id="EN-US_TOPIC_0000001495991685__p11983103093811">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen10983113014388"><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">maketime</span><span class="p">(</span><span class="mi">12</span><span class="p">,</span><span class="w"> </span><span class="mi">15</span><span class="p">,</span><span class="w"> </span><span class="mi">30</span><span class="p">.</span><span class="mi">12</span><span class="p">);</span>
<span class="w"> </span><span class="n">maketime</span>
<span class="c1">-------------</span>
<span class="w"> </span><span class="mi">12</span><span class="p">:</span><span class="mi">15</span><span class="p">:</span><span class="mi">30</span><span class="p">.</span><span class="mi">12</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section1539182843814"><h4 class="sectiontitle">microsecond(timestamp with time zone)</h4><p id="EN-US_TOPIC_0000001495991685__p53815285383">Description: Obtains the microsecond value in the time.</p>
<p id="EN-US_TOPIC_0000001495991685__p538628133818">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p1638528173810">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen133912853810"><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">microsecond</span><span class="p">(</span><span class="n">timestamptz</span><span class="w"> </span><span class="s1">'2018-12-13 12:11:15.123634+06'</span><span class="p">);</span>
<span class="w"> </span><span class="n">microsecond</span>
<span class="c1">-------------</span>
<span class="w"> </span><span class="mi">123634</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section13793162419386"><h4 class="sectiontitle">minute(timestamp with time zone)</h4><p id="EN-US_TOPIC_0000001495991685__p1079262415384">Description: Obtains the minute value in the time.</p>
<p id="EN-US_TOPIC_0000001495991685__p16792102411383">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p679232415383">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen179314243381"><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">minute</span><span class="p">(</span><span class="n">timestamptz</span><span class="w"> </span><span class="s1">'2018-12-13 12:11:15+06'</span><span class="p">);</span>
<span class="w"> </span><span class="k">minute</span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">11</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section351422111382"><h4 class="sectiontitle">month(date)</h4><p id="EN-US_TOPIC_0000001495991685__p45146219385">Description: Returns the month of a given datetime.</p>
<p id="EN-US_TOPIC_0000001495991685__p5514182112386">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p85142211380">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen65147218389"><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">month</span><span class="p">(</span><span class="s1">'2020-11-30'</span><span class="p">);</span>
<span class="w"> </span><span class="k">month</span>
<span class="c1">-------</span>
<span class="w"> </span><span class="mi">11</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section1210751843818"><h4 class="sectiontitle">now([fsp])</h4><p id="EN-US_TOPIC_0000001495991685__p14106718133815">Description: Specifies the start time of the transaction. The parameter determines the microsecond output precision. The default value is <strong id="EN-US_TOPIC_0000001495991685__b154442389793723">6</strong>.</p>
<p id="EN-US_TOPIC_0000001495991685__p1910691814382">Return type: timestamp with time zone</p>
<p id="EN-US_TOPIC_0000001495991685__p110611184389">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen910671873811"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1107131816383"><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="mi">3</span><span class="p">);</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">2021</span><span class="o">-</span><span class="mi">09</span><span class="o">-</span><span class="mi">08</span><span class="w"> </span><span class="mi">10</span><span class="p">:</span><span class="mi">59</span><span class="p">:</span><span class="mi">00</span><span class="p">.</span><span class="mi">427</span><span class="o">+</span><span class="mi">08</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span><span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section3833131483817"><h4 class="sectiontitle">numtodsinterval(num, interval_unit)</h4><p id="EN-US_TOPIC_0000001495991685__p883215148389">Description: Converts a number to the interval type. <strong id="EN-US_TOPIC_0000001495991685__b21835147793723">num</strong> is a numeric-typed number. <strong id="EN-US_TOPIC_0000001495991685__b156889377493723">interval_unit</strong> is a string in the following format: 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND'</p>
<p id="EN-US_TOPIC_0000001495991685__p9832114143817">You can set the <strong id="EN-US_TOPIC_0000001495991685__b175680847893723">IntervalStyle</strong> parameter to <strong id="EN-US_TOPIC_0000001495991685__b100139784293723">oracle</strong> to be compatible with the interval output format of the function in the Oracle database.</p>
<p id="EN-US_TOPIC_0000001495991685__p4832214143813">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen68333147384"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</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="k">SET</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="n">numtodsinterval</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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section697819913385"><h4 class="sectiontitle">pg_sleep(seconds)</h4><p id="EN-US_TOPIC_0000001495991685__p1497711933811">Description: Pauses the current session for a specified number of seconds.</p>
<p id="EN-US_TOPIC_0000001495991685__p697711963819">Return type: void</p>
<p id="EN-US_TOPIC_0000001495991685__p297720911389">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen89773915385"><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="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>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section022412710387"><h4 class="sectiontitle">period_add(P, N)</h4><p id="EN-US_TOPIC_0000001495991685__p7224670383">Description: Returns the date of a given period plus <em id="EN-US_TOPIC_0000001495991685__i98594047593723">N</em> months.</p>
<p id="EN-US_TOPIC_0000001495991685__p3224476387">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p72241471384">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen10224127163814"><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">period_add</span><span class="p">(</span><span class="mi">200801</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">);</span>
<span class="w"> </span><span class="n">period_add</span>
<span class="c1">------------</span>
<span class="w"> </span><span class="mi">200803</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section14272114183812"><h4 class="sectiontitle">period_diff(P1, P2)</h4><p id="EN-US_TOPIC_0000001495991685__p202721415389">Description: Returns the number of months between two given dates.</p>
<p id="EN-US_TOPIC_0000001495991685__p1027294123817">Return type: integer</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen18272448385"><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">period_diff</span><span class="p">(</span><span class="mi">200802</span><span class="p">,</span><span class="w"> </span><span class="mi">200703</span><span class="p">);</span>
<span class="w"> </span><span class="n">period_diff</span>
<span class="c1">-------------</span>
<span class="w"> </span><span class="mi">11</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section760945616370"><h4 class="sectiontitle">quarter(date)</h4><p id="EN-US_TOPIC_0000001495991685__p17608115693713">Description: Obtains the quarter to which the date belongs.</p>
<p id="EN-US_TOPIC_0000001495991685__p126095565376">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p560955611379">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen186097565373"><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">quarter</span><span class="p">(</span><span class="nb">date</span><span class="w"> </span><span class="s1">'2018-12-13'</span><span class="p">);</span>
<span class="w"> </span><span class="n">quarter</span>
<span class="c1">---------</span>
<span class="w"> </span><span class="mi">4</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section124829539373"><h4 class="sectiontitle">second(timestamp with time zone)</h4><p id="EN-US_TOPIC_0000001495991685__p5481195315378">Description: Obtains the second value in the time.</p>
<p id="EN-US_TOPIC_0000001495991685__p1348155383720">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p12481125311378">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen17482165333710"><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">second</span><span class="p">(</span><span class="n">timestamptz</span><span class="w"> </span><span class="s1">'2018-12-13 12:11:15+06'</span><span class="p">);</span>
<span class="w"> </span><span class="k">second</span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">15</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section1354714502373"><h4 class="sectiontitle">statement_timestamp()</h4><p id="EN-US_TOPIC_0000001495991685__p20546350103719">Description: Specifies the current date and time.</p>
<p id="EN-US_TOPIC_0000001495991685__p13546950193711">Return type: timestamp with time zone</p>
<p id="EN-US_TOPIC_0000001495991685__p254655020379">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen6547250113719"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section54552473378"><h4 class="sectiontitle">sysdate</h4><p id="EN-US_TOPIC_0000001495991685__p3455104743714">Description: Specifies the current date and time.</p>
<p id="EN-US_TOPIC_0000001495991685__p8455174718379">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001495991685__p2455144712375">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1945594783710"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section6238143210370"><h4 class="sectiontitle">timeofday()</h4><p id="EN-US_TOPIC_0000001495991685__p1423753214371">Description: Current date and time (like <strong id="EN-US_TOPIC_0000001495991685__b39417333993723">clock_timestamp</strong>, but returned as a <strong id="EN-US_TOPIC_0000001495991685__b41945361593723">text</strong> string)</p>
<p id="EN-US_TOPIC_0000001495991685__p172371132153712">Return type: text</p>
<p id="EN-US_TOPIC_0000001495991685__p1223711321379">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen11238183263710"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section133601529103710"><h4 class="sectiontitle">transaction_timestamp()</h4><p id="EN-US_TOPIC_0000001495991685__p136082943712">Description: Current date and time (equivalent to <a href="#EN-US_TOPIC_0000001495991685__section75999514425">current_timestamp</a>)</p>
<p id="EN-US_TOPIC_0000001495991685__p1936032910373">Return type: timestamp with time zone</p>
<p id="EN-US_TOPIC_0000001495991685__p836022913710">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen10360202919373"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section1443633123720"><h4 class="sectiontitle">from_unixtime(unix_timestamp[,format])</h4><p id="EN-US_TOPIC_0000001495991685__p164351933375">Description: Converts a Unix timestamp to the datetime type when the format string is set to the default value. If the format string is specified, convert the Unix timestamp to a string of a specified format.</p>
<p id="EN-US_TOPIC_0000001495991685__p154351231373">Return type: timestamp (default format string) or text (specified format string)</p>
<p id="EN-US_TOPIC_0000001495991685__p174355303718">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen134365312378"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">from_unixtime</span><span class="p">(</span><span class="mi">875996580</span><span class="p">);</span>
<span class="w"> </span><span class="n">from_unixtime</span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">1997</span><span class="o">-</span><span class="mi">10</span><span class="o">-</span><span class="mi">04</span><span class="w"> </span><span class="mi">20</span><span class="p">:</span><span class="mi">23</span><span class="p">:</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">from_unixtime</span><span class="p">(</span><span class="mi">875996580</span><span class="p">,</span><span class="w"> </span><span class="s1">'%Y %D %M %h:%i:%s'</span><span class="p">);</span>
<span class="w"> </span><span class="n">from_unixtime</span>
<span class="c1">---------------------------</span>
<span class="w"> </span><span class="mi">1997</span><span class="w"> </span><span class="mi">4</span><span class="n">th</span><span class="w"> </span><span class="n">October</span><span class="w"> </span><span class="mi">08</span><span class="p">:</span><span class="mi">23</span><span class="p">:</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section19852125910365"><h4 class="sectiontitle">unix_timestamp([timestamp with time zone])</h4><p id="EN-US_TOPIC_0000001495991685__p1085115943611">Description: Obtains the number of seconds from <strong id="EN-US_TOPIC_0000001495991685__b117234775993723">'1970-01-01 00:00:00'UTC</strong> to the time when the parameter is input. If no parameter is input, set this parameter to the current time.</p>
<p id="EN-US_TOPIC_0000001495991685__p1685117590366">Return type: bigint (no parameter is input) or numeric (parameter is input)</p>
<p id="EN-US_TOPIC_0000001495991685__p14851145963618">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen88522591366"><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">unix_timestamp</span><span class="p">();</span>
<span class="w"> </span><span class="n">unix_timestamp</span>
<span class="c1">----------------</span>
<span class="w"> </span><span class="mi">1693906219</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen3852195917363"><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">unix_timestamp</span><span class="p">(</span><span class="s1">'2018-09-08 12:11:13+06'</span><span class="p">);</span>
<span class="w"> </span><span class="n">unix_timestamp</span>
<span class="c1">----------------</span>
<span class="w"> </span><span class="mi">1536387073</span><span class="p">.</span><span class="mi">000000</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section21521656103616"><h4 class="sectiontitle">add_months(d,n)</h4><p id="EN-US_TOPIC_0000001495991685__p15152165663617">Description: Calculates the time point day and time of nth months.</p>
<p id="EN-US_TOPIC_0000001495991685__p11525560360">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001495991685__p10152165614360">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1715212561365"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section113821507335"><h4 class="sectiontitle">last_day(d)</h4><p id="EN-US_TOPIC_0000001495991685__p113823023315">Description: Calculates the time of the last day in the month.</p>
<ul id="EN-US_TOPIC_0000001495991685__ul6382204334"><li id="EN-US_TOPIC_0000001495991685__li123825043319">In the ORA- or TD-compatible mode, the return type is timestamp.</li><li id="EN-US_TOPIC_0000001495991685__li183828018334">In the MySQL-compatible mode, the return type is date.</li></ul>
<p id="EN-US_TOPIC_0000001495991685__p4382502331">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen238216013317"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section192455556322"><h4 class="sectiontitle">next_day(x,y)</h4><p id="EN-US_TOPIC_0000001495991685__p82450552324">Description: Calculates the time of the next week y started from x</p>
<ul id="EN-US_TOPIC_0000001495991685__ul1924585520329"><li id="EN-US_TOPIC_0000001495991685__li92451455113211">In the ORA- or TD-compatible mode, the return type is timestamp.</li><li id="EN-US_TOPIC_0000001495991685__li8245955113217">In the MySQL-compatible mode, the return type is date.</li></ul>
<p id="EN-US_TOPIC_0000001495991685__p024545515329">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen1624595513324"><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="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="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section652704263213"><h4 class="sectiontitle">from_days(days)</h4><p id="EN-US_TOPIC_0000001495991685__p14527742163218">Description: Returns the corresponding date value based on the given number of days.</p>
<p id="EN-US_TOPIC_0000001495991685__p452764273210">Return type: date</p>
<p id="EN-US_TOPIC_0000001495991685__p1252724293214">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen9527154219328"><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">from_days</span><span class="p">(</span><span class="mi">730669</span><span class="p">);</span>
<span class="w"> </span><span class="n">from_days</span>
<span class="c1">------------</span>
<span class="w"> </span><span class="mi">2000</span><span class="o">-</span><span class="mi">07</span><span class="o">-</span><span class="mi">03</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495991685__section13224937123213"><h4 class="sectiontitle">to_days(timestamp)</h4><p id="EN-US_TOPIC_0000001495991685__p11224113711320">Description: Returns the number of days from the first day of year 0 to a specified date.</p>
<p id="EN-US_TOPIC_0000001495991685__p9224193743210">Return type: integer</p>
<p id="EN-US_TOPIC_0000001495991685__p52243371326">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495991685__screen112241837163211"><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="n">to_days</span>
<span class="c1">---------</span>
<span class="w"> </span><span class="mi">733687</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0035.html">Date and Time Processing Functions and Operators</a></div>
</div>
</div>
View Git Blame Copy Permalink