16
Chapter 1: Migrating Applications from ColdFusion 5
For more information, see
CFML Reference
for the relevant function.
Other locale-specific changes
Following are other locale-specific issues that could cause an incompatibility in your
ColdFusion 5 applications:
•
For the Japanese version, sort functions such as
ListSort
and
ArraySort
return items in a
slightly different order in ColdFusion MX than they do in the Japanese version of
ColdFusion 5. This is because ColdFusion MX sorts characters by their Unicode char number,
and the Japanese version of ColdFusion 5 sorts characters by their shift_jis char number.
•
The format for how decimal numbers appear in a browser depends on the system locale of the
computer that is hosting ColdFusion MX, not on the locale of ColdFusion MX. For example,
if you run the English version of ColdFusion MX on a computer whose system locale is set to
German or French, the decimal point displays as a comma, not a period. ColdFusion 5
displays a period for the decimal point, regardless of the system locale.
•
The
GetLocale
function checks if the locale was explicitly set; for example, from
Setlocale
.
If not, ColdFusion MX gets the default locale for the operating system from the JVM. If the
operating system has no set locale, or if ColdFusion MX does not support the operating
system’s default locale,
GetLocale
returns
en_US
"English (US)". (ColdFusion MX sets the
locale in the JVM to en_US "English (US)"; this value persists until the server is restarted or
the value is reset with the
SetLocale
function. This setting does not affect anything but
ColdFusion MX.)
LSParseDateTime
In earlier versions, you could not pass in a time-zone value such, as “EST”.
Now you can, but ColdFusion MX processes this information as follows:
•
If the time zone specified in the date/time string parameter is different
from the time zone setting of the computer hosting ColdFusion MX,
ColdFusion MX changes the time value in the parameter to its
equivalent value in the computer’s time zone.
•
If the time zone is not specified in the date/time string parameter,
ColdFusion MX does not adjust the time value.
When developing an application, Macromedia recommends that you
evaluate the entered time string for a time zone setting and, if necessary,
change your application to adjust the value. You can use a
cfcatch
block
to do this; for more information, see
LSParseDateTime
and “CFCATCH
variables” in
CFML Reference
.
If you use the IBM JRE version 1.3.0 with ColdFusion MX,
LSParseDateTime("Quarta-feira, 23 de Janeiro de 2002 12h34min56s
PST")
fails when passing the month Janeiro.
Function
Description of change