CFML Language Reference
Chapter 2 :  ColdFusion Functions

CreateTimeSpan

Creates a date/time object for adding and subtracting other date/time objects.

See also CreateDateTime, DateAdd, and DateConvert.

Syntax

CreateTimeSpan(days, hours, minutes, seconds)

days

Number representing the number of days.

hours

Number representing the number of hours.

minutes

Number representing the number of minutes.

seconds

Number representing the number of seconds.

Usage

The CreateTimeSpan function creates a special date/time object that should only be used to add and subtract from other date/time objects or with the CFQUERY CACHEDWITHIN attribute.

Examples

<!--- This example shows how to CreateTimeSpan --->
...
<CFIF IsDefined("FORM.year")>

<!--- set variables for the date and for the time span --->
<CFSET yourDate = CreateDateTime(FORM.year, FORM.month, FORM.day,
    FORM.hour, FORM.minute, FORM.second)>
<CFSET yourTimeSpan = CreateTimeSpan(FORM.tsday,
    FORM.tshour, FORM.tsminute, FORM.tssecond)>

<CFOUTPUT>
<P>Your original date value: #yourDate#
<P>The date of your timespan, formatted:

<!--- output the results of the form --->
<P>#yourTimeSpan# days <CFIF yourTimeSpan LTE 0>before
  your<CFELSE>after your</CFIF> original date:
<BR>#DateFormat(yourDate + yourTimeSpan)#
 #TimeFormat(yourDate + yourTimeSpan)#
</CFOUTPUT>
</CFIF>
...

Copyright © 1999, Allaire Corporation. All rights reserved.