com.ibm.icu.util

Class ULocale

public final class ULocale extends Object implements Serializable

A class analogous to java.util.Locale that provides additional support for ICU protocol. In ICU 3.0 this class is enhanced to support RFC 3066 language identifiers.

Many classes and services in ICU follow a factory idiom, in which a factory method or object responds to a client request with an object. The request includes a locale (the requested locale), and the returned object is constructed using data for that locale. The system may lack data for the requested locale, in which case the locale fallback mechanism will be invoked until a populated locale is found (the valid locale). Furthermore, even when a populated locale is found (the valid locale), further fallback may be required to reach a locale containing the specific data required by the service (the actual locale).

ULocale performs 'normalization' and 'canonicalization' of locale ids. Normalization 'cleans up' ICU locale ids as follows:

Canonicalization additionally performs the following: All ULocale constructors automatically normalize the locale id. To handle POSIX ids, canonicalize can be called to convert the id to canonical form, or the canonicalInstance factory method can be called.

This class provides selectors VALID_LOCALE and ACTUAL_LOCALE intended for use in methods named getLocale(). These methods exist in several ICU classes, including Calendar, Currency, UFormat, BreakIterator, Collator, DateFormatSymbols, and DecimalFormatSymbols and their subclasses, if any. Once an object of one of these classes has been created, getLocale() may be called on it to determine the valid and actual locale arrived at during the object's construction.

Note: The getLocale() method will be implemented in ICU 3.0; ICU 2.8 contains a partial preview implementation. The actual locale is returned correctly, but the valid locale is not, in most cases.

Author: weiv Alan Liu Ram Viswanadha

See Also: java.util.Locale

UNKNOWN: ICU 2.8

Nested Class Summary
static classULocale.Type
Opaque selector enum for getLocale().
Field Summary
static ULocale.TypeACTUAL_LOCALE
Selector for getLocale() indicating the locale of the resource containing the data.
static ULocaleCANADA
Useful constant for country/region.
static ULocaleCANADA_FRENCH
Useful constant for country/region.
static ULocaleCHINA
Useful constant for country/region.
static ULocaleCHINESE
Useful constant for language.
static ULocaleENGLISH
Useful constant for language.
static ULocaleFRANCE
Useful constant for country/region.
static ULocaleFRENCH
Useful constant for language.
static ULocaleGERMAN
Useful constant for language.
static ULocaleGERMANY
Useful constant for country/region.
static ULocaleITALIAN
Useful constant for language.
static ULocaleITALY
Useful constant for country/region.
static ULocaleJAPAN
Useful constant for country/region.
static ULocaleJAPANESE
Useful constant for language.
static ULocaleKOREA
Useful constant for country/region.
static ULocaleKOREAN
Useful constant for language.
static ULocalePRC
Useful constant for country/region.
static ULocaleROOT
The root ULocale.
static ULocaleSIMPLIFIED_CHINESE
Useful constant for language.
static ULocaleTAIWAN
Useful constant for country/region.
static ULocaleTRADITIONAL_CHINESE
Useful constant for language.
static ULocaleUK
Useful constant for country/region.
static ULocaleUS
Useful constant for country/region.
static ULocale.TypeVALID_LOCALE
Selector for getLocale() indicating the most specific locale for which any data exists.
Constructor Summary
ULocale(String localeID)
Construct a ULocale from a RFC 3066 locale ID.
ULocale(String a, String b)
Convenience overload of ULocale(String, String, String) for compatibility with java.util.Locale.
ULocale(String a, String b, String c)
Construct a ULocale from a localeID constructed from the three 'fields' a, b, and c.
Method Summary
static ULocaleacceptLanguage(String acceptLanguageList, ULocale[] availableLocales, boolean[] fallback)
Based on a HTTP formatted list of acceptable locales, determine an available locale for the user.
static ULocaleacceptLanguage(ULocale[] acceptLanguageList, ULocale[] availableLocales, boolean[] fallback)
Based on a list of acceptable locales, determine an available locale for the user.
static ULocaleacceptLanguage(String acceptLanguageList, boolean[] fallback)
Based on a HTTP formatted list of acceptable locales, determine an available locale for the user.
static ULocaleacceptLanguage(ULocale[] acceptLanguageList, boolean[] fallback)
Based on an ordered array of acceptable locales, determine an available locale for the user.
static Stringcanonicalize(String localeID)
Returns the canonical name for the specified locale ID.
Objectclone()
This is for compatibility with Locale-- in actuality, since ULocale is immutable, there is no reason to clone it, so this API returns 'this'.
static ULocalecreateCanonical(String nonCanonicalID)
Create a ULocale from the id by first canonicalizing the id.
booleanequals(Object obj)
Returns true if the other object is another ULocale with the same full name, or is a String localeID that matches the full name.
static ULocaleforLocale(Locale loc)
Return a ULocale object for a java.util.Locale.
static ULocale[]getAvailableLocales()
Returns a list of all installed locales.
StringgetBaseName()
Returns the (normalized) base name for this locale.
static StringgetBaseName(String localeID)
Returns the (normalized) base name for the specified locale.
StringgetCountry()
Returns the country/region code for this locale, which will either be the empty string or an uppercase ISO 3166 2-letter code.
static StringgetCountry(String localeID)
Returns the country/region code for this locale, which will either be the empty string or an uppercase ISO 3166 2-letter code.
static ULocalegetDefault()
Returns the current default ULocale.
StringgetDisplayCountry()
Returns this locale's country localized for display in the default locale.
StringgetDisplayCountry(ULocale displayLocale)
Returns this locale's country localized for display in the provided locale.
static StringgetDisplayCountry(String localeID, String displayLocaleID)
Returns a locale's country localized for display in the provided locale.
static StringgetDisplayCountry(String localeID, ULocale displayLocale)
Returns a locale's country localized for display in the provided locale.
static StringgetDisplayKeyword(String keyword)
Returns a keyword localized for display in the default locale.
static StringgetDisplayKeyword(String keyword, String displayLocaleID)
Returns a keyword localized for display in the specified locale.
static StringgetDisplayKeyword(String keyword, ULocale displayLocale)
Returns a keyword localized for display in the specified locale.
StringgetDisplayKeywordValue(String keyword)
Returns a keyword value localized for display in the default locale.
StringgetDisplayKeywordValue(String keyword, ULocale displayLocale)
Returns a keyword value localized for display in the specified locale.
static StringgetDisplayKeywordValue(String localeID, String keyword, String displayLocaleID)
Returns a keyword value localized for display in the specified locale.
static StringgetDisplayKeywordValue(String localeID, String keyword, ULocale displayLocale)
Returns a keyword value localized for display in the specified locale.
StringgetDisplayLanguage()
Returns this locale's language localized for display in the default locale.
StringgetDisplayLanguage(ULocale displayLocale)
Returns this locale's language localized for display in the provided locale.
static StringgetDisplayLanguage(String localeID, String displayLocaleID)
Returns a locale's language localized for display in the provided locale.
static StringgetDisplayLanguage(String localeID, ULocale displayLocale)
Returns a locale's language localized for display in the provided locale.
StringgetDisplayName()
Returns this locale name localized for display in the default locale.
StringgetDisplayName(ULocale displayLocale)
Returns this locale name localized for display in the provided locale.
static StringgetDisplayName(String localeID, String displayLocaleID)
Returns the locale ID localized for display in the provided locale.
static StringgetDisplayName(String localeID, ULocale displayLocale)
Returns the locale ID localized for display in the provided locale.
StringgetDisplayScript()
Returns this locale's script localized for display in the default locale.
StringgetDisplayScript(ULocale displayLocale)
Returns this locale's script localized for display in the provided locale.
static StringgetDisplayScript(String localeID, String displayLocaleID)
Returns a locale's script localized for display in the provided locale.
static StringgetDisplayScript(String localeID, ULocale displayLocale)
Returns a locale's script localized for display in the provided locale.
StringgetDisplayVariant()
Returns this locale's variant localized for display in the default locale.
StringgetDisplayVariant(ULocale displayLocale)
Returns this locale's variant localized for display in the provided locale.
static StringgetDisplayVariant(String localeID, String displayLocaleID)
Returns a locale's variant localized for display in the provided locale.
static StringgetDisplayVariant(String localeID, ULocale displayLocale)
Returns a locale's variant localized for display in the provided locale.
static StringgetFallback(String localeID)
Returns the fallback locale for the specified locale, which might be the empty string.
ULocalegetFallback()
Returns the fallback locale for this locale.
StringgetISO3Country()
Returns a three-letter abbreviation for this locale's country/region.
static StringgetISO3Country(String localeID)
Returns a three-letter abbreviation for this locale's country/region.
StringgetISO3Language()
Returns a three-letter abbreviation for this locale's language.
static StringgetISO3Language(String localeID)
Returns a three-letter abbreviation for this locale's language.
static String[]getISOCountries()
Returns a list of all 2-letter country codes defined in ISO 3166.
static String[]getISOLanguages()
Returns a list of all 2-letter language codes defined in ISO 639.
IteratorgetKeywords()
Returns an iterator over keywords for this locale.
static IteratorgetKeywords(String localeID)
Returns an iterator over keywords for the specified locale.
StringgetKeywordValue(String keywordName)
Returns the value for a keyword in this locale.
static StringgetKeywordValue(String localeID, String keywordName)
Returns the value for a keyword in the specified locale.
StringgetLanguage()
Returns the language code for this locale, which will either be the empty string or a lowercase ISO 639 code.
static StringgetLanguage(String localeID)
Returns the language code for the locale ID, which will either be the empty string or a lowercase ISO 639 code.
StringgetName()
Returns the (normalized) full name for this locale.
static StringgetName(String localeID)
Returns the (normalized) full name for the specified locale.
StringgetScript()
Returns the script code for this locale, which might be the empty string.
static StringgetScript(String localeID)
Returns the script code for the specified locale, which might be the empty string.
StringgetVariant()
Returns the variant code for this locale, which might be the empty string.
static StringgetVariant(String localeID)
Returns the variant code for the specified locale, which might be the empty string.
inthashCode()
Returns the hashCode.
static voidsetDefault(ULocale newLocale)
Sets the default ULocale.
ULocalesetKeywordValue(String keyword, String value)
Given a keyword and a value, return a new locale with an updated keyword and value.
static StringsetKeywordValue(String localeID, String keyword, String value)
Given a locale id, a keyword, and a value, return a new locale id with an updated keyword and value.
LocaletoLocale()
Convert this ULocale object to a java.util.Locale.
StringtoString()
Returns a string representation of this object.

Field Detail

ACTUAL_LOCALE

public static ULocale.Type ACTUAL_LOCALE
Selector for getLocale() indicating the locale of the resource containing the data. This is always at or above the valid locale. If the valid locale does not contain the specific data being requested, then the actual locale will be above the valid locale. If the object was not constructed from locale data, then the valid locale is null.

UNKNOWN: ICU 2.8 (retain) This API might change or be removed in a future release.

CANADA

public static final ULocale CANADA
Useful constant for country/region.

UNKNOWN: ICU 3.0

CANADA_FRENCH

public static final ULocale CANADA_FRENCH
Useful constant for country/region.

UNKNOWN: ICU 3.0

CHINA

public static final ULocale CHINA
Useful constant for country/region.

UNKNOWN: ICU 3.0

CHINESE

public static final ULocale CHINESE
Useful constant for language.

UNKNOWN: ICU 3.0

ENGLISH

public static final ULocale ENGLISH
Useful constant for language.

UNKNOWN: ICU 3.0

FRANCE

public static final ULocale FRANCE
Useful constant for country/region.

UNKNOWN: ICU 3.0

FRENCH

public static final ULocale FRENCH
Useful constant for language.

UNKNOWN: ICU 3.0

GERMAN

public static final ULocale GERMAN
Useful constant for language.

UNKNOWN: ICU 3.0

GERMANY

public static final ULocale GERMANY
Useful constant for country/region.

UNKNOWN: ICU 3.0

ITALIAN

public static final ULocale ITALIAN
Useful constant for language.

UNKNOWN: ICU 3.0

ITALY

public static final ULocale ITALY
Useful constant for country/region.

UNKNOWN: ICU 3.0

JAPAN

public static final ULocale JAPAN
Useful constant for country/region.

UNKNOWN: ICU 3.0

JAPANESE

public static final ULocale JAPANESE
Useful constant for language.

UNKNOWN: ICU 3.0

KOREA

public static final ULocale KOREA
Useful constant for country/region.

UNKNOWN: ICU 3.0

KOREAN

public static final ULocale KOREAN
Useful constant for language.

UNKNOWN: ICU 3.0

PRC

public static final ULocale PRC
Useful constant for country/region.

UNKNOWN: ICU 3.0

ROOT

public static final ULocale ROOT
The root ULocale.

UNKNOWN: ICU 2.8

SIMPLIFIED_CHINESE

public static final ULocale SIMPLIFIED_CHINESE
Useful constant for language.

UNKNOWN: ICU 3.0

TAIWAN

public static final ULocale TAIWAN
Useful constant for country/region.

UNKNOWN: ICU 3.0

TRADITIONAL_CHINESE

public static final ULocale TRADITIONAL_CHINESE
Useful constant for language.

UNKNOWN: ICU 3.0

UK

public static final ULocale UK
Useful constant for country/region.

UNKNOWN: ICU 3.0

US

public static final ULocale US
Useful constant for country/region.

UNKNOWN: ICU 3.0

VALID_LOCALE

public static ULocale.Type VALID_LOCALE
Selector for getLocale() indicating the most specific locale for which any data exists. This is always at or above the requested locale, and at or below the actual locale. If the requested locale does not correspond to any resource data, then the valid locale will be above the requested locale. If the object was not constructed from locale data, then the actual locale is null.

Note: The valid locale will be returned correctly in ICU 3.0 or later. In ICU 2.8, it is not returned correctly.

UNKNOWN: ICU 2.8 (retain) This API might change or be removed in a future release.

Constructor Detail

ULocale

public ULocale(String localeID)
Construct a ULocale from a RFC 3066 locale ID. The locale ID consists of optional language, script, country, and variant fields in that order, separated by underscores, followed by an optional keyword list. The script, if present, is four characters long-- this distinguishes it from a country code, which is two characters long. Other fields are distinguished by position as indicated by the underscores. The start of the keyword list is indicated by '@', and consists of one or more keyword/value pairs separated by commas.

This constructor does not canonicalize the localeID.

Parameters: localeID string representation of the locale, e.g: "en_US", "sy_Cyrl_YU", "zh__pinyin", "es_ES@currency=EUR,collation=traditional"

UNKNOWN: ICU 2.8

ULocale

public ULocale(String a, String b)
Convenience overload of ULocale(String, String, String) for compatibility with java.util.Locale.

See Also: ULocale

UNKNOWN: ICU 3.4

ULocale

public ULocale(String a, String b, String c)
Construct a ULocale from a localeID constructed from the three 'fields' a, b, and c. These fields are concatenated using underscores to form a localeID of the form a_b_c, which is then handled like the localeID passed to ULocale(String localeID).

Java locale strings consisting of language, country, and variant will be handled by this form, since the country code (being shorter than four letters long) will not be interpreted as a script code. If a script code is present, the final argument ('c') will be interpreted as the country code. It is recommended that this constructor only be used to ease porting, and that clients instead use the single-argument constructor when constructing a ULocale from a localeID.

Parameters: a first component of the locale id b second component of the locale id c third component of the locale id

See Also: ULocale

UNKNOWN: ICU 3.0

Method Detail

acceptLanguage

public static ULocale acceptLanguage(String acceptLanguageList, ULocale[] availableLocales, boolean[] fallback)
Based on a HTTP formatted list of acceptable locales, determine an available locale for the user. NullPointerException is thrown if acceptLanguageList or availableLocales is null. If fallback is non-null, it will contain true if a fallback locale (one not in the acceptLanguageList) was returned. The value on entry is ignored. ULocale will be one of the locales in availableLocales, or the ROOT ULocale if if a ROOT locale was used as a fallback (because nothing else in availableLocales matched). No ULocale array element should be null; behavior is undefined if this is the case.

Parameters: acceptLanguageList list in HTTP "Accept-Language:" format of acceptable locales availableLocales list of available locales. One of these will be returned. fallback if non-null, a 1-element array containing a boolean to be set with the fallback status

Returns: one of the locales from the availableLocales list, or null if none match

UNKNOWN: ICU 3.4 This API might change or be removed in a future release.

acceptLanguage

public static ULocale acceptLanguage(ULocale[] acceptLanguageList, ULocale[] availableLocales, boolean[] fallback)
Based on a list of acceptable locales, determine an available locale for the user. NullPointerException is thrown if acceptLanguageList or availableLocales is null. If fallback is non-null, it will contain true if a fallback locale (one not in the acceptLanguageList) was returned. The value on entry is ignored. ULocale will be one of the locales in availableLocales, or the ROOT ULocale if if a ROOT locale was used as a fallback (because nothing else in availableLocales matched). No ULocale array element should be null; behavior is undefined if this is the case.

Parameters: acceptLanguageList list of acceptable locales availableLocales list of available locales. One of these will be returned. fallback if non-null, a 1-element array containing a boolean to be set with the fallback status

Returns: one of the locales from the availableLocales list, or null if none match

UNKNOWN: ICU 3.4 This API might change or be removed in a future release.

acceptLanguage

public static ULocale acceptLanguage(String acceptLanguageList, boolean[] fallback)
Based on a HTTP formatted list of acceptable locales, determine an available locale for the user. NullPointerException is thrown if acceptLanguageList or availableLocales is null. If fallback is non-null, it will contain true if a fallback locale (one not in the acceptLanguageList) was returned. The value on entry is ignored. ULocale will be one of the locales in availableLocales, or the ROOT ULocale if if a ROOT locale was used as a fallback (because nothing else in availableLocales matched). No ULocale array element should be null; behavior is undefined if this is the case. This function will choose a locale from the ULocale.getAvailableLocales() list as available.

Parameters: acceptLanguageList list in HTTP "Accept-Language:" format of acceptable locales fallback if non-null, a 1-element array containing a boolean to be set with the fallback status

Returns: one of the locales from the ULocale.getAvailableLocales() list, or null if none match

UNKNOWN: ICU 3.4 This API might change or be removed in a future release.

acceptLanguage

public static ULocale acceptLanguage(ULocale[] acceptLanguageList, boolean[] fallback)
Based on an ordered array of acceptable locales, determine an available locale for the user. NullPointerException is thrown if acceptLanguageList or availableLocales is null. If fallback is non-null, it will contain true if a fallback locale (one not in the acceptLanguageList) was returned. The value on entry is ignored. ULocale will be one of the locales in availableLocales, or the ROOT ULocale if if a ROOT locale was used as a fallback (because nothing else in availableLocales matched). No ULocale array element should be null; behavior is undefined if this is the case. This function will choose a locale from the ULocale.getAvailableLocales() list as available.

Parameters: acceptLanguageList ordered array of acceptable locales (preferred are listed first) fallback if non-null, a 1-element array containing a boolean to be set with the fallback status

Returns: one of the locales from the ULocale.getAvailableLocales() list, or null if none match

UNKNOWN: ICU 3.4 This API might change or be removed in a future release.

canonicalize

public static String canonicalize(String localeID)
Returns the canonical name for the specified locale ID. This is used to convert POSIX and other grandfathered IDs to standard ICU form.

Parameters: localeID the locale id

Returns: the canonicalized id

UNKNOWN: ICU 3.0

clone

public Object clone()
This is for compatibility with Locale-- in actuality, since ULocale is immutable, there is no reason to clone it, so this API returns 'this'.

UNKNOWN: ICU 3.0

createCanonical

public static ULocale createCanonical(String nonCanonicalID)
Create a ULocale from the id by first canonicalizing the id.

Parameters: nonCanonicalID the locale id to canonicalize

Returns: the locale created from the canonical version of the ID.

UNKNOWN: ICU 3.0

equals

public boolean equals(Object obj)
Returns true if the other object is another ULocale with the same full name, or is a String localeID that matches the full name. Note that since names are not canonicalized, two ULocales that function identically might not compare equal.

Returns: true if this Locale is equal to the specified object.

UNKNOWN: ICU 3.0

forLocale

public static ULocale forLocale(Locale loc)
Return a ULocale object for a java.util.Locale. The ULocale is canonicalized.

Parameters: loc a JDK locale

UNKNOWN: ICU 3.2

getAvailableLocales

public static ULocale[] getAvailableLocales()
Returns a list of all installed locales.

UNKNOWN: ICU 3.0

getBaseName

public String getBaseName()
Returns the (normalized) base name for this locale.

Returns: the base name as a String.

UNKNOWN: ICU 3.0

getBaseName

public static String getBaseName(String localeID)
Returns the (normalized) base name for the specified locale.

Parameters: localeID the locale ID as a string

Returns: the base name as a String.

UNKNOWN: ICU 3.0

getCountry

public String getCountry()
Returns the country/region code for this locale, which will either be the empty string or an uppercase ISO 3166 2-letter code.

See Also: getDisplayCountry getDisplayCountry

UNKNOWN: ICU 3.0

getCountry

public static String getCountry(String localeID)
Returns the country/region code for this locale, which will either be the empty string or an uppercase ISO 3166 2-letter code.

Parameters: localeID

See Also: getDisplayCountry getDisplayCountry

UNKNOWN: ICU 3.0

getDefault

public static ULocale getDefault()
Returns the current default ULocale.

UNKNOWN: ICU 2.8

getDisplayCountry

public String getDisplayCountry()
Returns this locale's country localized for display in the default locale.

Returns: the localized country name.

UNKNOWN: ICU 3.0

getDisplayCountry

public String getDisplayCountry(ULocale displayLocale)
Returns this locale's country localized for display in the provided locale.

Parameters: displayLocale the locale in which to display the name.

Returns: the localized country name.

UNKNOWN: ICU 3.0

getDisplayCountry

public static String getDisplayCountry(String localeID, String displayLocaleID)
Returns a locale's country localized for display in the provided locale. This is a cover for the ICU4C API.

Parameters: localeID the id of the locale whose country will be displayed displayLocaleID the id of the locale in which to display the name.

Returns: the localized country name.

UNKNOWN: ICU 3.0

getDisplayCountry

public static String getDisplayCountry(String localeID, ULocale displayLocale)
Returns a locale's country localized for display in the provided locale. This is a cover for the ICU4C API.

Parameters: localeID the id of the locale whose country will be displayed. displayLocale the locale in which to display the name.

Returns: the localized country name.

UNKNOWN: ICU 3.0

getDisplayKeyword

public static String getDisplayKeyword(String keyword)
Returns a keyword localized for display in the default locale.

Parameters: keyword the keyword to be displayed.

Returns: the localized keyword name.

See Also: getKeywords

UNKNOWN: ICU 3.0

getDisplayKeyword

public static String getDisplayKeyword(String keyword, String displayLocaleID)
Returns a keyword localized for display in the specified locale.

Parameters: keyword the keyword to be displayed. displayLocaleID the id of the locale in which to display the keyword.

Returns: the localized keyword name.

See Also: getKeywords

UNKNOWN: ICU 3.0

getDisplayKeyword

public static String getDisplayKeyword(String keyword, ULocale displayLocale)
Returns a keyword localized for display in the specified locale.

Parameters: keyword the keyword to be displayed. displayLocale the locale in which to display the keyword.

Returns: the localized keyword name.

See Also: getKeywords

UNKNOWN: ICU 3.0

getDisplayKeywordValue

public String getDisplayKeywordValue(String keyword)
Returns a keyword value localized for display in the default locale.

Parameters: keyword the keyword whose value is to be displayed.

Returns: the localized value name.

UNKNOWN: ICU 3.0

getDisplayKeywordValue

public String getDisplayKeywordValue(String keyword, ULocale displayLocale)
Returns a keyword value localized for display in the specified locale.

Parameters: keyword the keyword whose value is to be displayed. displayLocale the locale in which to display the value.

Returns: the localized value name.

UNKNOWN: ICU 3.0

getDisplayKeywordValue

public static String getDisplayKeywordValue(String localeID, String keyword, String displayLocaleID)
Returns a keyword value localized for display in the specified locale. This is a cover for the ICU4C API.

Parameters: localeID the id of the locale whose keyword value is to be displayed. keyword the keyword whose value is to be displayed. displayLocaleID the id of the locale in which to display the value.

Returns: the localized value name.

UNKNOWN: ICU 3.0

getDisplayKeywordValue

public static String getDisplayKeywordValue(String localeID, String keyword, ULocale displayLocale)
Returns a keyword value localized for display in the specified locale. This is a cover for the ICU4C API.

Parameters: localeID the id of the locale whose keyword value is to be displayed. keyword the keyword whose value is to be displayed. displayLocale the id of the locale in which to display the value.

Returns: the localized value name.

UNKNOWN: ICU 3.0

getDisplayLanguage

public String getDisplayLanguage()
Returns this locale's language localized for display in the default locale.

Returns: the localized language name.

UNKNOWN: ICU 3.0

getDisplayLanguage

public String getDisplayLanguage(ULocale displayLocale)
Returns this locale's language localized for display in the provided locale.

Parameters: displayLocale the locale in which to display the name.

Returns: the localized language name.

UNKNOWN: ICU 3.0

getDisplayLanguage

public static String getDisplayLanguage(String localeID, String displayLocaleID)
Returns a locale's language localized for display in the provided locale. This is a cover for the ICU4C API.

Parameters: localeID the id of the locale whose language will be displayed displayLocaleID the id of the locale in which to display the name.

Returns: the localized language name.

UNKNOWN: ICU 3.0

getDisplayLanguage

public static String getDisplayLanguage(String localeID, ULocale displayLocale)
Returns a locale's language localized for display in the provided locale. This is a cover for the ICU4C API.

Parameters: localeID the id of the locale whose language will be displayed. displayLocale the locale in which to display the name.

Returns: the localized language name.

UNKNOWN: ICU 3.0

getDisplayName

public String getDisplayName()
Returns this locale name localized for display in the default locale.

Returns: the localized locale name.

UNKNOWN: ICU 3.0

getDisplayName

public String getDisplayName(ULocale displayLocale)
Returns this locale name localized for display in the provided locale.

Parameters: displayLocale the locale in which to display the locale name.

Returns: the localized locale name.

UNKNOWN: ICU 3.0

getDisplayName

public static String getDisplayName(String localeID, String displayLocaleID)
Returns the locale ID localized for display in the provided locale. This is a cover for the ICU4C API.

Parameters: localeID the locale whose name is to be displayed. displayLocaleID the id of the locale in which to display the locale name.

Returns: the localized locale name.

UNKNOWN: ICU 3.0

getDisplayName

public static String getDisplayName(String localeID, ULocale displayLocale)
Returns the locale ID localized for display in the provided locale. This is a cover for the ICU4C API.

Parameters: localeID the locale whose name is to be displayed. displayLocale the locale in which to display the locale name.

Returns: the localized locale name.

UNKNOWN: ICU 3.0

getDisplayScript

public String getDisplayScript()
Returns this locale's script localized for display in the default locale.

Returns: the localized script name.

UNKNOWN: ICU 3.0

getDisplayScript

public String getDisplayScript(ULocale displayLocale)
Returns this locale's script localized for display in the provided locale.

Parameters: displayLocale the locale in which to display the name.

Returns: the localized script name.

UNKNOWN: ICU 3.0

getDisplayScript

public static String getDisplayScript(String localeID, String displayLocaleID)
Returns a locale's script localized for display in the provided locale. This is a cover for the ICU4C API.

Parameters: localeID the id of the locale whose script will be displayed displayLocaleID the id of the locale in which to display the name.

Returns: the localized script name.

UNKNOWN: ICU 3.0

getDisplayScript

public static String getDisplayScript(String localeID, ULocale displayLocale)
Returns a locale's script localized for display in the provided locale.

Parameters: localeID the id of the locale whose script will be displayed. displayLocale the locale in which to display the name.

Returns: the localized script name.

UNKNOWN: ICU 3.0

getDisplayVariant

public String getDisplayVariant()
Returns this locale's variant localized for display in the default locale.

Returns: the localized variant name.

UNKNOWN: ICU 3.0

getDisplayVariant

public String getDisplayVariant(ULocale displayLocale)
Returns this locale's variant localized for display in the provided locale.

Parameters: displayLocale the locale in which to display the name.

Returns: the localized variant name.

UNKNOWN: ICU 3.0

getDisplayVariant

public static String getDisplayVariant(String localeID, String displayLocaleID)
Returns a locale's variant localized for display in the provided locale. This is a cover for the ICU4C API.

Parameters: localeID the id of the locale whose variant will be displayed displayLocaleID the id of the locale in which to display the name.

Returns: the localized variant name.

UNKNOWN: ICU 3.0

getDisplayVariant

public static String getDisplayVariant(String localeID, ULocale displayLocale)
Returns a locale's variant localized for display in the provided locale. This is a cover for the ICU4C API.

Parameters: localeID the id of the locale whose variant will be displayed. displayLocale the locale in which to display the name.

Returns: the localized variant name.

UNKNOWN: ICU 3.0

getFallback

public static String getFallback(String localeID)
Returns the fallback locale for the specified locale, which might be the empty string.

UNKNOWN: ICU 3.2

getFallback

public ULocale getFallback()
Returns the fallback locale for this locale. If this locale is root, returns null.

UNKNOWN: ICU 3.2

getISO3Country

public String getISO3Country()
Returns a three-letter abbreviation for this locale's country/region. If the locale doesn't specify a country, returns the empty string. Otherwise, returns an uppercase ISO 3166 3-letter country code.

Throws: MissingResourceException Throws MissingResourceException if the three-letter country abbreviation is not available for this locale.

UNKNOWN: ICU 3.0

getISO3Country

public static String getISO3Country(String localeID)
Returns a three-letter abbreviation for this locale's country/region. If the locale doesn't specify a country, returns the empty string. Otherwise, returns an uppercase ISO 3166 3-letter country code.

Throws: MissingResourceException Throws MissingResourceException if the three-letter country abbreviation is not available for this locale.

UNKNOWN: ICU 3.0

getISO3Language

public String getISO3Language()
Returns a three-letter abbreviation for this locale's language. If the locale doesn't specify a language, returns the empty string. Otherwise, returns a lowercase ISO 639-2/T language code. The ISO 639-2 language codes can be found on-line at ftp://dkuug.dk/i18n/iso-639-2.txt

Throws: MissingResourceException Throws MissingResourceException if the three-letter language abbreviation is not available for this locale.

UNKNOWN: ICU 3.0

getISO3Language

public static String getISO3Language(String localeID)
Returns a three-letter abbreviation for this locale's language. If the locale doesn't specify a language, returns the empty string. Otherwise, returns a lowercase ISO 639-2/T language code. The ISO 639-2 language codes can be found on-line at ftp://dkuug.dk/i18n/iso-639-2.txt

Throws: MissingResourceException Throws MissingResourceException if the three-letter language abbreviation is not available for this locale.

UNKNOWN: ICU 3.0

getISOCountries

public static String[] getISOCountries()
Returns a list of all 2-letter country codes defined in ISO 3166. Can be used to create Locales.

UNKNOWN: ICU 3.0

getISOLanguages

public static String[] getISOLanguages()
Returns a list of all 2-letter language codes defined in ISO 639. Can be used to create Locales. [NOTE: ISO 639 is not a stable standard-- some languages' codes have changed. The list this function returns includes both the new and the old codes for the languages whose codes have changed.]

UNKNOWN: ICU 3.0

getKeywords

public Iterator getKeywords()
Returns an iterator over keywords for this locale. If there are no keywords, returns null.

Returns: iterator over keywords, or null if there are no keywords.

UNKNOWN: ICU 3.0

getKeywords

public static Iterator getKeywords(String localeID)
Returns an iterator over keywords for the specified locale. If there are no keywords, returns null.

Returns: an iterator over the keywords in the specified locale, or null if there are no keywords.

UNKNOWN: ICU 3.0

getKeywordValue

public String getKeywordValue(String keywordName)
Returns the value for a keyword in this locale. If the keyword is not defined, returns null.

Parameters: keywordName name of the keyword whose value is desired. Case insensitive.

Returns: the value of the keyword, or null.

UNKNOWN: ICU 3.0

getKeywordValue

public static String getKeywordValue(String localeID, String keywordName)
Returns the value for a keyword in the specified locale. If the keyword is not defined, returns null. The locale name does not need to be normalized.

Parameters: keywordName name of the keyword whose value is desired. Case insensitive.

Returns: String the value of the keyword as a string

UNKNOWN: ICU 3.0

getLanguage

public String getLanguage()
Returns the language code for this locale, which will either be the empty string or a lowercase ISO 639 code.

See Also: getDisplayLanguage getDisplayLanguage

UNKNOWN: ICU 3.0

getLanguage

public static String getLanguage(String localeID)
Returns the language code for the locale ID, which will either be the empty string or a lowercase ISO 639 code.

See Also: getDisplayLanguage getDisplayLanguage

UNKNOWN: ICU 3.0

getName

public String getName()
Returns the (normalized) full name for this locale.

Returns: String the full name of the localeID

UNKNOWN: ICU 3.0

getName

public static String getName(String localeID)
Returns the (normalized) full name for the specified locale.

Parameters: localeID the localeID as a string

Returns: String the full name of the localeID

UNKNOWN: ICU 3.0

getScript

public String getScript()
Returns the script code for this locale, which might be the empty string.

See Also: getDisplayScript getDisplayScript

UNKNOWN: ICU 3.0

getScript

public static String getScript(String localeID)
Returns the script code for the specified locale, which might be the empty string.

See Also: getDisplayScript getDisplayScript

UNKNOWN: ICU 3.0

getVariant

public String getVariant()
Returns the variant code for this locale, which might be the empty string.

See Also: getDisplayVariant getDisplayVariant

UNKNOWN: ICU 3.0

getVariant

public static String getVariant(String localeID)
Returns the variant code for the specified locale, which might be the empty string.

See Also: getDisplayVariant getDisplayVariant

UNKNOWN: ICU 3.0

hashCode

public int hashCode()
Returns the hashCode.

UNKNOWN: ICU 3.0

setDefault

public static void setDefault(ULocale newLocale)
Sets the default ULocale. This also sets the default Locale. If the caller does not have write permission to the user.language property, a security exception will be thrown, and the default ULocale will remain unchanged.

Parameters: newLocale the new default locale

Throws: SecurityException if a security manager exists and its checkPermission method doesn't allow the operation. NullPointerException if newLocale is null

See Also: SecurityManager#checkPermission(java.security.Permission) java.util.PropertyPermission

UNKNOWN: ICU 3.0

setKeywordValue

public ULocale setKeywordValue(String keyword, String value)
Given a keyword and a value, return a new locale with an updated keyword and value. If keyword is null, this removes all keywords from the locale id. Otherwise, if the value is null, this removes the value for this keyword from the locale id. Otherwise, this adds/replaces the value for this keyword in the locale id. The keyword and value must not be empty.

Parameters: keyword the keyword to add/remove, or null to remove all keywords. value the value to add/set, or null to remove this particular keyword.

Returns: the updated locale

UNKNOWN: ICU 3.2

setKeywordValue

public static String setKeywordValue(String localeID, String keyword, String value)
Given a locale id, a keyword, and a value, return a new locale id with an updated keyword and value. If keyword is null, this removes all keywords from the locale id. Otherwise, if the value is null, this removes the value for this keyword from the locale id. Otherwise, this adds/replaces the value for this keyword in the locale id. The keyword and value must not be empty.

Parameters: localeID the locale id to modify keyword the keyword to add/remove, or null to remove all keywords. value the value to add/set, or null to remove this particular keyword.

Returns: the updated locale id

UNKNOWN: ICU 3.2

toLocale

public Locale toLocale()
Convert this ULocale object to a java.util.Locale.

Returns: a JDK locale that either exactly represents this object or is the closest approximation.

UNKNOWN: ICU 2.8

toString

public String toString()
Returns a string representation of this object.

UNKNOWN: ICU 3.0

Copyright (c) 2007 IBM Corporation and others.