DATEADD  
説明

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

 
戻り値

日付時刻オブジェクト

 
カテゴリ

日付および時刻関数

 
関数のシンタックス
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>
DATEPART  
文字列です。
  • yyyy: 年
  • q: 四半期
  • m: 月
  • y: 年間通算日
  • d: 日
  • w: 曜日
  • ww: 週
  • h: 時
  • n: 分
  • s: 秒
  • l: ミリ秒
NUMBER  
date に加算する datepart の単位の数値です (将来の日付を得るには正の数値を指定し、過去の日 付を得るには負の数値を指定します)。数値は整数でなければなりません。
DATE  
日付時刻オブジェクトです。値の範囲は西暦 100 〜 9999 年です。