Reference:Java.util.Locale
From Triled Wiki
java.util
public final class java.util.Locale
| java.lang.Object | ||
| java.util.Locale | Serializable Cloneable | |
Locale represents a language/country/variant combination. It is an identifier which dictates particular conventions for the presentation of information. The language codes are two letter lowercase codes as defined by ISO-639. The country codes are three letter uppercase codes as defined by ISO-3166. The variant codes are unspecified.
See Also
[edit] Summary
[edit] Constants
| Value | ||||
|---|---|---|---|---|
| Locale | CANADA | Locale constant for en_CA. | ||
| Locale | CANADA_FRENCH | Locale constant for fr_CA. | ||
| Locale | CHINA | Locale constant for zh_CN. | ||
| Locale | CHINESE | Locale constant for zh. | ||
| Locale | ENGLISH | Locale constant for en. | ||
| Locale | FRANCE | Locale constant for fr_FR. | ||
| Locale | FRENCH | Locale constant for fr. | ||
| Locale | GERMAN | Locale constant for de. | ||
| Locale | GERMANY | Locale constant for de_DE. | ||
| Locale | ITALIAN | Locale constant for it. | ||
| Locale | ITALY | Locale constant for it_IT. | ||
| Locale | JAPAN | Locale constant for ja_JP. | ||
| Locale | JAPANESE | Locale constant for ja. | ||
| Locale | KOREA | Locale constant for ko_KR. | ||
| Locale | KOREAN | Locale constant for ko. | ||
| Locale | PRC | Locale constant for zh_CN. | ||
| Locale | SIMPLIFIED_CHINESE | Locale constant for zh_CN. | ||
| Locale | TAIWAN | Locale constant for zh_TW. | ||
| Locale | TRADITIONAL_CHINESE | Locale constant for zh_TW. | ||
| Locale | UK | Locale constant for en_GB. | ||
| Locale | US | Locale constant for en_US. |
[edit] Public Constructors
| Locale (String language) | |||||
| Constructs a new Locale using the specified language. | |||||
| Locale (String language, String country) | |||||
| Constructs a new Locale using the specified language and country codes. | |||||
| Locale (String language, String country, String variant) | |||||
| Constructs a new Locale using the specified language, country, and variant codes. | |||||
[edit] Public Methods
| Object | clone () | ||||
| Answers a new Locale with the same language, country and variant codes as this Locale. | |||||
| boolean | equals (Object object) | ||||
| Compares the specified object to this Locale and answer if they are equal. | |||||
| static | Locale[ ] | getAvailableLocales () | |||
| Gets the list of installed Locales. | |||||
| String | getCountry () | ||||
| Gets the country code for this Locale. | |||||
| static | Locale | getDefault () | |||
| Gets the default Locale. | |||||
| String | getDisplayCountry (Locale locale) | ||||
| Gets the full country name in the specified Locale for the country code of this Locale. | |||||
| final | String | getDisplayCountry () | |||
| Gets the full country name in the default Locale for the country code of this Locale. | |||||
| final | String | getDisplayLanguage () | |||
| Gets the full language name in the default Locale for the language code of this Locale. | |||||
| String | getDisplayLanguage (Locale locale) | ||||
| Gets the full language name in the specified Locale for the language code of this Locale. | |||||
| final | String | getDisplayName () | |||
| Gets the full language, country, and variant names in the default Locale for the codes of this Locale. | |||||
| String | getDisplayName (Locale locale) | ||||
| Gets the full language, country, and variant names in the specified Locale for the codes of this Locale. | |||||
| String | getDisplayVariant (Locale locale) | ||||
| Gets the full variant name in the specified Locale for the variant code of this Locale. | |||||
| final | String | getDisplayVariant () | |||
| Gets the full variant name in the default Locale for the variant code of this Locale. | |||||
| String | getISO3Country () | ||||
| Gets the three letter ISO country code which corresponds to the country code for this Locale. | |||||
| String | getISO3Language () | ||||
| Gets the three letter ISO language code which corresponds to the language code for this Locale. | |||||
| static | String[ ] | getISOCountries () | |||
| Gets the list of two letter ISO country codes which can be used as the country code for a Locale. | |||||
| static | String[ ] | getISOLanguages () | |||
| Gets the list of two letter ISO language codes which can be used as the language code for a Locale. | |||||
| String | getLanguage () | ||||
| Gets the language code for this Locale. | |||||
| String | getVariant () | ||||
| Gets the variant code for this Locale. | |||||
| synchronized | int | hashCode () | |||
| Answers an integer hash code for the receiver. | |||||
| synchronized | static | void | setDefault (Locale locale) | ||
| Sets the default Locale to the specified Locale. | |||||
| final | String | toString () | |||
| Answers the string representation of this Locale. | |||||
[edit] Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
[edit] Details
[edit] Constants
[edit] public static final Locale CANADA
Locale constant for en_CA.
[edit] public static final Locale CANADA_FRENCH
Locale constant for fr_CA.
[edit] public static final Locale CHINA
Locale constant for zh_CN.
[edit] public static final Locale CHINESE
Locale constant for zh.
[edit] public static final Locale ENGLISH
Locale constant for en.
[edit] public static final Locale FRANCE
Locale constant for fr_FR.
[edit] public static final Locale FRENCH
Locale constant for fr.
[edit] public static final Locale GERMAN
Locale constant for de.
[edit] public static final Locale GERMANY
Locale constant for de_DE.
[edit] public static final Locale ITALIAN
Locale constant for it.
[edit] public static final Locale ITALY
Locale constant for it_IT.
[edit] public static final Locale JAPAN
Locale constant for ja_JP.
[edit] public static final Locale JAPANESE
Locale constant for ja.
[edit] public static final Locale KOREA
Locale constant for ko_KR.
[edit] public static final Locale KOREAN
Locale constant for ko.
[edit] public static final Locale PRC
Locale constant for zh_CN.
[edit] public static final Locale SIMPLIFIED_CHINESE
Locale constant for zh_CN.
[edit] public static final Locale TAIWAN
Locale constant for zh_TW.
[edit] public static final Locale TRADITIONAL_CHINESE
Locale constant for zh_TW.
[edit] public static final Locale UK
Locale constant for en_GB.
[edit] public static final Locale US
Locale constant for en_US.
[edit] Public Constructors
[edit] public Locale(String language)
Constructs a new Locale using the specified language.
[edit] public Locale(String language, String country)
Constructs a new Locale using the specified language and country codes.
[edit] public Locale(String language, String country, String variant)
Constructs a new Locale using the specified language, country, and variant codes.
Throws
| NullPointerException | if language, country or variant is null. |
|---|
[edit] Public Methods
[edit] public Object clone()
Answers a new Locale with the same language, country and variant codes as this Locale.
Returns
- a shallow copy of this Locale
See Also
[edit] public boolean equals(Object object)
Compares the specified object to this Locale and answer if they are equal. The object must be an instance of Locale and have the same language, country and variant.
Parameters
| object | the object to compare with this object |
|---|
Returns
- true if the specified object is equal to this Locale, false otherwise
See Also
[edit] public static Locale[ ]getAvailableLocales()
Gets the list of installed Locales.
Returns
- an array of Locale
[edit] public String getCountry()
Gets the country code for this Locale.
Returns
- a country code
[edit] public static Locale getDefault()
Gets the default Locale.
Returns
- the default Locale
[edit] public String getDisplayCountry(Locale locale)
Gets the full country name in the specified Locale for the country code of this Locale. If there is no matching country name, the country code is returned.
Parameters
| locale | the Locale |
|---|
Returns
- a country name
[edit] public final String getDisplayCountry()
Gets the full country name in the default Locale for the country code of this Locale. If there is no matching country name, the country code is returned.
Returns
- a country name
[edit] public final String getDisplayLanguage()
Gets the full language name in the default Locale for the language code of this Locale. If there is no matching language name, the language code is returned.
Returns
- a language name
[edit] public String getDisplayLanguage(Locale locale)
Gets the full language name in the specified Locale for the language code of this Locale. If there is no matching language name, the language code is returned.
Parameters
| locale | the Locale |
|---|
Returns
- a language name
[edit] public final String getDisplayName()
Gets the full language, country, and variant names in the default Locale for the codes of this Locale.
Returns
- a Locale name
[edit] public String getDisplayName(Locale locale)
Gets the full language, country, and variant names in the specified Locale for the codes of this Locale.
Parameters
| locale | the Locale |
|---|
Returns
- a Locale name
[edit] public String getDisplayVariant(Locale locale)
Gets the full variant name in the specified Locale for the variant code of this Locale. If there is no matching variant name, the variant code is returned.
Parameters
| locale | the Locale |
|---|
Returns
- a variant name
[edit] public final String getDisplayVariant()
Gets the full variant name in the default Locale for the variant code of this Locale. If there is no matching variant name, the variant code is returned.
Returns
- a variant name
[edit] public String getISO3Country()
Gets the three letter ISO country code which corresponds to the country code for this Locale.
Returns
- a three letter ISO language code
Throws
| MissingResourceException | when there is no matching three letter ISO country code |
|---|
[edit] public String getISO3Language()
Gets the three letter ISO language code which corresponds to the language code for this Locale.
Returns
- a three letter ISO language code
Throws
| MissingResourceException | when there is no matching three letter ISO language code |
|---|
[edit] public static String[ ]getISOCountries()
Gets the list of two letter ISO country codes which can be used as the country code for a Locale.
Returns
- an array of String
[edit] public static String[ ]getISOLanguages()
Gets the list of two letter ISO language codes which can be used as the language code for a Locale.
Returns
- an array of String
[edit] public String getLanguage()
Gets the language code for this Locale.
Returns
- a language code
[edit] public String getVariant()
Gets the variant code for this Locale.
Returns
- a variant code
[edit] public synchronized int hashCode()
Answers an integer hash code for the receiver. Objects which are equal answer the same value for this method.
Returns
- the receiver's hash
See Also
[edit] public static synchronized void setDefault(Locale locale)
Sets the default Locale to the specified Locale.
Parameters
| locale | the new default Locale |
|---|
Throws
| SecurityException | when there is a security manager which does not allow this operation |
|---|
[edit] public final String toString()
Answers the string representation of this Locale.
Returns
- the string representation of this Locale
[edit] References
- Original documentation page for Android SDK build m5-rc15e - 14 apr 2008 17:27
