Creates a date-time object.
A date/time value.
CreateDateTime(year
,month
,day
,hour
,minute
,second
)
CreateDate, CreateTime, CreateODBCDateTime, Now; "Date-time functions and queries when ODBC is not supported" in the ColdFusion Developer's Guide
Parameter |
Description |
---|---|
year |
Integer in the range 0-9999. Integers in the range 0-29 are converted to 2000-2029. Integers in the range 30-99 are converted to 1930-1999. You cannot specify dates before AD 100. |
month |
Integer in the range 1 (January)-12 (December) |
day |
Integer in the range 1-31 |
hour |
Integer in the range 0-23 |
minute |
Integer in the range 0-59 |
second |
Integer in the range 0-59 |
<h3>CreateDateTime Example</h3> <cfif IsDefined("form.year")> Your date value, generated with CreateDateTime: <cfset yourDate = CreateDateTime(form.year, form.month, form.day, form.hour, form.minute, form.second)> <cfoutput> <ul> <li>Formatted with CreateDate: #CreateDate(form.year, form.month, form.day)#</li> <li>Formatted with CreateDateTime: #CreateDateTime(form.year, form.month, form.day, form.hour, form.minute, form.second)#</li> <li>Formatted with CreateODBCDate: #CreateODBCDate(yourDate)#</li> <li>Formatted with CreateODBCDateTime: #CreateODBCDateTime(yourDate)#</li> </ul> <p>The same value can be formatted with DateFormat: <ul> <li>Formatted with CreateDate and DateFormat: #DateFormat(CreateDate(form.year, form.month, form.day), "mmm-dd-yyyy")#</li> <li>Formatted with CreateDateTime and DateFormat: #DateFormat(CreateDateTime(form.year, form.month, form.day, form.hour, form.minute, form.second))#</li> <li>Formatted with CreateODBCDate and DateFormat: #DateFormat(CreateODBCDate(yourDate), "mmmm d, yyyy")#</li> <li>Formatted with CreateODBCDateTime and DateFormat: #DateFormat(CreateODBCDateTime(yourDate), "d/m/yy")#</li> </ul> </cfoutput> </cfif> <CFFORM ACTION="createdatetime.cfm" METHOD="POST"> <p>Please enter the year, month, and day, in integer format, for a date to view: <PRE> Year <CFINPUT TYPE="Text" NAME="year" VALUE="1998" VALIDATE="integer" REQUIRED="Yes"> Month <CFINPUT TYPE="Text" NAME="month" VALUE="6" RANGE="1,12" MESSAGE="Please enter a month (1-12)" VALIDATE="integer" REQUIRED="Yes"> Day <CFINPUT TYPE="Text" NAME="day" VALUE="8" RANGE="1,31" MESSAGE="Please enter a day of the month (1-31)" VALIDATE="integer" REQUIRED="Yes"> 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" MESSAGE="You must enter a value for seconds (0-59)" VALIDATE="integer" REQUIRED="Yes"> </PRE> <p><INPUT TYPE="Submit" NAME=""> <INPUT TYPE="RESET"> </cfform>