<?xml version="1.0" encoding="utf-8"?> 
<?xml-stylesheet type="text/xsl" href="topic_template.xsl"?> 
<topic>
<category>fbudf</category>
<ref_entry>ADDWEEK()</ref_entry>
<creator date="2003/10/31 21:30:11">山田健一</creator>
<modified />
<definition>日時形式に指定週間追加する</definition>
<structure>
<function>
<name>ADDWEEK</name>
<args>
<a><var>date</var></a>
<a><var>add</var></a>
</args>
</function>
</structure>
<arguments>
<argument>
<name><var>date</var></name><description>date型、timestamp型の列または式</description>
</argument>
<argument>
<name><var>add</var></name><description>数値データ型の列または式</description>
</argument>
</arguments>
<declaration>declare external function addWeek
timestamp, int
returns timestamp
entry_point 'addWeek' module_name 'fbudf';</declaration>
<description><var>date</var>の<var>add</var>週間後を返します。<br />
<var>add</var>はマイナスも可能です。</description>
<examples>
<example>
<!--SEQ = 1-->
<description>1週間後を求めます。時刻部分は変化しません。</description>
<samplecode>SELECT ADDWEEK(GETEXACTTIMESTAMP(),1) FROM RDB$DATABASE;</samplecode>
<result>2003-11-07 21:25:57.2520</result>
</example>
<example>
<!--SEQ = 2-->
<description><var>add</var>に小数を指定すると整数に丸められてから加算されます。</description>
<samplecode>SELECT ADDWEEK(GETEXACTTIMESTAMP(),1.4),ADDWEEK(GETEXACTTIMESTAMP(),1.5) FROM RDB$DATABASE;</samplecode>
<result>2003-11-07 21:25:57.2520  2003-11-14 21:25:57.2520</result>
</example>
<example>
<!--SEQ = 3-->
<description>1週間前を求めます。時刻部分は変化しません。</description>
<samplecode>SELECT ADDWEEK(GETEXACTTIMESTAMP(),-1) FROM RDB$DATABASE;</samplecode>
<result>2003-10-24 21:25:57.2520</result>
</example>
</examples>
<see_also>
<keyword name="udf_addday">ADDDAY()</keyword>
<keyword name="udf_addmonth">ADDMONTH()</keyword>
<keyword name="udf_addyear">ADDYEAR()</keyword>
</see_also>
</topic>
