Packagemx.resources
Classpublic class Locale
InheritanceLocale Inheritance Object

The Locale class can be used to parse a locale String such as "en_US_MAC" into its three parts: a language code, a country code, and a variant.

The localization APIs in the IResourceManager and IResourceBundle interfaces use locale Strings rather than Locale instances, so this class is seldom used in an application.

See also

mx.resources.IResourceBundle
mx.resources.IResourceManager


Public Properties
 PropertyDefined By
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  country : String
[read-only] The country code of this Locale instance.
Locale
  language : String
[read-only] The language code of this Locale instance.
Locale
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
  variant : String
[read-only] The variant part of this Locale instance.
Locale
Public Methods
 MethodDefined By
  
Locale(localeString:String)
Constructor.
Locale
  
Deprecated Since 3.0: Please Use ResourceManager.localeChain
[static] Returns a Locale object, if you compiled your application for a single locale.
Locale
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
  
Returns the locale String that was used to construct this Locale instance.
Locale
 Inherited
Returns the primitive value of the specified object.
Object
Property Detail
countryproperty
country:String  [read-only]

The country code of this Locale instance. [Read-Only]

      var locale:Locale = new Locale("en_US_MAC");
      trace(locale.country); // outputs "US"
      



Implementation
    public function get country():String
languageproperty 
language:String  [read-only]

The language code of this Locale instance. [Read-Only]

      var locale:Locale = new Locale("en_US_MAC");
      trace(locale.language); // outputs "en"
      



Implementation
    public function get language():String
variantproperty 
variant:String  [read-only]

The variant part of this Locale instance. [Read-Only]

      var locale:Locale = new Locale("en_US_MAC");
      trace(locale.variant); // outputs "MAC"
      



Implementation
    public function get variant():String
Constructor Detail
Locale()Constructor
public function Locale(localeString:String)

Constructor.

Parameters
localeString:String — A 1-, 2-, or 3-part locale String, such as "en", "en_US", or "en_US_MAC". The parts are separated by underscore characters. The first part is a two-letter lowercase language code as defined by ISO-639, such as "en" for English. The second part is a two-letter uppercase country code as defined by ISO-3166, such as "US" for the United States. The third part is a variant String, which can be used to optionally distinguish multiple locales for the same language and country. It is sometimes used to indicate the operating system that the locale should be used with, such as "MAC", "WIN", or "UNIX".
Method Detail
getCurrent()method
public static function getCurrent(sm:ISystemManager):Locale
Deprecated Since 3.0: Please Use ResourceManager.localeChain

Returns a Locale object, if you compiled your application for a single locale. Otherwise, it returns null.

This method has been deprecated because the Flex framework now supports having resource bundles for multiple locales in the same application. You can use the getLocale() method of IResourceManager to find out which locales the ResourceManager has resource bundles for. You can use the localeChain property of IResourceManager to determine which locales the ResourceManager searches for resources.

Parameters

sm:ISystemManager — The current SystemManager.

Returns
Locale — Returns a Locale object.
toString()method 
public function toString():String

Returns the locale String that was used to construct this Locale instance. For example:

      var locale:Locale = new Locale("en_US_MAC");
      trace(locale.toString()); // outputs "en_US_MAC"
      

Returns
String — Returns the locale String that was used to construct this Locale instance.