SetLocale

Description

Sets a locale for the current session.

Syntax

SetLocale(new_locale)

Parameters

Parameter

Description

new_locale
The name of the locale to set

Parameter	Description
new_locale	The name of the locale to set

Usage

SetLocale can be used to restore a previous locale setting by referencing a variable in which the locale was stored:

<cfset oldlocale = SetLocale("localename")>

ColdFusion supports the following locales in 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

:

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 returns an entry from that list. SetLocale fails if called with a locale name not on that list.

Example

<!--- This example shows SetLocale --->
<html>
<head>
<title>SetLocale Example</title>
</head>

<body>
<H3>SetLocale Example</H3>

<P>SetLocale sets the locale to the specified new locale
for the current session.

<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>

<P><cfoutput><I>the old locale was #SetLocale("English (UK)")#</I>
<P>The locale is now #GetLocale()#</cfoutput>

</body>
</html>