User Guide

540 Chapter 3: ColdFusion Functions
CreateTime
Description
Creates a time variable.
Returns
A time variable.
Category
Date and time functions
Function syntax
CreateTime(hour, minute, second)
See also
CreateODBCTime
, CreateDateTime; “Evaluation and type conversion issues” in Chapter 3,
“Using ColdFusion Variables,” in ColdFusion MX Developer’s Guide
Parameters
Usage
CreateTime
is a subset of CreateDateTime.
A time variable is a special case of a date-time variable. The date part of a time variable is set to
December 30, 1899.
Example
<h3>CreateTime Example</h3>
<cfif IsDefined("FORM.hour")>
Your time value, presented using CreateTime time function:
<cfset yourTime = CreateTime(FORM.hour, FORM.minute, FORM.second)>
<cfoutput><ul>
<li>Formatted with timeFormat: #TimeFormat(yourTime)#
<li>Formatted with timeFormat and hh:mm:ss: #TimeFormat(yourTime,
'hh:mm:ss')#
</ul></cfoutput>
</cfif>
<CFFORM action="createtime.cfm" METHOD="post">
<PRE>Hour<CFINPUT TYPE="Text" NAME="hour" VALUE="16" RANGE="0,23"
MESSAGE="You must enter an hour (0-23)" VALIDATE="integer" REQUIRED="Yes">
Minute <cfinput type="text" name="minute" value="12" range="0,59"
MESSAGE="You must enter a minute value (0-59)" VALIDATE="integer"
REQUIRED="Yes">
Second <cfinput type="text" name="second" value="0" range="0,59"
Parameter Description
hour Number in the range 0–23
minute Number in the range 0–59
second Number in the range 0–59