lSParseDateTime

Description

Converts a string that is a valid date/time representation in the current locale into a date/time object.

History

ColdFusion 8: Added the locale parameter. ColdFusion MX: Changed formatting behavior: this function might not parse string formats that worked with earlier releases. This function uses Java standard locale formatting rules on all platforms. Changed how the date/time-string parameter value is processed: ColdFusion processes the date/time-string parameter value time zone information differently than in earlier releases, as described in the Usage section.

Syntax

LSParseDateTime(date/time-string [, locale])

Attributes

Attribute	Description	Required	Default
date/time-string	A string a variable that contains one, in a format that is readable in the current locale.
locale	Locale to use instead of the locale of the page when processing the function

Returns

A date/time object.

Usage

This function can parse any date, time, or date/time combination that conforms to Java standard locale formatting rules for the current locale.
The following table lists some of the date/time values you can pass to this function in the English (US) locale. You can also pass only the date or the time parts of these formats:
Format
Example
m/dd/yy h:mm:ss
1/30/02 7:02:33
m/dd/yy h:mm tt
1/30/02 7:02 AM
m/dd/yyyy h:mm
1/30/2002 7:02 AM
mmm dd, yyyy h:mm:ss tt
Jan 30, 2002 7:02:12 AM
mmmm dd, yyyy h:mm:ss tt zzz
January 30, 2002 7:02:23 AM PST
ddd, mmm dd, yyyy hh:mm:ss
Wed, Jan 30, 2002 07:02:12
dddd, mmmm dd, yyyy h:mm:ss tt zzz
Wednesday, January 30, 2002 7:02:12 AM PST

Valid dates are in the range 100 AD–9999 AD. Two-digit years in the range 00-29 are interpreted as being 2000-2029. Two-digit years in the range 30-99 are interpreted as being 1930-1999
This function corrects for differences between the current time zone and any time zone specified in the input parameter.
If a time zone specified in the date/time-string parameter is different from the time zone setting of the computer, ColdFusion adjusts the time value to its equivalent in the computer time zone.
If a time zone is not specified in the date/time-string parameter, ColdFusion does not adjust the time value.
Note: This function does not accept POP dates, which include a time zone offset value.

Example

<h3>LSParseDateTime Example - returns a locale-specific date/time object</h3> 
<!--- loop through a list of locales and show date values for Now()---> 
<cfloop LIST = "#Server.Coldfusion.SupportedLocales#" 
index = "locale" delimiters = ","> 
    <cfset oldlocale = SetLocale(locale)> 
    <cfoutput><B><I>#locale#</I></B><br> 
        Locale-specific formats: 
        <br>#LSDateFormat(Now(), "mmm-dd-yyyy")# #LSTimeFormat(Now())#<br> 
        #LSDateFormat(Now(), "mmmm d, yyyy")# #LSTimeFormat(Now())#<br> 
        #LSDateFormat(Now(), "mm/dd/yyyy")# #LSTimeFormat(Now())#<br> 
        #LSDateFormat(Now(), "d-mmm-yyyy")# #LSTimeFormat(Now())#<br> 
        #LSDateFormat(Now(), "ddd, mmmm dd, yyyy")# #LSTimeFormat(Now())#<br> 
        #LSDateFormat(Now(), "d/m/yy")# #LSTimeFormat(Now())#<br> 
        #LSDateFormat(Now())# #LSTimeFormat(Now())#<br> 
    Standard Date/Time: 
    #LSParseDateTime("#LSDateFormat(Now())# #LSTimeFormat(Now())#")#<br> 
    </cfoutput> 
</cfloop>

cfmldocs