LSParseDateTime

Description

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

Returns

A date/time object.

Category

Date and time functions, Display and formatting functions, International functions, String functions

Function syntax

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

See also

LSDateFormat, ParseDateTime, SetLocale, GetLocale; Locales in the Developing ColdFusion Applications

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.

Parameters

Parameter

Description

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

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><p><B><I>#locale#</I></B><br> 
        <p>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> 
    <p>Standard Date/Time: 
    #LSParseDateTime("#LSDateFormat(Now())# #LSTimeFormat(Now())#")#<br> 
    </cfoutput> 
</cfloop>