Specifications

Localization 23
Note: The date pivot point for calculating the century in a two-digit year has changed from
ColdFusion 5, affecting the results from date functions. For more information, see “Date
pivot point for two-digit years” on page 26.
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 5 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.
• GetLocale() 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 Java
Virtual Machine (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”. The following code works with the
SUN JRE.
Function Description of change