getLocaleDisplayName

Gets a locale value and displays the name in a manner that is appropriate to a specific locale. By default, gets the current locale in the current locale's language.

getLocaleDisplayName([locale, inLocale]) → returns string

  1. CFDocs
  2. Functions
  3. ColdFusion 7 New Functions and Tags
  4. getLocaleDisplayName
  5. CF7+
  6. Lucee
  7. BL 1.0.0+
  8. 0 Issue
  9. Edit
See Also:   getLocale   getLocaleInfo   getLocaleCountry   getLocaleLanguage

Argument Reference

locale string

The locale whose name you want. The default is the current ColdFusion locale, or if no ColdFusion locale has been set, the JVM locale.

inLocale string

The locale in which to return the name. The default is the current ColdFusion locale, or if no ColdFusion locale has been set, the JVM locale.

Compatibility

Lucee:

DEPRECATED since version 5 Lucee5+ Deprecated in favor of getLocaleInfo()

Examples
Sample code invoking the getLocaleDisplayName function 

writeOutput(getLocaleDisplayName());
writeOutput(' → ');
setLocale('de_ch');
writeOutput(getLocaleDisplayName());

Expected Result: English (United States) → Deutsch (Schweiz)

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub