
Contents > Developing ColdFusion MX Applications > Developing Globalized Applications > Tags and functions for globalizing > Functions for controlling and using locales

Functions for controlling and using locales

ColdFusion MX provides the following functions that let you specify and identify the locale and format text based on the locale:

Tag or function	Use
`GetLocale`	Returns the current locale setting.
`LSCurrencyFormat`	Converts numbers into a string in a locale-specific currency format. For countries that use the euro, the result depends on the JVM version.
`LSDateFormat`	Converts the date part of a date/time value into a string in a locale-specific date format.
`LSEuroCurrencyFormat`	Converts a number into a string in a locale-specific currency format. Formats using the euro for all countries that use euro as the currency.
`LSIsCurrency`	Determines whether a string is a valid representation of a currency amount in the current locale.
`LSIsDate`	Determines whether a string is a valid representation of a date/time value in the current locale.
`LSIsNumeric`	Determines whether a string is a valid representation of a number in the current locale.
`LSNumberFormat`	Converts a number into a string in a locale-specific numeric format.
`LSParseCurrency`	Converts a string that is a currency amount in the current locale into a formatted number. For countries that use the euro, the result depends on the JVM version.
`LSParseDateTime`	Converts a string that is a valid date/time representation in the current locale into a date/time object.
`LSParseEuroCurrency`	Converts a string that is a currency amount in the current locale into a formatted number. Requires euro as the currency for all countries that use the euro.
`LSParseNumber`	Converts a string that is a valid numeric representation in the current locale into a formatted number.
`LSTimeFormat`	Converts the time part of a date/time value into a string in a locale-specific date format.
`SetLocale`	Specifies the locale setting.

Note: Many functions that have names starting with LS have corresponding functions that do not have this prefix: DateFormat, IsDate, IsNumeric, NumberFormat, ParseDateTime, and TimeFormat. These function use English (US) locale rules.

If you do not precede calls to the LS functions with a call to the SetLocale function, they use the locale defined by the JVM, which typically is the locale of the operating system.

The following example uses the LSDateFormat function to display the current date in the format for each locale supported by ColdFusion MX:

<!--- This example shows LSDateFormat --->
<html>
<head>
<title>LSDateFormat Example</title>
</head>
<body>
<h3>LSDateFormat Example</h3>
<p>Format the date part of a date/time value using the locale convention. 
<!--- loop through a list of locales; show date values for Now()--->
<cfloop list = "#Server.Coldfusion.SupportedLocales#"
   index = "locale" delimiters = ",">
   <cfset oldlocale = SetLocale(locale)>

   <cfoutput><p><B><I>#locale#</I></B><br>
      #LSDateFormat(Now(), "mmm-dd-yyyy")#<br>
      #LSDateFormat(Now(), "mmmm d, yyyy")#<br>
      #LSDateFormat(Now(), "mm/dd/yyyy")#<br>
      #LSDateFormat(Now(), "d-mmm-yyyy")#<br>
      #LSDateFormat(Now(), "ddd, mmmm dd, yyyy")#<br>
      #LSDateFormat(Now(), "d/m/yy")#<br>
      #LSDateFormat(Now())#<br>      
      <hr noshade>
   </cfoutput>
</cfloop>
</body>
</html>


Contents > Developing ColdFusion MX Applications > Developing Globalized Applications > Tags and functions for globalizing > Functions for controlling and using locales

Version 6.1

Comments are no longer accepted for ColdFusion MX 6.1. ColdFusion 8 is the current version.

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/6.1/htmldocs/i18n18.htm