476
ParseDateTime
Returns a date/time object from a string.
See also LSParseDateTime,
Syntax
ParseDateTime( date-time-string [, pop-conversion ] )
date-time-string
String being converted to date/time object.
pop-conversion
POP or STANDARD. If you specify POP, the function takes the date/time string
passed from a POP mail server and converts it to GMT (Greenwich Mean Time) for
the English (US) locale. If you specify STANDARD or nothing, the function
provides no conversion. See the Note for more information about parsing date-
time strings that are not from the English (US) locale.
Usage
ParseDateTime is similar to CreateDateTime except that it takes a string instead of
specifically enumerated date/time values.
Both ParseDateTime and CreateDateTime are provided primarily to increase the
readability of code in compound expressions.
Years from 0 to 29 are interpreted as 21
th
as 20
century values.
When passing a date/time value as a string, make sure it is enclosed in quotes.
Otherwise, it is interpreted as a number representation of a date/time object, returning
undesired results.
Note
Examples
<!--- This example shows the use of ParseDateTime--->
<HTML>
<HEAD>
<TITLE>
ParseDateTime Example
</TITLE>
</HEAD>
<BODY BGCOLOR=silver>
<H3>ParseDateTime Example</H3>
<CFIF IsDefined("FORM.theTestValue")>
<CFIF IsDate(FORM.theTestValue)>
IsDate
If the date is formatted for a locale other than the English (US) locale, you
need to use the LSParseDateTime() function, then add or subtract the
conversion time, depending on the locale. LSParseDateTime does not
accept POP dates, nor does it have the capacity to convert dates to
Greenwich Mean Time.
and IsNumericDate.
st
century values. Years 30 to 99 are interpreted
CFML Language Reference
Need help?
Do you have a question about the COLDFUSION 4.5-CFML LANGUAGE and is the answer not in the manual?
Questions and answers