vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/tool/dws_mt_0135.html
Lu, Huayi 27019c2991 DWS TOOL 830.201 version 
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
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:35:25 +00:00

203 lines
44 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001819336293"></a><a name="EN-US_TOPIC_0000001819336293"></a>
<h1 class="topictitle1">Date Functions</h1>
<div id="body8662426"><p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p8060118">This section describes the following date functions:</p>
<ul id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_ul29761369112"><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li12975261212"><a href="#EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section1351029182812">ADD_MONTHS</a></li><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li1297566219"><a href="#EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section1521011916174">DATE_TRUNC</a></li><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li19751761310"><a href="#EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section79301937142811">LAST_DAY</a></li><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li19751614113"><a href="#EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section47599521288">MONTHS_BETWEEN</a></li><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li29768616110"><a href="#EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section12301686294">SYSTIMESTAMP</a></li></ul>
<div class="section" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section1351029182812"><a name="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section1351029182812"></a><a name="en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section1351029182812"></a><h4 class="sectiontitle">ADD_MONTHS</h4><p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p1372522114548"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_b17483661962">ADD_MONTHS</strong> is an Oracle system function and is not implicitly supported by <span id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_text1958020141713">GaussDB(DWS)</span>.</p>
<div class="note" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_note4591111795113"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p2028695081020">Before using this function, perform the following operations:</p>
<ol id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_ol6136555151011"><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li755221117">Create and use the <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b3023815719">MIG_ORA_EXT</strong> schema.</li><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li131366556109">Copy the content of the custom script and execute the script in all target databases for which migration is to be performed. For details, see <a href="dws_16_0017.html#EN-US_TOPIC_0000001819336065">Migration Process</a>.</li></ol>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p8758175506">ADD_MONTHS returns a date with the month.</p>
</div></div>
<ul id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_ul13609313171810"><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li161081316181">Data type of the <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b1263817204312">date</strong> parameter is DATETIME.</li><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li20610813111810">Data type of the <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_b142181059131014">integer</strong> parameter is INTEGER.</li></ul>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p19610131319181">The return type is DATE.</p>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p5994516198"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b29511777615">Input</strong> - <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b411911110620">ADD_MONTHS</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_screen1099620121912"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span>
<span class="w"> </span><span class="n">TO_CHAR</span><span class="p">(</span><span class="w"> </span><span class="n">ADD_MONTHS</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">hire_date</span><span class="w"> </span><span class="p">,</span><span class="mi">1</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="s1">'DD-MON-YYYY'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="ss">&quot;Next month&quot;</span>
<span class="w"> </span><span class="k">FROM</span>
<span class="w"> </span><span class="n">employees</span>
<span class="w"> </span><span class="k">WHERE</span>
<span class="w"> </span><span class="n">last_name</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s1">'Baer'</span>
<span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p461923191"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b17908207617">Output</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_screen13982141913"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span>
<span class="w"> </span><span class="n">TO_CHAR</span><span class="p">(</span><span class="w"> </span><span class="n">MIG_ORA_EXT</span><span class="p">.</span><span class="n">ADD_MONTHS</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">hire_date</span><span class="w"> </span><span class="p">,</span><span class="mi">1</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="s1">'DD-MON-YYYY'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="ss">&quot;Next month&quot;</span>
<span class="w"> </span><span class="k">FROM</span>
<span class="w"> </span><span class="n">employees</span>
<span class="w"> </span><span class="k">WHERE</span>
<span class="w"> </span><span class="n">last_name</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s1">'Baer'</span>
<span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_section6202750131512"><h4 class="sectiontitle">TO_DATE with Third Parameter</h4><p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_p46965281518">In TO_DATE(' 2019-05-02 00:00:00', 'SYYYY-MM-DD HH24:MI:SS', 'NLS_CALENDAR=GREGORIAN'), the third parameter should be commented.</p>
</div>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_p155316124155"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b151302245187">Input</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_screen1819414285186"><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></pre></div></td><td class="code"><div><pre><span></span><span class="w"> </span><span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">PRODUCT</span>
<span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">prod_id</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span>
<span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="n">prod_code</span><span class="w"> </span><span class="nb">VARCHAR</span><span class="p">(</span><span class="mi">5</span><span class="p">)</span><span class="w"> </span>
<span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="n">prod_name</span><span class="w"> </span><span class="nb">VARCHAR</span><span class="p">(</span><span class="mi">100</span><span class="p">)</span>
<span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="n">unit_price</span><span class="w"> </span><span class="nb">NUMERIC</span><span class="p">(</span><span class="mi">6</span><span class="p">,</span><span class="mi">2</span><span class="p">)</span><span class="w"> </span><span class="k">NOT</span><span class="w"> </span><span class="k">NULL</span>
<span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="n">manufacture_date</span><span class="w"> </span><span class="nb">DATE</span><span class="w"> </span><span class="k">DEFAULT</span><span class="w"> </span><span class="n">sysdate</span><span class="w"> </span><span class="p">)</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">RANGE</span><span class="w"> </span><span class="p">(</span><span class="n">manufacture_date</span><span class="p">)</span>
<span class="w"> </span><span class="p">(</span><span class="n">PARTITION</span><span class="w"> </span><span class="ss">&quot;P_20190501&quot;</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="k">LESS</span><span class="w"> </span><span class="k">THAN</span><span class="w"> </span><span class="p">(</span><span class="n">TO_DATE</span><span class="p">(</span><span class="s1">' 2019-05-02 00:00:00'</span><span class="p">,</span><span class="w"> </span><span class="s1">'SYYYY-MM-DD HH24:MI:SS'</span><span class="p">,</span><span class="w"> </span><span class="s1">'NLS_CALENDAR=GREGORIAN'</span><span class="p">))</span><span class="w"> </span>
<span class="w"> </span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_p1163101619182"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b6131132471816">Output</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_screen16613332181813"><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></pre></div></td><td class="code"><div><pre><span></span><span class="w"> </span><span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">PRODUCT</span>
<span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">prod_id</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span>
<span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="n">prod_code</span><span class="w"> </span><span class="nb">VARCHAR</span><span class="p">(</span><span class="mi">5</span><span class="p">)</span><span class="w"> </span>
<span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="n">prod_name</span><span class="w"> </span><span class="nb">VARCHAR</span><span class="p">(</span><span class="mi">100</span><span class="p">)</span>
<span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="n">unit_price</span><span class="w"> </span><span class="nb">NUMERIC</span><span class="p">(</span><span class="mi">6</span><span class="p">,</span><span class="mi">2</span><span class="p">)</span><span class="w"> </span><span class="k">NOT</span><span class="w"> </span><span class="k">NULL</span>
<span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="n">manufacture_date</span><span class="w"> </span><span class="nb">DATE</span><span class="w"> </span><span class="k">DEFAULT</span><span class="w"> </span><span class="n">sysdate</span><span class="w"> </span><span class="p">)</span>
<span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">RANGE</span><span class="w"> </span><span class="p">(</span><span class="n">manufacture_date</span><span class="p">)</span>
<span class="w"> </span><span class="p">(</span><span class="n">PARTITION</span><span class="w"> </span><span class="ss">&quot;P_20190501&quot;</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="k">LESS</span><span class="w"> </span><span class="k">THAN</span><span class="w"> </span><span class="p">(</span><span class="n">TO_DATE</span><span class="p">(</span><span class="s1">' 2019-05-02 00:00:00'</span><span class="p">,</span><span class="w"> </span><span class="s1">'YYYY-MM-DD HH24:MI:SS'</span><span class="cm">/* , 'NLS_CALENDAR=GREGORIAN' */</span><span class="p">))</span><span class="w"> </span>
<span class="w"> </span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section1521011916174"><a name="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section1521011916174"></a><a name="en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section1521011916174"></a><h4 class="sectiontitle">DATE_TRUNC</h4><p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p1021099151716">The DATE_TRUNC function returns a date with the time portion of the day truncated to the unit specified by the format model <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b146781315173">fmt</strong>.</p>
</div>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p132418210415"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b2502183411415">Input</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_screen36315416413"><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></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="n">to_char</span><span class="p">(</span><span class="n">trunc</span><span class="p">(</span><span class="n">add_months</span><span class="p">(</span><span class="n">sysdate</span><span class="p">,</span><span class="o">-</span><span class="mi">12</span><span class="p">),</span><span class="s1">'MM'</span><span class="p">),</span><span class="s1">'YYYYMMDD'</span><span class="p">)</span><span class="o">/</span><span class="mi">100</span><span class="p">)</span><span class="w"> </span><span class="k">into</span><span class="w"> </span><span class="n">v_start_date_s</span><span class="w"> </span><span class="k">from</span><span class="w"> </span><span class="n">dual</span><span class="p">;</span>
<span class="k">select</span><span class="w"> </span><span class="n">trunc</span><span class="p">(</span><span class="n">to_char</span><span class="p">(</span><span class="n">trunc</span><span class="p">(</span><span class="n">sysdate</span><span class="p">,</span><span class="s1">'mm'</span><span class="p">),</span><span class="s1">'YYYYMMDD'</span><span class="p">)</span><span class="o">/</span><span class="mi">100</span><span class="p">)</span><span class="w"> </span><span class="k">into</span><span class="w"> </span><span class="n">v_end_date_e</span><span class="w"> </span><span class="k">from</span><span class="w"> </span><span class="n">dual</span><span class="p">;</span>
<span class="n">ID_MNTH</span><span class="o">&gt;=</span><span class="n">TRUNC</span><span class="p">(</span><span class="n">TO_CHAR</span><span class="p">(</span><span class="n">ADD_MONTHS</span><span class="p">(</span><span class="n">to_date</span><span class="p">(</span><span class="n">to_char</span><span class="p">(</span><span class="s1">'||v_curr_date||'</span><span class="p">),</span><span class="s1">''</span><span class="n">YYYYMMDD</span><span class="s1">''</span><span class="p">),</span><span class="o">-</span><span class="mi">12</span><span class="p">),</span><span class="s1">''</span><span class="n">YYYYMMDD</span><span class="s1">''</span><span class="p">)</span><span class="o">/</span><span class="mi">100</span><span class="p">))</span>
<span class="k">AND</span><span class="w"> </span><span class="n">ID_MNTH</span><span class="o">&gt;=</span><span class="n">TRUNC</span><span class="p">(</span><span class="n">TO_CHAR</span><span class="p">(</span><span class="n">ADD_MONTHS</span><span class="p">(</span><span class="n">to_date</span><span class="p">(</span><span class="n">to_char</span><span class="p">(</span><span class="s1">'||v_curr_date||'</span><span class="p">),</span><span class="s1">''</span><span class="n">YYYYMMDD</span><span class="s1">''</span><span class="p">),</span><span class="o">-</span><span class="mi">12</span><span class="p">),</span><span class="s1">''</span><span class="n">YYYYMMDD</span><span class="s1">''</span><span class="p">)</span><span class="o">/</span><span class="mi">100</span><span class="p">))</span>
<span class="k">select</span><span class="w"> </span><span class="n">TRUNC</span><span class="p">(</span><span class="n">to_char</span><span class="p">(</span><span class="n">add_months</span><span class="p">(</span><span class="n">trunc</span><span class="p">(</span><span class="n">TO_DATE</span><span class="p">(</span><span class="n">TO_CHAR</span><span class="p">(</span><span class="n">P_DATE</span><span class="p">),</span><span class="s1">'YYYYMMDD'</span><span class="p">),</span><span class="s1">'MM'</span><span class="p">)</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span><span class="o">-</span><span class="mi">2</span><span class="p">),</span><span class="s1">'YYYYMMDD'</span><span class="p">)</span><span class="o">/</span><span class="mi">100</span><span class="p">)</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">START_MONTH</span><span class="w"> </span><span class="k">from</span><span class="w"> </span><span class="n">dual</span><span class="p">;</span><span class="w"> </span>
<span class="k">select</span><span class="w"> </span><span class="n">TRUNC</span><span class="p">(</span><span class="n">TO_CHAR</span><span class="p">(</span><span class="n">trunc</span><span class="p">(</span><span class="n">TO_DATE</span><span class="p">(</span><span class="n">TO_CHAR</span><span class="p">(</span><span class="n">P_DATE</span><span class="p">),</span><span class="s1">'YYYYMMDD'</span><span class="p">),</span><span class="s1">'MM'</span><span class="p">)</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span><span class="s1">'YYYYMMDD'</span><span class="p">)</span><span class="o">/</span><span class="mi">100</span><span class="p">)</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">END_MONTH</span><span class="w"> </span><span class="k">from</span><span class="w"> </span><span class="n">dual</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p2052635417416"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b988981584218">Output</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_screen478213205428"><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">Trunc</span><span class="p">(</span><span class="n">To_char</span><span class="p">(</span><span class="n">Date_trunc</span><span class="w"> </span><span class="p">(</span><span class="s1">'MONTH'</span><span class="p">,</span><span class="w"> </span><span class="n">mig_ora_ext</span><span class="p">.</span><span class="n">Add_months</span><span class="w"> </span><span class="p">(</span><span class="n">SYSDATE</span><span class="p">,</span><span class="w"> </span><span class="o">-</span><span class="mi">12</span><span class="p">))</span><span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="s1">'YYYYMMDD'</span><span class="p">)</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mi">100</span><span class="p">)</span><span class="w"> </span>
<span class="k">INTO</span><span class="w"> </span><span class="n">v_start_date_s</span><span class="w"> </span>
<span class="k">FROM</span><span class="w"> </span><span class="n">dual</span><span class="p">;</span><span class="w"> </span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">Trunc</span><span class="p">(</span><span class="n">To_char</span><span class="p">(</span><span class="n">Date_trunc</span><span class="w"> </span><span class="p">(</span><span class="s1">'MONTH'</span><span class="p">,</span><span class="w"> </span><span class="n">SYSDATE</span><span class="p">),</span><span class="w"> </span><span class="s1">'YYYYMMDD'</span><span class="p">)</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mi">100</span><span class="p">)</span><span class="w"> </span>
<span class="k">INTO</span><span class="w"> </span><span class="n">v_end_date_e</span><span class="w"> </span>
<span class="k">FROM</span><span class="w"> </span><span class="n">dual</span><span class="p">;</span><span class="w"> </span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">Trunc</span><span class="p">(</span><span class="n">To_char</span><span class="p">(</span><span class="n">mig_ora_ext</span><span class="p">.</span><span class="n">Add_months</span><span class="w"> </span><span class="p">(</span><span class="n">Date_trunc</span><span class="w"> </span><span class="p">(</span><span class="s1">'MONTH'</span><span class="p">,</span><span class="w"> </span><span class="n">To_date</span><span class="p">(</span><span class="n">To_char</span><span class="p">(</span><span class="n">p_date</span><span class="p">),</span><span class="w"> </span><span class="s1">'YYYYMMDD'</span><span class="w"> </span><span class="p">))</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="o">-</span><span class="mi">2</span><span class="p">),</span><span class="w"> </span><span class="s1">'YYYYMMDD'</span><span class="p">)</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mi">100</span><span class="p">)</span><span class="w"> </span>
<span class="k">INTO</span><span class="w"> </span><span class="n">start_month</span><span class="w"> </span>
<span class="k">FROM</span><span class="w"> </span><span class="n">dual</span><span class="p">;</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">Trunc</span><span class="p">(</span><span class="n">To_char</span><span class="p">(</span><span class="n">Date_trunc</span><span class="w"> </span><span class="p">(</span><span class="s1">'MONTH'</span><span class="p">,</span><span class="w"> </span><span class="n">To_date</span><span class="p">(</span><span class="n">To_char</span><span class="p">(</span><span class="n">p_date</span><span class="p">),</span><span class="w"> </span><span class="s1">'YYYYMMDD'</span><span class="p">))</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="s1">'YYYYMMDD'</span><span class="p">)</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mi">100</span><span class="p">)</span><span class="w"> </span>
<span class="k">INTO</span><span class="w"> </span><span class="n">end_month</span><span class="w"> </span>
<span class="k">FROM</span><span class="w"> </span><span class="n">dual</span><span class="p">;</span><span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section79301937142811"><a name="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section79301937142811"></a><a name="en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section79301937142811"></a><h4 class="sectiontitle">LAST_DAY</h4><p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p8258134215551">The Oracle LAST_DAY function returns the last day of the month based on a date value.</p>
<pre class="screen" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_screen151583744516">LAST_DAY(date)</pre>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p5829155618423">The return type is always DATE, regardless of the data type of the date.</p>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p729632194917"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_b1638193212619">LAST_DAY</strong> is an Oracle system function and is not implicitly supported by <span id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_text57181140193011">GaussDB(DWS)</span>. To support this function, DSC creates a LAST_DAY function in the <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b1011563011327">MIG_ORA_EXT</strong> schema. The migrated statements will use the new function MIG_ORA_EXT.LAST_DAY as shown in the following example.</p>
<div class="note" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_note17260124255512"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p81191926171620">Before using this function, perform the following operations:</p>
<ol id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_ol532145531614"><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li1832155541620">Create and use the <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_b1174755289">MIG_ORA_EXT</strong> schema.</li><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li341175810168">Copy the content of the custom script and execute the script in all target databases for which migration is to be performed. For details, see <a href="dws_16_0017.html#EN-US_TOPIC_0000001819336065">Migration Process</a>.</li></ol>
</div></div>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p747716220115"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b188331528191412">Input</strong> - <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b7923133114146">LAST_DAY</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_screen104781221010"><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="w"> </span><span class="k">SELECT</span>
<span class="w"> </span><span class="n">to_date</span><span class="p">(</span><span class="w"> </span><span class="s1">'01/'</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="s1">'07/'</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="n">to_char</span><span class="p">(</span><span class="w"> </span><span class="n">sysdate</span><span class="w"> </span><span class="p">,</span><span class="s1">'YYYY'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="s1">'dd/mm/yyyy'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="k">FIRST</span>
<span class="w"> </span><span class="p">,</span><span class="n">last_day</span><span class="p">(</span><span class="w"> </span><span class="n">to_date</span><span class="p">(</span><span class="w"> </span><span class="s1">'01/'</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="s1">'07/'</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="n">to_char</span><span class="p">(</span><span class="w"> </span><span class="n">sysdate</span><span class="w"> </span><span class="p">,</span><span class="s1">'YYYY'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="s1">'dd/mm/yyyy'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="n">last__day</span>
<span class="w"> </span><span class="k">FROM</span>
<span class="w"> </span><span class="n">dual</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p1348110222119"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b811263515142">Output</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_screen112681542185519"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span>
<span class="w"> </span><span class="n">to_date</span><span class="p">(</span><span class="w"> </span><span class="s1">'01/'</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="s1">'07/'</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="n">to_char</span><span class="p">(</span><span class="w"> </span><span class="n">sysdate</span><span class="w"> </span><span class="p">,</span><span class="s1">'YYYY'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="s1">'dd/mm/yyyy'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="k">FIRST</span>
<span class="w"> </span><span class="p">,</span><span class="n">MIG_ORA_EXT</span><span class="p">.</span><span class="n">LAST_DAY</span><span class="w"> </span><span class="p">(</span>
<span class="w"> </span><span class="n">to_date</span><span class="p">(</span><span class="w"> </span><span class="s1">'01/'</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="s1">'07/'</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="n">to_char</span><span class="p">(</span><span class="w"> </span><span class="n">sysdate</span><span class="w"> </span><span class="p">,</span><span class="s1">'YYYY'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="s1">'dd/mm/yyyy'</span><span class="w"> </span><span class="p">)</span>
<span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="n">last__day</span>
<span class="w"> </span><span class="k">FROM</span>
<span class="w"> </span><span class="n">dual</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section47599521288"><a name="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section47599521288"></a><a name="en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section47599521288"></a><h4 class="sectiontitle">MONTHS_BETWEEN</h4><p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p12338624112317">The MONTHS_BETWEEN function returns the number of months between two dates.</p>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p196231997565"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_b378215465614">MONTHS_BETWEEN</strong> is an Oracle system function and is not implicitly supported by <span id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_text1417924113112">GaussDB(DWS)</span>. To support this function, use DSC to create a MONTHS_BETWEEN function in the <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b1467815282154">MIG_ORA_EXT</strong> schema. The migrated statements will use the new function MIG_ORA_EXT.MONTHS_BETWEEN as shown in the following example.</p>
<div class="note" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_note2930203091812"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p97971044191818">Before using this function, perform the following operations:</p>
<ol id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_ol1730310611441"><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li20302126134417">Create and use the <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b3359838151719">MIG_ORA_EXT</strong> schema.</li><li id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_li130211615441">Copy the contents of the custom script and execute the script in all target databases for which migration is to be performed. For details, see <a href="dws_16_0017.html#EN-US_TOPIC_0000001819336065">Migration Process</a>.</li></ol>
</div></div>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p762459165615"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b147512331815">Input</strong> - <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b1298856191815">MONTHS_BETWEEN</strong></p>
<pre class="screen" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_screen1625129195619">Select Months_Between(to_date('2017-06-20', 'YYYY-MM-DD'), to_date('2011-06-20', 'YYYY-MM-DD')) from dual;</pre>
<p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p176275915614"><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b083611061816">Output</strong></p>
<pre class="screen" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_screen66286935611">Select MIG_ORA_EXT.MONTHS_BETWEEN(to_date('2017-06-20', 'YYYY-MM-DD'), to_date('2011-06-20', 'YYYY-MM-DD')) from dual;</pre>
</div>
<div class="section" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section12301686294"><a name="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section12301686294"></a><a name="en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_section12301686294"></a><h4 class="sectiontitle">SYSTIMESTAMP</h4><p id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_p60282704163850">The SYSTIMESTAMP function returns the system date, including fractional seconds and time zones, of the system on which the database resides. The return type is <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b105775813197">TIMESTAMP WITH TIME ZONE</strong>.</p>
<div class="fignone" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_fig146524535911"><span class="figcap"><b>Figure 1 </b><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b117513130194">Input</strong> - <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b1861216201917">SYSTIMESTAMP</strong></span><br><span><img id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_image413581431181" src="figure/en-us_image_0000001658025146.png"></span></div>
<div class="fignone" id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_fig965513518594"><span class="figcap"><b>Figure 2 </b><strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b109661221111911">Output</strong> - <strong id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0237712283_b195081724161917">SYSTIMESTAMP</strong></span><br><span><img id="EN-US_TOPIC_0000001819336293__en-us_topic_0000001657865290_en-us_topic_0238518396_en-us_topic_0237362331_en-us_topic_0202727110_image5189517811811" src="figure/en-us_image_0000001657865822.png"></span></div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_mt_0133.html">System Functions</a></div>
</div>
</div>
View Git Blame Copy Permalink