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

CreateTimeSpan

期間を定義する日付/時刻オブジェクトを作成します。このオブジェクトは、他の日付/時間オブジェクトへの加算または減算が可能で、また、cfquery の cachedWithin 属性とともに使用できます。

日付/時刻オブジェクト

日付および時刻関数

CreateTimeSpan(days, hours, minutes, seconds)

CreateDateTime、DateAdd、DateConvert

パラメータ

説明

days

期間の日数を示す 0 ～ 32768 の範囲の整数です。

hours

期間の時数を示す数値です。

minutes

期間の分数を示す数値です。

seconds

期間の秒数を示す数値です。

特殊な日付/時刻オブジェクトを作成します。このオブジェクトは、他の日付/時刻オブジェクトに対して加算または減算を行う場合や、cfquery の cachedWithin 属性とともに使用する場合にのみ使用できます。

cfquery の cachedWithin 属性を使用する場合、元のクエリの日付がユーザーが定義した期間内であれば、キャッシュされたクエリデータが使用されます。この場合、CreateTimeSpan 関数は現在からさかのぼって期間を定義するために使用します。cachedWithin 属性は、ColdFusion Administrator のクエリのキャッシュ機能が有効な場合にのみ使用できます。 詳細については、cfqueryを参照してください。

<!--- この例は、cfquery と共に CreateTimeSpan を使用する方法を示しています。 --->
<h3>CreateTimeSpan の例</h3>
<!--- 'next N' 方式のブラウズを容易にするために、開始行と最大行を定義します。 --->
<CFPARAM name = "MaxRows" default = "10">
<CFPARAM name = "StartRow" default = "1">
<!--- キャッシュされたデータベース情報が過去 6 時間更新されていない場合、データベースを照会 -------->
<cfoutput>
<cfquery name = "GetParks" datasource = "cfsnippets"
   cachedWithin = "#CreateTimeSpan(0, 6, 0, 0)#">
SELECT PARKNAME, REGION, STATE
FROM Parks
ORDER by ParkName, State
</cfquery>
</cfoutput>
<!--- クエリを表示するための HTML テーブルを作成 --->
<TABLE cellpadding = 1 cellspacing = 1>
<TR>
   <TD colspan = 2 bgcolor = f0f0f0>
   <B><I>公園名</I></B>
   </TD>
   <TD bgcolor = f0f0f0>
   <B><i>地域</I></B>
   </TD>
   <TD bgcolor = f0f0f0>
   <B><I>州</I></B>
   </TD>
</TR>
<!--- クエリを出力し、startrow と maxrows を定義。クエリ変数 CurrentCount を使用
して表示している行を追跡 --->
<cfoutput query = "GetParks" StartRow = "#StartRow#"
MAXROWS = "#MaxRows#">
<TR>
   <TD valign = top bgcolor = ffffed>
   <B>#GetParks.CurrentRow#</B>
   </TD>
   <TD valign = top>
   <FONT SIZE = "-1">#ParkName#</FONT>
   </TD>
   <TD valign = top>
   <FONT SIZE = "-1">#Region#</FONT>
   </TD>
   <TD valign = top>
   <FONT SIZE = "-1">#State#</FONT>
   </TD>
</TR>
</cfoutput>
<!--- レコード数が行数以下である場合、startrow 値を maxrows で増やすことにより、
同じページへのリンクを提供 (この例では 10 増やしています) --->
<TR>
   <TD colspan = 4>
   <cfif (StartRow + MaxRows) LTE GetParks.recordCount>
      <a href = "cfquery.cfm?startrow = <cfoutput>
      #Evaluate(StartRow + MaxRows)#</cfoutput>">
      See next <cfoutput>#MaxRows#</cfoutput> rows</A>
   </cfif>
   </TD>
</TR>
</TABLE>
目 次 > CFML リファレンス > ColdFusion 関数 > CreateTimeSpan O