MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX, Reference

Page: 788 / 1108

788 Chapter 3: ColdFusion Functions
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
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.
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>
Parameter Description
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 1930-
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.