LSParseDateTime

Description

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.

International functions

Syntax

LSParseDateTime(date/time-string)

Parameters

Parameter

Description

date/time-string
String to convert to date/time object. The string must be in a form that is readable in the current locale setting. By default, the locale is set to English (US).

Parameter	Description
date/time-string	String to convert to date/time object. The 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 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"

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"

If you specify a year in the date, specify the full year.

If the date is formatted for a locale other than the English (US) locale, add or subtract the conversion time.

Year values 0 - 29 are interpreted as 21^st century dates. Year values 30 - 99 are interpreted as 20^th century dates.

Note

LSParseDateTime does not accept POP dates, nor does it convert dates to Greenwich Mean Time.

Example

<!--- 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 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>