CreateDateTime

Description

Returns a valid date/time object.

Syntax


CreateDateTime(year, month, day, hour, minute, second)

Parameters

Parameter

Description

year
Number in the range 100-9999

month
Number in the range 1 (January)-12 (December)

day
Number in the range 1-31

hour
Number in the range 0-23

minute
Number in the range 0-59

second
Number in the range 0-59

Parameter	Description
year	Number in the range 100-9999
month	Number in the range 1 (January)-12 (December)
day	Number in the range 1-31
hour	Number in the range 0-23
minute	Number in the range 0-59
second	Number in the range 0-59

Usage

Year values 0 - 29 are interpreted as 21^st century dates. Year values 30 - 99 are interpreted as 20^th century dates.

Example

<!--- This example shows how to use CreateDateTime --->

<html>

<head>

<title>

CreateDateTime Example

</title>

</head>



<body bgcolor = silver>

<H3>CreateDateTime Example</H3>



<cfif IsDefined("form.year")>

Your date value, presented using different CF date functions:

<cfset yourDate = CreateDateTime(form.year, form.month, form.day, 

  form.hour, form.minute, form.second)>

<cfoutput>

<UL>

  <LI>Built with CreateDate:

   #CreateDate(form.year, form.month,form.day)#

  <LI>Built with CreateDateTime:

    #CreateDateTime(form.year, form.month, form.day, form.hour,

      form.minute,form.second)# 

  <LI>Built with CreateODBCDate: #CreateODBCDate(yourDate)#

  <LI>Built with CreateODBCDateTime: #CreateODBCDateTime(yourDate)#

</UL>



<P>The same value can be formatted with dateFormat:

<UL>

  <LI>Built with CreateDate:

    #DateFormat(CreateDate

    (form.year,form.month,form.day), "mmm-dd-yyyy")#

  <LI>Built with CreateDateTime:

    #DateFormat(CreateDateTime

    (form.year, form.month, form.day, form.hour,

    form.minute, form.second))#

  <LI>Built with CreateODBCDate:

    #DateFormat(CreateODBCDate(yourDate), "mmmm d, yyyy")#

  <LI>Built with CreateODBCDateTime:

    #DateFormat(CreateODBCDateTime(yourDate), "d/m/yy")#

</UL>

</cfoutput>

</cfif>



<cfform action = "createdatetime.cfm" method = "POST">

<P>Please enter the year, month and day in integer format for 

the date value you would like 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>

</body>

</html>