ParseDateTime |
Description
Parses a date/time string according to the English (U.S.) locale conventions. (To format a date/time string for other locales, use the LSParseDateTime function.)
Returns
A date/time object
Category
Date and time functions, Display and formatting functions
Function syntax
    ParseDateTime(date/time-string [, pop-conversion ] )
See also
IsDate, IsNumericDate, SetLocale
Parameters
Parameter | Description
date/timestring | A string containing a date/time value formatted according to U.S. locale
| conventions. Can represent a date/time in the range 100 AD–9999 AD. Years
| 0-29 are interpreted as 2000-2029; years 30-99 are interpreted as 1990-
| 1999.
pop-conversion | pop: Specifies that the date/time string is in POP format, which includes the
| local time of the sender and a time-zone offset from UTC. ColdFusion applies
| the offset and returns a value with the UTC time.
| standard: (the default) function does no conversion.
Usage
This function is similar to CreateDateTime, but it takes a string instead of enumerated date/time values. These functions are provided primarily to increase the readability of code in compound expressions.
To calculate a difference between time zones, use the GetTimeZoneInfo function.
To set the default display format of date, time, number, and currency values, use the SetLocale function.
Note: | This function does not accept POP dates.
Example
    <h3>ParseDateTime Example</h3>
    <cfif IsDefined("form.theTestValue")>
       <cfif IsDate(form.theTestValue)>
           <h3>The expression <cfoutput>#DE(form.theTestValue)#</cfoutput> is a valid
    date</h3>
           <p>The parsed date/time is:
               <cfoutput>#ParseDateTime(form.theTestValue)#</cfoutput>
       <cfelse>
           <h3>The expression <cfoutput>#DE(form.theTestValue)#</cfoutput> is not a
    valid date</h3>
       </cfif>
    </cfif>

    <form action="#CGI.ScriptName#" method="POST">
    <p>Enter an expression, and discover if it can be evaluated to a date value.
    <input type="Text" name="TheTestValue" value="<CFOUTPUT>#DateFormat(Now())#
         #TimeFormat(Now())#</CFOUTPUT>">
    <input type="Submit" value="Parse the Date" name="">
    </form>

date/time string |
A string containing a date/time value formatted according to U.S. locale conventions. Can represent a date/time in the range 100 AD-9999 AD. Years 0-29 are interpreted as 2000-2029; years 30-99 are interpreted as 1990-1999.

pop-conversion |
pop: Specifies that the date/time string is in POP format, which includes the local time of the sender and a time-zone offset from UTC. ColdFusion applies the offset and returns a value with the UTC time. standard: (the default) function does no conversion.