doc-exports/docs/dws/dev/dws_06_0313.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

308 lines
26 KiB
HTML

<a name="EN-US_TOPIC_0000001446551140"></a><a name="EN-US_TOPIC_0000001446551140"></a>
<h1 class="topictitle1">time_format</h1>
<div id="body0000001446551140"><div class="section" id="EN-US_TOPIC_0000001446551140__section141812471568"><h4 class="sectiontitle">time_format(time, fmt)</h4><p id="EN-US_TOPIC_0000001446551140__p5180124755611">Description: The <strong id="EN-US_TOPIC_0000001446551140__b131840772193654">time_format</strong> function converts the <strong id="EN-US_TOPIC_0000001446551140__b144783681393654">date</strong> parameter into a string in the format specified by <strong id="EN-US_TOPIC_0000001446551140__b48615261493654">fmt</strong>. It is similar to the <strong id="EN-US_TOPIC_0000001446551140__b39341826102318">date_format</strong> function, but the format string can contain only hour, minute, second, and microsecond format specifiers. If other specifiers are contained, <strong id="EN-US_TOPIC_0000001446551140__b131816157243">NULL</strong> or <strong id="EN-US_TOPIC_0000001446551140__b1826710178243">0</strong> is returned.</p>
<p id="EN-US_TOPIC_0000001446551140__p61809478567">Return type: text</p>
<p id="EN-US_TOPIC_0000001446551140__p1318012479568">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446551140__screen1135912214260"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">time_format</span><span class="p">(</span><span class="s1">'2009-10-04 22:23:00'</span><span class="p">,</span><span class="w"> </span><span class="s1">'%M %D %W'</span><span class="p">);</span>
<span class="w"> </span><span class="n">time_format</span>
<span class="c1">--------------------</span>
<span class="w"> </span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">time_format</span><span class="p">(</span><span class="s1">'2021-02-20 08:30:45'</span><span class="p">,</span><span class="w"> </span><span class="s1">'%Y-%m-%d %H:%i:%S'</span><span class="p">);</span>
<span class="w"> </span><span class="n">time_format</span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">0000</span><span class="o">-</span><span class="mi">00</span><span class="o">-</span><span class="mi">00</span><span class="w"> </span><span class="mi">08</span><span class="p">:</span><span class="mi">30</span><span class="p">:</span><span class="mi">45</span>
<span class="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">time_format</span><span class="p">(</span><span class="s1">'2021-02-20 18:10:15'</span><span class="p">,</span><span class="w"> </span><span class="s1">'%r-%T'</span><span class="p">);</span>
<span class="w"> </span><span class="n">time_format</span>
<span class="c1">----------------------</span>
<span class="w"> </span><span class="mi">06</span><span class="p">:</span><span class="mi">10</span><span class="p">:</span><span class="mi">15</span><span class="w"> </span><span class="n">PM</span><span class="o">-</span><span class="mi">18</span><span class="p">:</span><span class="mi">10</span><span class="p">:</span><span class="mi">15</span>
<span class="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="notice" id="EN-US_TOPIC_0000001446551140__note15181174716568"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001446551140__p418124711564"><strong id="EN-US_TOPIC_0000001446551140__b47554006693654">time_format</strong> supports only time-related formats (%f, %H, %h, %I, %i, %k, %l, %p, %r, %S, %s, and %T) and does not support date-related formats. In other cases, <strong id="EN-US_TOPIC_0000001446551140__b161379825893654">time_format</strong> is output as common characters.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001446551140__section19231141175620"><h4 class="sectiontitle">str_to_date(str, format)</h4><p id="EN-US_TOPIC_0000001446551140__p189231241165612">Description: Converts a string of the date/time type to a value of the date type according to the provided display format.</p>
<p id="EN-US_TOPIC_0000001446551140__p1923184145616">Return type: timestamp</p>
<p id="EN-US_TOPIC_0000001446551140__p12923741135615">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446551140__screen129237418567"><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">str_to_date</span><span class="p">(</span><span class="s1">'01,5,2021'</span><span class="p">,</span><span class="s1">'%d,%m,%Y'</span><span class="p">);</span>
<span class="w"> </span><span class="n">str_to_date</span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2021</span><span class="o">-</span><span class="mi">05</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="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">str_to_date</span><span class="p">(</span><span class="s1">'01,5,2021,09,30,17'</span><span class="p">,</span><span class="s1">'%d,%m,%Y,%h,%i,%s'</span><span class="p">);</span>
<span class="w"> </span><span class="n">str_to_date</span>
<span class="c1">---------------------</span>
<span class="w"> </span><span class="mi">2021</span><span class="o">-</span><span class="mi">05</span><span class="o">-</span><span class="mi">01</span><span class="w"> </span><span class="mi">09</span><span class="p">:</span><span class="mi">30</span><span class="p">:</span><span class="mi">17</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_0000001446551140__p3923104145619">For details about the input format types applicable to <strong id="EN-US_TOPIC_0000001446551140__b170095786393654">str_to_date</strong>, see <a href="dws_06_0312.html#EN-US_TOPIC_0000001446391160__table135107162552">Table 1</a>. Only input values of the date or date/time type can be converted. Use <strong id="EN-US_TOPIC_0000001446551140__b142397280193654">str_to_time</strong> when only values of the time type are input.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001446551140__section192093911563"><h4 class="sectiontitle">str_to_time(str, format)</h4><p id="EN-US_TOPIC_0000001446551140__p1319133945620">Description: Converts a string of the time type to a value of the time type according to the provided display format.</p>
<p id="EN-US_TOPIC_0000001446551140__p1519113914568">Return type: time</p>
<p id="EN-US_TOPIC_0000001446551140__p1919103919568">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446551140__screen1619153905611"><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">str_to_time</span><span class="p">(</span><span class="s1">'09:30:17'</span><span class="p">,</span><span class="s1">'%h:%i:%s'</span><span class="p">);</span>
<span class="w"> </span><span class="n">str_to_time</span>
<span class="c1">-------------</span>
<span class="w"> </span><span class="mi">09</span><span class="p">:</span><span class="mi">30</span><span class="p">:</span><span class="mi">17</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_0000001446551140__p220143975616">For details about the input format types applicable to <strong id="EN-US_TOPIC_0000001446551140__b853902812198">str_to_time</strong>, see <a href="dws_06_0312.html#EN-US_TOPIC_0000001446391160__table135107162552">Table 1</a>. Only input values of the time type can be converted. Use <strong id="EN-US_TOPIC_0000001446551140__b11541128151910">str_to_date</strong> when values of the date or date/time type are input.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001446551140__section014623612568"><h4 class="sectiontitle">week(date[, mode])</h4><p id="EN-US_TOPIC_0000001446551140__p12141236185616">Description: Returns the number of weeks in the year of the specified datetime. The default value is <strong id="EN-US_TOPIC_0000001446551140__b203123770993654">0</strong>.</p>
<p id="EN-US_TOPIC_0000001446551140__p01411364564">Return type: integer</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001446551140__table014483619566" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Working principle of the mode in the week function</caption><thead align="left"><tr id="EN-US_TOPIC_0000001446551140__row7141136145610"><th align="left" class="cellrowborder" valign="top" width="10%" id="mcps1.3.4.4.2.5.1.1"><p id="EN-US_TOPIC_0000001446551140__p13141536125611">Schema</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.4.2.5.1.2"><p id="EN-US_TOPIC_0000001446551140__p1214193645614">First Day of a Week</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.4.2.5.1.3"><p id="EN-US_TOPIC_0000001446551140__p17141113665615">Week Range</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.4.2.5.1.4"><p id="EN-US_TOPIC_0000001446551140__p15141103611564">Rule for Determining the First Week</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001446551140__row214213615615"><td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.4.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001446551140__p1014123685617">0</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001446551140__p7141163645610">Sun</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001446551140__p414116369561">0-53</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001446551140__p914283665618">Week of the first Sunday after New Year's Day</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001446551140__row1014263635620"><td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.4.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001446551140__p514223614564">1</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001446551140__p151421936125618">Mon</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001446551140__p41421336195620">0-53</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001446551140__p6142123616563">Week with four or more days after New Year's Day</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001446551140__row2143153610569"><td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.4.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001446551140__p121426361567">2</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001446551140__p71424361569">Sun</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001446551140__p201421536155617">1-53</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001446551140__p121431336135611">Week of the first Sunday after New Year's Day</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001446551140__row914313625615"><td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.4.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001446551140__p1514343613560">3</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001446551140__p2014333685611">Mon</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001446551140__p15143203617569">1-53</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001446551140__p9143193685617">Week with four or more days after New Year's Day</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001446551140__row131431636165617"><td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.4.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001446551140__p81432036195619">4</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001446551140__p16143153675616">Sun</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001446551140__p31436368565">0-53</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001446551140__p1514310365564">Week with four or more days after New Year's Day</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001446551140__row14144173614564"><td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.4.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001446551140__p4143336115617">5</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001446551140__p1414353611561">Mon</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001446551140__p7143143605613">0-53</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001446551140__p1014493618565">Week of the first Monday after New Year's Day</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001446551140__row31441736195613"><td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.4.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001446551140__p014416364565">6</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001446551140__p7144113613561">Sun</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001446551140__p1614411364562">1-53</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001446551140__p12144236175617">Week with four or more days after New Year's Day</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001446551140__row19144336185612"><td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.4.4.2.5.1.1 "><p id="EN-US_TOPIC_0000001446551140__p1144173619562">7</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.2 "><p id="EN-US_TOPIC_0000001446551140__p1314453655614">Mon</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.4.2.5.1.3 "><p id="EN-US_TOPIC_0000001446551140__p314403615568">1-53</p>
</td>
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.4.2.5.1.4 "><p id="EN-US_TOPIC_0000001446551140__p714411363561">Week of the first Monday after New Year's Day</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0000001446551140__p714443625610">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446551140__screen7146183610564"><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">week</span><span class="p">(</span><span class="s1">'2018-01-01'</span><span class="p">);</span>
<span class="w"> </span><span class="n">week</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>
<span class="k">SELECT</span><span class="w"> </span><span class="n">week</span><span class="p">(</span><span class="s1">'2018-01-01'</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">);</span>
<span class="w"> </span><span class="n">week</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>
<span class="k">SELECT</span><span class="w"> </span><span class="n">week</span><span class="p">(</span><span class="s1">'2020-12-31'</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">);</span>
<span class="w"> </span><span class="n">week</span>
<span class="c1">------</span>
<span class="w"> </span><span class="mi">53</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">week</span><span class="p">(</span><span class="s1">'2020-12-31'</span><span class="p">,</span><span class="w"> </span><span class="mi">5</span><span class="p">);</span>
<span class="w"> </span><span class="n">week</span>
<span class="c1">------</span>
<span class="w"> </span><span class="mi">52</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_0000001446551140__section1235553095616"><h4 class="sectiontitle">weekday(date)</h4><p id="EN-US_TOPIC_0000001446551140__p835403016567">Description: Returns the week index corresponding to the given date, with Monday as the start day of the week.</p>
<p id="EN-US_TOPIC_0000001446551140__p1035413302568">Value range: 0 to 6</p>
<p id="EN-US_TOPIC_0000001446551140__p18354173025610">Return type: integer</p>
<p id="EN-US_TOPIC_0000001446551140__p43541730105617">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446551140__screen135514305567"><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">weekday</span><span class="p">(</span><span class="s1">'2020-11-06'</span><span class="p">);</span>
<span class="w"> </span><span class="n">weekday</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_0000001446551140__section15603727105618"><h4 class="sectiontitle">weekofyear(date)</h4><p id="EN-US_TOPIC_0000001446551140__p10602227105612">Description: Returns the number of weeks in the current year for the week of the given date. The value ranges from 1 to 53, which is equivalent to week(date, 3).</p>
<p id="EN-US_TOPIC_0000001446551140__p7602142725610">Return type: integer</p>
<p id="EN-US_TOPIC_0000001446551140__p960310277566">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446551140__screen86039275561"><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">weekofyear</span><span class="p">(</span><span class="s1">'2020-12-30'</span><span class="p">);</span>
<span class="w"> </span><span class="n">weekofyear</span>
<span class="c1">------------</span>
<span class="w"> </span><span class="mi">53</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_0000001446551140__section18905192415562"><h4 class="sectiontitle">year(date)</h4><p id="EN-US_TOPIC_0000001446551140__p6904202475619">Description: Obtains the year of the <strong id="EN-US_TOPIC_0000001446551140__b96305260893654">date</strong>.</p>
<p id="EN-US_TOPIC_0000001446551140__p109041024135610">Return type: integer</p>
<p id="EN-US_TOPIC_0000001446551140__p79053242561">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446551140__screen5905524175615"><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">year</span><span class="p">(</span><span class="s1">'2020-11-13'</span><span class="p">);</span>
<span class="w"> </span><span class="k">year</span>
<span class="c1">------</span>
<span class="w"> </span><span class="mi">2020</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_0000001446551140__section475102213563"><h4 class="sectiontitle">yearweek(date[, mode])</h4><p id="EN-US_TOPIC_0000001446551140__p1774122215562">Description: Returns the year and the number of weeks in the current year for the given date. The number of weeks ranges from 1 to 53.</p>
<p id="EN-US_TOPIC_0000001446551140__p674172211566">Return type: integer</p>
<p id="EN-US_TOPIC_0000001446551140__p5741722155613">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001446551140__screen147512217568"><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">yearweek</span><span class="p">(</span><span class="s1">'2019-12-31'</span><span class="p">);</span>
<span class="w"> </span><span class="n">yearweek</span>
<span class="c1">----------</span>
<span class="w"> </span><span class="mi">201952</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">yearweek</span><span class="p">(</span><span class="s1">'2019-1-1'</span><span class="p">);</span>
<span class="w"> </span><span class="n">yearweek</span>
<span class="c1">----------</span>
<span class="w"> </span><span class="mi">201852</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>