Description

Creates a time variable.

Returns

A time variable.

Category

Date and time functions

Function syntax

CreateTime(hour, minute, second)

See also

CreateODBCTimeCreateDateTimeEvaluation and type conversion issues in Data type conversion in the Developing ColdFusion Applications

Parameters

Parameter

Description

hour

Number in the range 0-23

minute

Number in the range 0-59

second

Number in the range 0-59

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> 
<li>Formatted with timeFormat and hh:mm:ss: #TimeFormat(yourTime, 'hh:mm:ss')#</li> 
</ul></cfoutput> 
</cfif> 
<CFFORM action="createtime.cfm" METHOD="post"> 
<PRE> 
Hour&nbsp;&nbsp;&nbsp;<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" 
MESSAGE="You must enter a value for seconds (0-59)" VALIDATE="integer" 
REQUIRED="Yes"> 
</PRE> 
<p><INPUT TYPE="Submit" NAME=""> <INPUT TYPE="RESET"></p> 
</cfform>

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy