476
CFML Language Reference
ParseDateTime
Returns a date/time object from a string.
See also
LSParseDateTime
,
IsDate
and
IsNumericDate
.
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
st
century values. Years 30 to 99 are interpreted
as 20
th
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
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.
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)>
Summary of Contents for COLDFUSION 4.5-CFML LANGUAGE
Page 1: ...Allaire Corporation CFML Language Reference ColdFusion 4 5...
Page 207: ...Chapter 1 ColdFusion Tags 183 CFCATCH CFTRY BODY HTML...
Page 224: ...200 CFMLLanguageReference CFOUTPUT P Text within CFOUTPUT is always shown CFOUTPUT BODY HTML...
Page 336: ...312 CFMLLanguageReference CFIF BODY HTML...
Page 404: ...380 CFMLLanguageReference DE It is morning CFOUTPUT P BODY HTML...
Page 413: ...Chapter 2 ColdFusion Functions 389 Customer BalanceDue BR CFOUTPUT CFIF BODY HTML...
Page 483: ...Chapter 2 ColdFusion Functions 459 CFOUTPUT CFLOOP BODY HTML...
Page 584: ...560 CFMLLanguageReference...
Page 594: ...570 CFMLLanguageReference...