ColdFusion 9.0 Resources |
SetLocaleDescriptionSets the country/language locale for ColdFusion processing and the page returned to the client. The locale value determines the default format of date, time, number, and currency values, according to language and regional conventions. See alsoGetHttpTimeString, GetLocale, GetLocaleDisplayName; Locales in the Developing ColdFusion Applications HistoryColdFusion MX 7: Added support for all locales supported by the ColdFusion Java runtime. ColdFusion MX:
UsageYou can specify any locale name that is listed in the Server.Coldfusion.SupportedLocales variable. This variable is a comma-delimited list of all locale names supported by the JVM, plus the locale names that were required by ColdFusion prior to ColdFusion MX 7. The following locale names were used in ColdFusion releases through ColdFusion MX 6.1, and continue to be supported. If you use any of these values in the SetLocale function, the GetLocale function returns the name you set, not the corresponding Java locale name.
ColdFusion determines the locale value as follows:
Because this function returns the previous locale setting, you can save the original locale value. You can restore the original locale by calling SetLocale again with the saved variable. For example, the following line saves the original locale ins a Session variable: <cfset Session.oldlocale = SetLocale(newLocale)> The variable server.ColdFusion.SupportedLocales is initialized at startup with a comma-delimited list of the locales that ColdFusion and the operating system support. If you call SetLocale with a locale that is not in the list, the call generates an error. Note: ColdFusion uses the Spanish (Standard) formats
for Spanish (Modern) and Spanish (Standard).
Example<h3>SetLocale Example</h3> <p>SetLocale sets the locale to the specified new locale for the current session. <p>A locale encapsulates the set of attributes that govern the display and formatting of 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> |