User Guide

LSIsDate 757
LSIsDate
Description
Determines whether a string is a valid representation of a date/time value in the current locale.
Returns
True, if the string can be formatted as a date/time value in the current locale; False, otherwise.
Category
Date and time functions, Display and formatting functions, International functions
Function syntax
LSIsDate(string)
See also
CreateDateTime
, GetLocale, IsNumericDate, LSDateFormat, ParseDateTime, SetLocale;
“Handling data in ColdFusion MX” in Chapter 17, “Developing Globalized Applications,” in
ColdFusion MX Developer’s Guide
History
ColdFusion MX:
• Changed formatting behavior: this function might return a different result than in earlier
releases. This function uses Java standard locale formatting rules on all platforms.
• Changed behavior: this function accepts a dash or hyphen character only in the
Dutch(Standard) and Portuguese (Standard) locales. If called this way (for example,
LsIsDate("3-1-2002") in any other locale, this function returns False. (Earlier releases returned
Tr u e . )
• Changed behavior: when using the SUN JRE 1.3.1 on an English(UK) locale, this function
returns False for a date that has a one-digit month or day (for example, 1/1/01). To work
around this, insert a zero in a one-digit month or day (for example, 01/01/01).
Parameters
Usage
A date/time object is in the range 100 AD–9999 AD.
To set the default display format of date, time, number, and currency values, use the
SetLocale
function.
Example
<h3>LSIsDate Example</h3>
<cfif IsDefined("FORM.locale")>
<!--- if locale is defined, set locale to that entry --->
<cfset NewLocale = SetLocale(FORM.locale)>
Parameter Description
string A string or a variable that contains one