Specifications

22 Migrating ColdFusion 5 Applications
Changes to formatting functions for every locale
The following table outlines changes to formatting functions that apply to every locale:
Function Description of change
IsDateFormat()
When no mask is specified, ColdFusion MX returns the Java medium date format for
the locale. ColdFusion 5 returns one of two default masks, depending on the locale:
• For a locale where the date ends with the year, the default mask is dd-mmm-yy
• For a locale where the date begins with the year, the default mask is yyyy-mmm-dd
IsTimeFormat()
ColdFusion MX supports the following masks for IsTimeFormat():
• h:m:s lsTimeFormat(6:39,"h:m:s") returns 06:39:0
• hh:mm:ss lsTimeFormat(6:39,"hh:mm:ss") returns 06:39:00
• hh:mm:ss t lsTimeFormat(6:28:26,"hh:mm:ss t") returns 06:28:26 A
• hh:mm:ss tt lsTimeFormat(6:28:26,"hh:mm:ss tt") returns 06:28:26 AM
LSCurrencyFormat()
LSEuroCurrencyFormat()
ColdFusion 5 put “EUR” as the international currency for every locale, even if the
locale did not support the Euro. For example, LSEuroCurrencyFormat(123.45,
"international") returned "EUR123.45", even for an English(US) locale.
ColdFusion MX uses the Java standard locales. Therefore, ColdFusion MX processes
LSCurrencyFormat() and LSEuroCurrencyFormat() as follows:
• LSCurrencyFormat() returns the non-Euro currency format for all locales, even if
the locale is a member of the Euro countries. For example, for the
French(Standard) locale, LSCurrencyFormat() returns the French franc as the
currency symbol, instead of the Euro.
• LSEuroCurrencyFormat() only returns the Euro currency format if the set locale
is a Euro member country. Otherwise, it returns the set locale’s currency format or
symbol. For example, LSEuroCurrencyFormat(-1234.56) returns
-1 234,56 € for the French(Standard) locale, but returns ($1,234.56) for the
English(US) locale.
LSDateFormat()
In ColdFusion 5, for the date parameter, you can only use a date/time object in the
range of 100 AD–9999 AD. ColdFusion MX does not have this limitation.
In ColdFusion MX, LSDateFormat() returns the appropriate date for the set locale.
For example, LSDateFormat(12/01/02) returns Jan-12-2002 if the locale is set to
English(UK), and Dec-01-2002 if the set locale is English(US).
In ColdFusion 5, LSDateFormat() throws an error or returns an incorrect format.
LSDateFormat()
LSTimeFormat()
If you pass an invalid mask into LSTimeFormat() or LSDateFormat(); for example,
"dd-mm-yymm", the function outputs the invalid characters in both ColdFusion 5 and
ColdFusion MX. However, ColdFusion 5 delimits each character of the output with an
apostrophe (') character.
LSIsCurrency()
When a Euro currency is passed into the LSIsCurrency function, ColdFusion MX
returns "yes" if the locale is a Euro member, and "no" if not.
LSIsDate()
In ColdFusion MX, you can pass in dates with the full date and full datetime
parameters. These formats include the name of the day (for example, Wednesday).