ColdFusion MX
目 次 > CFML リファレンス > ColdFusion 関数 > DateAdd O

DateAdd

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

日付/時刻オブジェクト

日付および時刻関数

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

DateConvert、DatePart、CreateTimeSpan

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

パラメータ

説明

datepart

文字列です。

  • yyyy : 年
  • q : 四半期
  • m : 月
  • y : 年間通算日
  • d : 日
  • w : 曜日
  • ww : 週
  • h : 時
  • n : 分
  • s : 秒
  • l:ミリ秒

number

date に加算する datepart の単位の数値です (将来の日付を得るには正の数値を指定し、過去の日付を得るには負の数値を指定します)。

date

西暦 100 ～ 9999 年の期間の日付/時刻オブジェクトです。

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="cfsnippets">
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="q">四半期</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>
目 次 > CFML リファレンス > ColdFusion 関数 > DateAdd O