LSParseDateTime

A locale-specific version of the ParseDateTime function, except that there is no option for POP date/time object parsing. Returns a date/time object.

Syntax

LSParseDateTime(date-time-string)

date-time-string

String being converted to date/time object. This string must be in a form that is readable in the current locale setting. By default the locale is set to English (US).

Usage

When passing a date/time value for the English (US) locale, the date-time string can be in any of the following FORMs:


Date-Time Formats for the English (US) Locale
Date-Time Composition	Example
dd mmmm yyyy	"25 January 1999"
hh:mm:ss	"8:30:00"
hh:mm:ss	"20:30:00"
mmmm dd, yyyy hh:mm:ss	"January 25, 1999 8:30:00"
hh:mm:ss mmm. dd, yyyy	"8:30:00 Jan. 25, 1999"
m/dd/yyyy hh:mm:ss	"1/25/1999 8:30:00"

Note that if you specify a year in the date, you should specify the full year.

If the date is formatted for a locale other than the English (US) locale, 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 shows LSParseDateTime --->
<HTML>
<HEAD>
<TITLE>LSParseDateTime Example</TITLE>
</HEAD>

<BODY>
<H3>LSParseDateTime Example</H3>

<P>LSParseDateTime returns a locale-specific date/time
object.

<!--- loop through a list of possible 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>
<Hr noshade>
    </CFOUTPUT>
</CFLOOP>
</BODY>
</HTML>