User Guide

Chapter 2: ColdFusion Functions 313
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>
...