時刻の単位を日付に追加します。

日付時刻オブジェクト

日付および時刻関数

DateAdd("datepart", number, "date")

DateConvert、DatePart、CreateTimeSpan

ColdFusion MX 6.1: ミリ秒を表す文字 L および l を datepart に追加しました。

datepart の値 y、d、および w を使用すると、日付に日数が加算されます。

日付時刻オブジェクトを文字列として渡すときは、そのオブジェクトを引用符で囲む必要があります。引用符で囲まない場合、そのオブジェクトは日付時刻オブジェクトの数値表示として解釈されます。

<!--- この例は、DateAdd の使用方法を示しています。 --->
<cfparam name="value" default="70">
<cfparam name="type" default="m">

<!--- 数値が渡された場合はそれを使う --->
<cfif IsDefined("form.value")>
   <cfset value = form.value>
</cfif>
<cfif IsDefined("form.type")>
   <cfset type = form.type>
</cfif>


<cfquery name="GetMessages" datasource="cfdocexamples">
SELECT    UserName, Subject, Posted
FROM      Messages
</cfquery>

<p>この例は、DateAdd を使用して、データベース内のメッセージが
いつ無効になるかを調べます。現時点では、
<cfoutput>#value#</cfoutput>

<cfswitch expression="#type#">
   <cfcase value="yyyy">年</cfcase>
   <cfcase value="q">四半期</cfcase>
   <cfcase value="m">か月</cfcase>
   <cfcase value="y">年間通算日</cfcase>   
   <cfcase value="w">曜日</cfcase>   
   <cfcase value="ww">週</cfcase>   
   <cfcase value="h">時</cfcase>   
   <cfcase value="n">分</cfcase>   
   <cfcase value="s">秒</cfcase>      
   <cfdefaultcase>年</cfdefaultcase>
</cfswitch>
 経過したメッセージが無効となります。

<table>
<tr>
   <td>ユーザー名</td>
   <td>題名</td>
   <td>送信済み</td>
</tr>
<cfoutput query="GetMessages">
<tr>
   <td>#UserName#</td>
   <td>#Subject#</td>
   <td>#Posted# <cfif DateAdd(type, value, posted) LT Now()><font color="red">期限切れ</
font></cfif></td>
</tr>
</cfoutput>
</table>

<cfform action="#CGI.Script_Name#" method="post">

有効期限を選択してください : 
<cfinput type="Text" name="value" value="#value#" message="整数のみを入力してください。" 
validate="integer" required="Yes">
<select name="type">
   <option value="yyyy">年
   <option value="m" selected>か月
   <option value="d">日
   <option value="ww">週間            
   <option value="h">時間
   <option value="n">分
   <option value="s">秒
</select>
   
<input type="Submit" value="送信">
</cfform>