vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0310.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

378 lines
39 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

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

<a name="EN-US_TOPIC_0000001446071316"></a><a name="EN-US_TOPIC_0000001446071316"></a>
<h1 class="topictitle1">EXTRACT</h1>
<div id="body0000001446071316"><p id="EN-US_TOPIC_0000001446071316__a2a42c7b0db8a4385a1b5f0b9ca31ca16"><strong id="EN-US_TOPIC_0000001446071316__a1389a7c6f10f4e908b0930aa7cd1e69a">EXTRACT(</strong><em id="EN-US_TOPIC_0000001446071316__ac9bf5af929fd4f75a94101133184750b">field </em><strong id="EN-US_TOPIC_0000001446071316__a9bd77c3240114c8b81d7e060a912e210">FROM </strong><em id="EN-US_TOPIC_0000001446071316__acd843a3181b24fb29495159f5d89792b">source</em><strong id="EN-US_TOPIC_0000001446071316__a5f00c4f3ec7541398e13d4a4451cc859">)</strong></p>
<p id="EN-US_TOPIC_0000001446071316__af89794a380554ab5a6e39f77975de12f">The <strong id="EN-US_TOPIC_0000001446071316__b155970471094230">extract</strong> function retrieves subcolumns such as year or hour from date/time values. <strong id="EN-US_TOPIC_0000001446071316__b200947300694230">source</strong> must be a value expression of type <strong id="EN-US_TOPIC_0000001446071316__b214605056694230">timestamp</strong>, <strong id="EN-US_TOPIC_0000001446071316__b20276050294230">time</strong>, or <strong id="EN-US_TOPIC_0000001446071316__b149257816794230">interval</strong>. (Expressions of type <strong id="EN-US_TOPIC_0000001446071316__b52905239294230">date</strong> are cast to <strong id="EN-US_TOPIC_0000001446071316__b82813569394230">timestamp</strong> and can therefore be used as well.) <strong id="EN-US_TOPIC_0000001446071316__b26591085294230">field</strong> is an identifier or string that selects what column to extract from the source value. The <strong id="EN-US_TOPIC_0000001446071316__b127149103994230">extract</strong> function returns values of type <strong id="EN-US_TOPIC_0000001446071316__b111970952894230">double precision</strong>. The following are valid field names:</p>
<div class="section" id="EN-US_TOPIC_0000001446071316__section1428015344186"><h4 class="sectiontitle">century</h4><p id="EN-US_TOPIC_0000001446071316__p1268153414181">Century</p>
<p id="EN-US_TOPIC_0000001446071316__p1226843412180">The first century starts at 0001-01-01 00:00:00 AD. This definition applies to all Gregorian calendar countries. There is no century number 0. You go from <strong id="EN-US_TOPIC_0000001446071316__b16977425494230">-1</strong> century to <strong id="EN-US_TOPIC_0000001446071316__b14418960594230">1</strong> century.</p>
<p id="EN-US_TOPIC_0000001446071316__p1626823451813">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen6268143410185"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">century</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2000-12-16 12:21:13'</span><span class="p">);</span>
<span class="w"> </span><span class="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_0000001446071316__section8264195961811"><h4 class="sectiontitle">day</h4><ul id="EN-US_TOPIC_0000001446071316__ul1726475971813"><li id="EN-US_TOPIC_0000001446071316__li1026345912184">For <strong id="EN-US_TOPIC_0000001446071316__b14993622494230">timestamp</strong> values, the day (of the month) column (1–31)<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen1326325912186"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">day</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</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">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001446071316__li172644594189">For <strong id="EN-US_TOPIC_0000001446071316__b56821383494230">interval</strong> values, the number of days<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen17264105961815"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">day</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="nb">INTERVAL</span><span class="w"> </span><span class="s1">'40 days 1 minute'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">40</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>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001446071316__section9773194520182"><h4 class="sectiontitle">decade</h4><p id="EN-US_TOPIC_0000001446071316__p107655450188">Year column divided by 10</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen11766144510188"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">decade</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">200</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_0000001446071316__section16504184951812"><h4 class="sectiontitle">dow</h4><p id="EN-US_TOPIC_0000001446071316__p249734961814">Day of the week as Sunday(<strong id="EN-US_TOPIC_0000001446071316__b142191029894230">0</strong>) to Saturday (<strong id="EN-US_TOPIC_0000001446071316__b140664197794230">6</strong>)</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen2497649201816"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">dow</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">5</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_0000001446071316__section1772915591916"><h4 class="sectiontitle">doy</h4><p id="EN-US_TOPIC_0000001446071316__p57191757197">Day of the year (1–365 or 366)</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen8720155101917"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">doy</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">47</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_0000001446071316__section4858143043010"><h4 class="sectiontitle">epoch</h4><ul id="EN-US_TOPIC_0000001446071316__ul1885823043016"><li id="EN-US_TOPIC_0000001446071316__li10857230193012">For <strong id="EN-US_TOPIC_0000001446071316__b202381731494230">timestamp with time zone</strong> values, the number of seconds since 1970-01-01 00:00:00 UTC (can be negative);<p id="EN-US_TOPIC_0000001446071316__p118551030173014">for <strong id="EN-US_TOPIC_0000001446071316__b155391410094230">date</strong> and <strong id="EN-US_TOPIC_0000001446071316__b57038863794230">timestamp</strong> values, the number of seconds since 1970-01-01 00:00:00 local time;</p>
<p id="EN-US_TOPIC_0000001446071316__p128551530153012">for <strong id="EN-US_TOPIC_0000001446071316__b117276418194230">interval</strong> values, the total number of seconds in the interval.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen168561301302"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">epoch</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="k">TIME</span><span class="w"> </span><span class="k">ZONE</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40.12-08'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">--------------</span>
<span class="w"> </span><span class="mi">982384720</span><span class="p">.</span><span class="mi">12</span>
<span class="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_0000001446071316__screen1685763073018"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">epoch</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'5 days 3 hours'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">442800</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>
</li><li id="EN-US_TOPIC_0000001446071316__li6857103013308">Way to convert an epoch value back to a timestamp<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen1585753010304"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="k">TIME</span><span class="w"> </span><span class="k">ZONE</span><span class="w"> </span><span class="s1">'epoch'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">982384720</span><span class="p">.</span><span class="mi">12</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'1 second'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------------</span>
<span class="w"> </span><span class="mi">2001</span><span class="o">-</span><span class="mi">02</span><span class="o">-</span><span class="mi">17</span><span class="w"> </span><span class="mi">12</span><span class="p">:</span><span class="mi">38</span><span class="p">:</span><span class="mi">40</span><span class="p">.</span><span class="mi">12</span><span class="o">+</span><span class="mi">08</span>
<span class="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>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001446071316__section792918164212"><h4 class="sectiontitle">hour</h4><p id="EN-US_TOPIC_0000001446071316__p2928101612213">Hour column (0–23)</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen1692920162215"><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_0000001446071316__section1584214132213"><h4 class="sectiontitle">isodow</h4><p id="EN-US_TOPIC_0000001446071316__p178411413132117">Day of the week (1–7)</p>
<p id="EN-US_TOPIC_0000001446071316__p1184171311217">Monday is 1 and Sunday is 7.</p>
<div class="note" id="EN-US_TOPIC_0000001446071316__note1584119137214"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001446071316__p184111382110">This is identical to <strong id="EN-US_TOPIC_0000001446071316__b159797436594230">dow</strong> except for Sunday.</p>
</div></div>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen5842131318218"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">isodow</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-18 20:38:40'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">7</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_0000001446071316__section1245815578205"><h4 class="sectiontitle">isoyear</h4><p id="EN-US_TOPIC_0000001446071316__p4457157162017">The ISO 8601 year that the date falls in (not applicable to intervals).</p>
<p id="EN-US_TOPIC_0000001446071316__p14571457152013">Each ISO year begins with the Monday of the week containing the 4th of January, so in early January or late December the ISO year may be different from the Gregorian year. See the <strong id="EN-US_TOPIC_0000001446071316__b117145103094230">week</strong> column for more information.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen44571570207"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">isoyear</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="nb">DATE</span><span class="w"> </span><span class="s1">'2006-01-01'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">2005</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_0000001446071316__screen2458157152012"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">isoyear</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="nb">DATE</span><span class="w"> </span><span class="s1">'2006-01-02'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">2006</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_0000001446071316__section778516530206"><h4 class="sectiontitle">microseconds</h4><p id="EN-US_TOPIC_0000001446071316__p7785175302017">The seconds column, including fractional parts, multiplied by 1,000,000</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen3785135352011"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">microseconds</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIME</span><span class="w"> </span><span class="s1">'17:12:28.5'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">28500000</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_0000001446071316__section1967004718203"><h4 class="sectiontitle">millennium</h4><p id="EN-US_TOPIC_0000001446071316__p96691647132018">Millennium</p>
<p id="EN-US_TOPIC_0000001446071316__p20669104772016">Years in the 1900s are in the second millennium. The third millennium started from January 1, 2001.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen146701847122017"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">millennium</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span>
<span class="w"> </span><span class="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_0000001446071316__section118855032016"><h4 class="sectiontitle">milliseconds</h4><p id="EN-US_TOPIC_0000001446071316__p3188115019208">The seconds column, including fractional parts, multiplied by 1000. Note that this includes full seconds.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen17188135014203"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">milliseconds</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIME</span><span class="w"> </span><span class="s1">'17:12:28.5'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">28500</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_0000001446071316__section6671344132011"><h4 class="sectiontitle">minute</h4><p id="EN-US_TOPIC_0000001446071316__p166174402014">Minutes column (0–59)</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen12671444102019"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">minute</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">38</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_0000001446071316__section94181857111912"><h4 class="sectiontitle">month</h4><p id="EN-US_TOPIC_0000001446071316__p12417135717190">For <strong id="EN-US_TOPIC_0000001446071316__b208811308094230">timestamp</strong> values, the number of the month within the year (1–12);</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen174172574198"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">month</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">2</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_0000001446071316__p19417115761918">For <strong id="EN-US_TOPIC_0000001446071316__b158145986194230">interval</strong> values, the number of months, modulo 12 (0–11)</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen64171457121916"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">month</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="nb">interval</span><span class="w"> </span><span class="s1">'2 years 13 months'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </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_0000001446071316__section58010535190"><h4 class="sectiontitle">quarter</h4><p id="EN-US_TOPIC_0000001446071316__p1877125310191">Quarter of the year (1–4) that the date is in</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen1480145318192"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">quarter</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </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_0000001446071316__section1893124411191"><h4 class="sectiontitle">second</h4><p id="EN-US_TOPIC_0000001446071316__p99274451910">Seconds column, including fractional parts (0–59)</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen1935448190"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">second</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIME</span><span class="w"> </span><span class="s1">'17:12:28.5'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">28</span><span class="p">.</span><span class="mi">5</span>
<span class="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_0000001446071316__section1973224014195"><h4 class="sectiontitle">timezone</h4><p id="EN-US_TOPIC_0000001446071316__p2732740151918">The time zone offset from UTC, measured in seconds. Positive values correspond to time zones east of UTC, negative values to zones west of UTC.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen2073254019197"><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">timezone</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">TIMETZ</span><span class="w"> </span><span class="s1">'17:12:28'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">0</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_0000001446071316__section6580137171913"><h4 class="sectiontitle">timezone_hour</h4><p id="EN-US_TOPIC_0000001446071316__p16580133711916">The hour component of the time zone offset</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen25801337151918"><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">timezone_hour</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">TIMETZ</span><span class="w"> </span><span class="s1">'17:12:28'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">0</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_0000001446071316__section6697103431917"><h4 class="sectiontitle">timezone_minute</h4><p id="EN-US_TOPIC_0000001446071316__p14696334151911">The minute component of the time zone offset</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen136971334171917"><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">timezone_minute</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">TIMETZ</span><span class="w"> </span><span class="s1">'17:12:28'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">0</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_0000001446071316__section14254113111194"><h4 class="sectiontitle">week</h4><p id="EN-US_TOPIC_0000001446071316__p425413311195">The number of the week of the year that the day is in. By definition (ISO 8601), the first week of a year contains January 4 of that year. (The ISO-8601 week starts on Monday.) In other words, the first Thursday of a year is in week 1 of that year.</p>
<p id="EN-US_TOPIC_0000001446071316__p10254731171913">Because of this, it is possible for early January dates to be part of the 52nd or 53rd week of the previous year, and late December dates to be part of the 1st week of the next year. For example, <strong id="EN-US_TOPIC_0000001446071316__b37911066994230">2005-01-01</strong> is part of the 53rd week of year 2004, <strong id="EN-US_TOPIC_0000001446071316__b168585270794230">2006-01-01</strong> is part of the 52nd week of year 2005, and <strong id="EN-US_TOPIC_0000001446071316__b93863611694230">2012-12-31</strong> is part of the 1st week of year 2013. You are advised to use the columns <strong id="EN-US_TOPIC_0000001446071316__b80580738094230">isoyear</strong> and <strong id="EN-US_TOPIC_0000001446071316__b69713201094230">week</strong> together to ensure consistency.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen102542031131913"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="n">week</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">7</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_0000001446071316__section1286172814193"><h4 class="sectiontitle">year</h4><p id="EN-US_TOPIC_0000001446071316__p1841428101916">Year column</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446071316__screen286192816195"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">EXTRACT</span><span class="p">(</span><span class="k">year</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="k">TIMESTAMP</span><span class="w"> </span><span class="s1">'2001-02-16 20:38:40'</span><span class="p">);</span>
<span class="w"> </span><span class="n">date_part</span><span class="w"> </span>
<span class="c1">-----------</span>
<span class="w"> </span><span class="mi">2001</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