GetLocale

Returns the locale for the current request. Locales are determined by the native operating system.

A locale is an encapsulation of the set of attributes that govern the display and formatting of international date, time, number, and currency values.

See also SetLocale.

Syntax

GetLocale()

Locale support

ColdFusion can be expected to support the following locales with a default Windows NT installation.

Locales Supported by ColdFusion
Dutch (Belgian) French (Canadian) Norwegian (Bokmal)
Dutch (Standard) French (Standard) Norwegian (Nynorsk)
English (Australian) French (Swiss) Portuguese (Brazilian)
English (Canadian) German (Austrian) Portuguese (Standard)
English (New Zealand) German (Standard) Spanish (Mexican)
English (UK) German (Swiss) Spanish (Modern)
English (US) Italian (Standard) Spanish (Standard)
French (Belgian) Italian (Swiss) Swedish

Note

The variable Server.ColdFusion.SupportedLocales is initialized at startup with a comma-delimited list of the locales that ColdFusion and the operating system support. GetLocale( ) will return an entry from that list. SetLocale will fail if called with a locale name not on that list.

Example

<!--- This example shows GetLocale --->
<HTML>
<HEAD>
<TITLE>GetLocale Example</TITLE>
</HEAD>

<BODY>
<H3>GetLocale Example</H3>

<P>GetLocale returns the locale for the current 
request.  Locales are determined by the native
operating system.

<P>A locale is an encapsulation of the set of attributes
that govern the display and formatting of international
date, time, number, and currency values.

<P>The locale for this system is <CFOUTPUT>#GetLocale()#</CFOUTPUT>

</BODY>
</HTML>