Locales; Setting The Locale; Using The Locale - MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX Develop Manual

Similar issues can arise if you convert between other character encodings; for example, if you read
files encoded in the Japanese Windows default encoding and display them using Shift-JIS. To
prevent these problems, ensure that the display encoding is the same as the input encoding.

Locales

A locale identifies the exact language and cultural settings to use for a user. The locale controls
how to format the following:
•
Dates
•
Times
•
Numbers
•
Currency amounts
In ColdFusion MX, a locale is identified by the following elements:
Element
Language
Regional
variation
For a list of the languages and regional variations ColdFusion supports, see the
function in CFML Reference.

Setting the locale

ColdFusion determines the locale value as follows:
•
By default, ColdFusion uses the JVM locale, and the default JVM locale is the operating
system locale. You can set the JVM locale value explicitly in ColdFusion MX in the
ColdFusion MX Administrator Java and JVM Settings page JVM Arguments field; for
example:
-Duser.language=de -Duser.region=DE.
•
A locale set using the
another
SetLocale
•
If a request has multiple
sensitive ColdFusion tags and functions (such as the functions that start with LS) format data.
The last
SetLocale
requestor (typically the client browser) determines the value of the response
HTTP header. The browser that requested the page displays the response according
Language
to the rules for the language specified by the
•
ColdFusion ignores any

Using the locale

The
SetLocale
time, number, and currency values. ColdFusion MX supports 26 locales. For the complete list, see
CFML Reference. You use the
ColdFusion MX. If you have not made a call to
JVM.
376 Chapter 17: Developing Globalized Applications
Description
The basic locale identifier, such as English.
A country code; for example, the (US) in English (US).
function persists for the current request or until it is reset by
SetLocale
function in the request.
SetLocale
function that ColdFusion processes before sending a response to the
SetLocale
function determines the default formats that ColdFusion uses to output date,
GetLocale
functions, the current locale setting affects how locale-
Content-Language
functions that follow a
function to determine the current locale setting of
,
SetLocale GetLocale
SetLocale
Content-
header.
tag.
cfflush
returns the locale of the