<?xml version="1.0" encoding="utf-8"?> 
<?xml-stylesheet type="text/xsl" href="topic_template.xsl"?> 
<topic>
<category>fbudf</category>
<ref_entry>ADDSECOND()</ref_entry>
<creator date="2003/10/31 11:23:50">山田健一</creator>
<modified />
<definition>日時形式に指定秒数を追加する
</definition>
<structure>
<function>
<name>ADDSECOND</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 addSecond
timestamp, int
returns timestamp
entry_point 'addSecond' 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 ADDSECOND(GETEXACTTIMESTAMP(),1) FROM RDB$DATABASE;</samplecode>
<result>2003-10-31 11:21:36.2080</result>
</example>
<example>
<!--SEQ = 2-->
<description><var>add</var>に小数を指定すると整数に丸められてから加算されます。</description>
<samplecode>SELECT ADDSECOND(GETEXACTTIMESTAMP(),1.4),ADDSECOND(GETEXACTTIMESTAMP(),1.5) FROM RDB$DATABASE;</samplecode>
<result>2003-10-31 11:21:36.2080  2003-10-31 11:21:37.2080</result>
</example>
<example>
<!--SEQ = 3-->
<description>現在時刻の1秒前を求めます。</description>
<samplecode>SELECT ADDSECOND(GETEXACTTIMESTAMP(),-1) FROM RDB$DATABASE;</samplecode>
<result>2003-10-31 11:21:34.2080</result>
</example>
</examples>
<see_also>
<keyword name="udf_addhour">ADDHOUR()</keyword>
<keyword name="udf_addmillisecond">ADDMILLISECOND()</keyword>
<keyword name="udf_addminute">ADDMINUTE()</keyword>
</see_also>
</topic>
