<?xml version="1.0" encoding="utf-8"?> 
<?xml-stylesheet type="text/xsl" href="topic_template.xsl"?> 
<topic>
<category>fbudf</category>
<ref_entry>ADDHOUR()</ref_entry>
<creator date="2003/10/31 11:09:20">山田健一</creator>
<modified />
<definition>日時形式に指定時間を追加する</definition>
<structure>
<function>
<name>ADDHOUR</name>
<args>
<a><var>time</var></a>
<a><var>add</var></a>
</args>
</function>
</structure>
<arguments>
<argument>
<name><var>time</var></name><description>timestamp型の列または式</description>
</argument>
<argument>
<name><var>add</var></name><description>数値データ型の列または式</description>
</argument>
</arguments>
<declaration>declare external function addHour
timestamp, int
returns timestamp
entry_point 'addHour' module_name 'fbudf';
</declaration>
<description><var>time</var>の<var>add</var>時間後を返します。<br />
<var>add</var>はマイナスも可能です。</description>
<examples>
<example>
<!--SEQ = 1-->
<description>現在時刻の1時間後を求めます。</description>
<samplecode>SELECT ADDHOUR(GETEXACTTIMESTAMP(),1) FROM RDB$DATABASE;</samplecode>
<result>2003-10-31 12:04:23.9050</result>
</example>
<example>
<!--SEQ = 2-->
<description><var>add</var>に小数を指定すると整数に丸められてから加算されます。</description>
<samplecode>SELECT ADDHOUR(GETEXACTTIMESTAMP(),1.4),ADDHOUR(GETEXACTTIMESTAMP(),1.5) FROM RDB$DATABASE;
</samplecode>
<result>2003-10-31 12:04:23.9250  2003-10-31 13:04:23.9250</result>
</example>
<example>
<!--SEQ = 3-->
<description>現在時刻の1時間前を求めます。</description>
<samplecode>SELECT ADDHOUR(GETEXACTTIMESTAMP(),-1) FROM RDB$DATABASE;</samplecode>
<result>2003-10-31 10:04:23.9250</result>
</example>
</examples>
<see_also>
<keyword name="udf_addmillisecond">ADDMILLISECOND()</keyword>
<keyword name="udf_addminute">ADDMINUTE()</keyword>
<keyword name="udf_addsecond">ADDSECOND()</keyword>
</see_also>
</topic>
