Uses of Class
com.ibm.icu.util.ULocale

Packages that use ULocale

Package	Description
com.ibm.icu.lang	Enhanced character property and surrogate support.
com.ibm.icu.number	Library for localized number formatting introduced in ICU 60; for usage, see com.ibm.icu.number.NumberFormatter.
com.ibm.icu.segmenter
com.ibm.icu.text	Extensions and enhancements to java.text to support unicode transforms, UnicodeSet, surrogate char utilities, UCA collation, normalization, break iteration (rule and dictionary based), enhanced number format, international string searching, and arabic shaping.
com.ibm.icu.util	International calendars and other utility classes.

Uses of ULocale in com.ibm.icu.lang

Methods in com.ibm.icu.lang with parameters of type ULocale

Modifier and Type	Method	Description
static int[]	UScript.getCode(ULocale locale)	Gets a script codes associated with the given locale or ISO 15924 abbreviation or name.
static String	UCharacter.toLowerCase(ULocale locale, String str)	Returns the lowercase version of the argument string.
static String	UCharacter.toTitleCase(ULocale locale, String str, BreakIterator titleIter)	Returns the titlecase version of the argument string.
static String	UCharacter.toTitleCase(ULocale locale, String str, BreakIterator titleIter, int options)	Returns the titlecase version of the argument string.
static String	UCharacter.toUpperCase(ULocale locale, String str)	Returns the uppercase version of the argument string.

Uses of ULocale in com.ibm.icu.number

Methods in com.ibm.icu.number with parameters of type ULocale

Modifier and Type	Method	Description
LocalizedNumberFormatter	UnlocalizedNumberFormatter.locale(ULocale locale)	ULocale version of the UnlocalizedNumberFormatter.locale(Locale) setter above.
LocalizedNumberRangeFormatter	UnlocalizedNumberRangeFormatter.locale(ULocale locale)	ULocale version of the UnlocalizedNumberRangeFormatter.locale(Locale) setter above.
static LocalizedNumberFormatter	NumberFormatter.withLocale(ULocale locale)	Call this method at the beginning of a NumberFormatter fluent chain in which the locale is known at the call site.
static LocalizedNumberRangeFormatter	NumberRangeFormatter.withLocale(ULocale locale)	Call this method at the beginning of a NumberRangeFormatter fluent chain in which the locale is known at the call site.

Uses of ULocale in com.ibm.icu.segmenter

Methods in com.ibm.icu.segmenter with parameters of type ULocale

Modifier and Type	Method	Description
LocalizedSegmenter.Builder	LocalizedSegmenter.Builder.setLocale(ULocale locale)	Set the locale for which segmentation rules will be loaded

Uses of ULocale in com.ibm.icu.text

Fields in com.ibm.icu.text declared as ULocale

Modifier and Type	Field	Description
ULocale	LocaleDisplayNames.UiListItem.minimized	Returns the minimized locale for an input locale, such as sr-Cyrl → sr
ULocale	LocaleDisplayNames.UiListItem.modified	Returns the modified locale for an input locale, such as sr → sr-Cyrl, where there is also an sr-Latn in the list

Methods in com.ibm.icu.text that return ULocale

Modifier and Type	Method	Description
static ULocale[]	BreakIterator.getAvailableULocales()	[icu] Returns a list of locales for which BreakIterators can be used.
static ULocale[]	Collator.getAvailableULocales()	[icu] Returns the set of locales, as ULocale objects, for which collators are installed.
static ULocale[]	DateFormat.getAvailableULocales()	[icu] Returns the set of locales for which DateFormats are installed.
static ULocale[]	DateFormatSymbols.getAvailableULocales()	[icu] Returns an array of all locales for which the getInstance methods of this class can return localized instances.
static ULocale[]	DecimalFormatSymbols.getAvailableULocales()	[icu] Returns an array of all locales for which the getInstance methods of this class can return localized instances.
static ULocale[]	NumberFormat.getAvailableULocales()	[icu] Returns the list of Locales for which NumberFormats are available.
abstract ULocale[]	PluralRules.Factory.getAvailableULocales()	Deprecated. This API is ICU internal only.
static ULocale[]	PluralRules.getAvailableULocales()	Returns the set of locales for which PluralRules are known.
static ULocale	Collator.getFunctionalEquivalent(String keyword, ULocale locID)	[icu] Returns the functionally equivalent locale for the given requested locale, with respect to given keyword, for the collation service.
static ULocale	Collator.getFunctionalEquivalent(String keyword, ULocale locID, boolean[] isAvailable)	[icu] Returns the functionally equivalent locale for the given requested locale, with respect to given keyword, for the collation service.
abstract ULocale	PluralRules.Factory.getFunctionalEquivalent(ULocale locale, boolean[] isAvailable)	Deprecated. This API is ICU internal only.
static ULocale	PluralRules.getFunctionalEquivalent(ULocale locale, boolean[] isAvailable)	Returns the 'functionally equivalent' locale with respect to plural rules.
ULocale	BreakIterator.getLocale(ULocale.Type type)	[icu] Returns the locale that was used to create this object, or null.
ULocale	Collator.getLocale(ULocale.Type type)	[icu] Returns the locale that was used to create this object, or null.
ULocale	CurrencyPluralInfo.getLocale()	Get locale
ULocale	DateFormatSymbols.getLocale(ULocale.Type type)	Returns the locale that was used to create this object, or null.
ULocale	DecimalFormatSymbols.getLocale(ULocale.Type type)	[icu] Returns the locale that was used to create this object, or null.
ULocale	ListFormatter.getLocale()	Deprecated. This API is ICU internal only.
abstract ULocale	LocaleDisplayNames.getLocale()	Returns the locale used to determine the display names.
ULocale	MeasureFormat.getLocale()	Get the locale of this instance.
ULocale	RuleBasedCollator.getLocale(ULocale.Type type)	[icu] Returns the locale that was used to create this object, or null.
ULocale	UFormat.getLocale(ULocale.Type type)	Return the locale that was used to create this object, or null.
ULocale[]	RuleBasedNumberFormat.getRuleSetDisplayNameLocales()	Return a list of locales for which there are locale-specific display names for the rule sets in this formatter.
abstract ULocale	CurrencyDisplayNames.getULocale()	Returns the locale used to determine how to translate the currency names.
ULocale	DecimalFormatSymbols.getULocale()	Returns the locale for which this object was constructed.
ULocale	MessageFormat.getULocale()	[icu] Returns the locale that's used when creating argument Format objects.

Methods in com.ibm.icu.text that return types with arguments of type ULocale

Modifier and Type	Method	Description
Set<ULocale>	SpoofChecker.getAllowedLocales()	Get a read-only set of locales for the scripts that are acceptable in strings to be checked.

Methods in com.ibm.icu.text with parameters of type ULocale

Modifier and Type	Method	Description
AlphabeticIndex<V>	AlphabeticIndex.addLabels(ULocale... additions)	Add more index characters (aside from what are in the locale)
Collator	Collator.CollatorFactory.createCollator(ULocale loc)	Return an instance of the appropriate collator.
NumberFormat	NumberFormat.NumberFormatFactory.createFormat(ULocale loc, int formatType)	Returns a number format of the appropriate type.
PluralRules	PluralRules.Factory.forLocale(ULocale locale)	Deprecated. This API is ICU internal only.
abstract PluralRules	PluralRules.Factory.forLocale(ULocale locale, PluralRules.PluralType type)	Deprecated. This API is ICU internal only.
static PluralRules	PluralRules.forLocale(ULocale locale)	Provides access to the predefined cardinal-number PluralRules for a given locale.
static PluralRules	PluralRules.forLocale(ULocale locale, PluralRules.PluralType type)	Provides access to the predefined PluralRules for a given locale and the plural type.
static DecimalFormatSymbols	DecimalFormatSymbols.forNumberingSystem(ULocale locale, NumberingSystem ns)	[icu] Returns a DecimalFormatSymbols instance for the given locale with digits and symbols corresponding to the given NumberingSystem.
RbnfLenientScanner	RbnfLenientScannerProvider.get(ULocale locale, String extras)	Deprecated. ICU 54
static BreakIterator	BreakIterator.getBreakInstance(ULocale where, int kind)	Deprecated. This API is ICU internal only.
static BreakIterator	BreakIterator.getCharacterInstance(ULocale where)	[icu] Returns a new instance of BreakIterator that locates logical-character boundaries.
static MeasureFormat	MeasureFormat.getCurrencyFormat(ULocale locale)	Return a formatter for CurrencyAmount objects in the given locale.
static NumberFormat	NumberFormat.getCurrencyInstance(ULocale inLocale)	NOTE: New users are strongly encouraged to use NumberFormatter instead of NumberFormat.
static ResourceBundle	DateFormatSymbols.getDateFormatBundle(Calendar cal, ULocale locale)	Deprecated. ICU 4.0
static ResourceBundle	DateFormatSymbols.getDateFormatBundle(Class<? extends Calendar> calendarClass, ULocale locale)	Deprecated. ICU 4.0
static DateFormat	DateFormat.getDateInstance(int style, ULocale locale)	Returns the date formatter with the given formatting style for the given locale.
static DateFormat	DateFormat.getDateInstance(Calendar cal, int dateStyle, ULocale locale)	Creates a DateFormat object that can be used to format dates in the calendar system specified by cal.
static DateFormat	DateFormat.getDateTimeInstance(int dateStyle, int timeStyle, ULocale locale)	Returns the date/time formatter with the given formatting styles for the given locale.
static DateFormat	DateFormat.getDateTimeInstance(Calendar cal, int dateStyle, int timeStyle, ULocale locale)	Creates a DateFormat object that can be used to format dates and times in the calendar system specified by cal.
String	Collator.CollatorFactory.getDisplayName(ULocale objectLocale, ULocale displayLocale)	Return the name of the collator for the objectLocale, localized for the displayLocale.
static String	Collator.getDisplayName(ULocale objectLocale)	[icu] Returns the name of the collator for the objectLocale, localized for the default DISPLAY locale.
static String	Collator.getDisplayName(ULocale objectLocale, ULocale displayLocale)	[icu] Returns the name of the collator for the objectLocale, localized for the displayLocale.
static String	Transliterator.getDisplayName(String id, ULocale inLocale)	Returns a name for this transliterator that is appropriate for display to the user in the given locale.
static DateTimePatternGenerator	DateTimePatternGenerator.getFrozenInstance(ULocale uLocale)	Deprecated. This API is ICU internal only.
static ULocale	Collator.getFunctionalEquivalent(String keyword, ULocale locID)	[icu] Returns the functionally equivalent locale for the given requested locale, with respect to given keyword, for the collation service.
static ULocale	Collator.getFunctionalEquivalent(String keyword, ULocale locID, boolean[] isAvailable)	[icu] Returns the functionally equivalent locale for the given requested locale, with respect to given keyword, for the collation service.
abstract ULocale	PluralRules.Factory.getFunctionalEquivalent(ULocale locale, boolean[] isAvailable)	Deprecated. This API is ICU internal only.
static ULocale	PluralRules.getFunctionalEquivalent(ULocale locale, boolean[] isAvailable)	Returns the 'functionally equivalent' locale with respect to plural rules.
static Collator	Collator.getInstance(ULocale locale)	[icu] Returns the Collator for the desired locale.
static CompactDecimalFormat	CompactDecimalFormat.getInstance(ULocale locale, CompactDecimalFormat.CompactStyle style)	NOTE: New users are strongly encouraged to use NumberFormatter instead of NumberFormat.
static CurrencyDisplayNames	CurrencyDisplayNames.getInstance(ULocale locale)	Return an instance of CurrencyDisplayNames that provides information localized for display in the provided locale.
static CurrencyDisplayNames	CurrencyDisplayNames.getInstance(ULocale locale, boolean noSubstitute)	Return an instance of CurrencyDisplayNames that provides information localized for display in the provided locale.
static CurrencyPluralInfo	CurrencyPluralInfo.getInstance(ULocale locale)	Gets a CurrencyPluralInfo instance for the given locale.
static DateFormat	DateFormat.getInstance(Calendar cal, ULocale locale)	Returns a date/time formatter that uses the SHORT style for both the date and the time.
static DateFormatSymbols	DateFormatSymbols.getInstance(ULocale locale)	[icu] Returns a DateFormatSymbols instance for the given locale.
static DateIntervalFormat	DateIntervalFormat.getInstance(String skeleton, ULocale locale)	Construct a DateIntervalFormat from skeleton and a given locale.
static DateIntervalFormat	DateIntervalFormat.getInstance(String skeleton, ULocale locale, DateIntervalInfo dtitvinf)	Construct a DateIntervalFormat from skeleton a DateIntervalInfo, and the given locale.
static DateTimePatternGenerator	DateTimePatternGenerator.getInstance(ULocale uLocale)	Construct a flexible generator according to data for a given locale.
static DecimalFormatSymbols	DecimalFormatSymbols.getInstance(ULocale locale)	Returns a DecimalFormatSymbols instance for the given locale.
static DurationFormat	DurationFormat.getInstance(ULocale locale)	Deprecated. ICU 56
static FilteredBreakIteratorBuilder	FilteredBreakIteratorBuilder.getInstance(ULocale where)	Construct a FilteredBreakIteratorBuilder based on sentence break exception rules in a locale.
static ListFormatter	ListFormatter.getInstance(ULocale locale)	Create a list formatter that is appropriate for a locale.
static ListFormatter	ListFormatter.getInstance(ULocale locale, ListFormatter.Type type, ListFormatter.Width width)	Create a list formatter that is appropriate for a locale.
static LocaleDisplayNames	LocaleDisplayNames.getInstance(ULocale locale)	Convenience overload of LocaleDisplayNames.getInstance(ULocale, DialectHandling) that specifies STANDARD dialect handling.
static LocaleDisplayNames	LocaleDisplayNames.getInstance(ULocale locale, DisplayContext... contexts)	Returns an instance of LocaleDisplayNames that returns names formatted for the provided locale, using the provided DisplayContext settings
static LocaleDisplayNames	LocaleDisplayNames.getInstance(ULocale locale, LocaleDisplayNames.DialectHandling dialectHandling)	Returns an instance of LocaleDisplayNames that returns names formatted for the provided locale, using the provided dialectHandling.
static MeasureFormat	MeasureFormat.getInstance(ULocale locale, MeasureFormat.FormatWidth formatWidth)	Create a format from the locale, formatWidth, and format.
static MeasureFormat	MeasureFormat.getInstance(ULocale locale, MeasureFormat.FormatWidth formatWidth, NumberFormat format)	Create a format from the locale, formatWidth, and format.
static NumberFormat	NumberFormat.getInstance(ULocale inLocale)	NOTE: New users are strongly encouraged to use NumberFormatter instead of NumberFormat.
static NumberFormat	NumberFormat.getInstance(ULocale desiredLocale, int choice)	NOTE: New users are strongly encouraged to use NumberFormatter instead of NumberFormat.
static NumberingSystem	NumberingSystem.getInstance(ULocale locale)	Returns the default numbering system for the specified ULocale.
static RelativeDateTimeFormatter	RelativeDateTimeFormatter.getInstance(ULocale locale)	Returns a RelativeDateTimeFormatter for a particular locale.
static RelativeDateTimeFormatter	RelativeDateTimeFormatter.getInstance(ULocale locale, NumberFormat nf)	Returns a RelativeDateTimeFormatter for a particular locale that uses a particular NumberFormat object.
static RelativeDateTimeFormatter	RelativeDateTimeFormatter.getInstance(ULocale locale, NumberFormat nf, RelativeDateTimeFormatter.Style style, DisplayContext capitalizationContext)	Returns a RelativeDateTimeFormatter for a particular locale that uses a particular NumberFormat object, style, and capitalization context
static TimeZoneFormat	TimeZoneFormat.getInstance(ULocale locale)	Returns a frozen instance of TimeZoneFormat for the given locale.
static TimeZoneNames	TimeZoneNames.getInstance(ULocale locale)	Returns an instance of TimeZoneNames for the specified locale.
static DateFormat	DateFormat.getInstanceForSkeleton(Calendar cal, String skeleton, ULocale locale)	[icu] Creates a DateFormat object that can be used to format dates and times in the calendar system specified by cal.
static DateFormat	DateFormat.getInstanceForSkeleton(String skeleton, ULocale locale)	[icu] Returns a DateFormat object that can be used to format dates and times in the given locale.
static DateTimePatternGenerator	DateTimePatternGenerator.getInstanceNoStdPat(ULocale uLocale)	Deprecated. This API is ICU internal only.
static NumberFormat	NumberFormat.getIntegerInstance(ULocale inLocale)	NOTE: New users are strongly encouraged to use NumberFormatter instead of NumberFormat.
static String[]	Collator.getKeywordValuesForLocale(String key, ULocale locale, boolean commonlyUsed)	[icu] Given a key and a locale, returns an array of string values in a preferred order that would make a difference.
static BreakIterator	BreakIterator.getLineInstance(ULocale where)	[icu] Returns a new instance of BreakIterator that locates legal line- wrapping positions.
static ScientificNumberFormatter	ScientificNumberFormatter.getMarkupInstance(ULocale locale, String beginMarkup, String endMarkup)	Gets a ScientificNumberFormatter instance that uses markup for exponents for this locale.
static NumberFormat	NumberFormat.getNumberInstance(ULocale inLocale)	NOTE: New users are strongly encouraged to use NumberFormatter instead of NumberFormat.
protected static String	NumberFormat.getPattern(ULocale forLocale, int choice)	Returns the pattern for the provided locale and choice.
static String	NumberFormat.getPatternForStyle(ULocale forLocale, int choice)	Deprecated. This API is ICU internal only.
static String	NumberFormat.getPatternForStyleAndNumberingSystem(ULocale forLocale, String nsName, int choice)	Deprecated. This API is ICU internal only.
static DateFormat	DateFormat.getPatternInstance(Calendar cal, String skeleton, ULocale locale)	[icu] Creates a DateFormat object that can be used to format dates and times in the calendar system specified by cal.
static DateFormat	DateFormat.getPatternInstance(String skeleton, ULocale locale)	[icu] Returns a DateFormat object that can be used to format dates and times in the given locale.
static NumberFormat	NumberFormat.getPercentInstance(ULocale inLocale)	NOTE: New users are strongly encouraged to use NumberFormatter instead of NumberFormat.
static String	MeasureFormat.getRangeFormat(ULocale forLocale, MeasureFormat.FormatWidth width)	Deprecated. This API is ICU internal only.
String	RuleBasedNumberFormat.getRuleSetDisplayName(String ruleSetName, ULocale loc)	Return the rule set display name for the provided rule set and locale.
String[]	RuleBasedNumberFormat.getRuleSetDisplayNames(ULocale loc)	Return the rule set display names for the provided locale.
static NumberFormat	NumberFormat.getScientificInstance(ULocale inLocale)	NOTE: New users are strongly encouraged to use NumberFormatter instead of NumberFormat.
static BreakIterator	BreakIterator.getSentenceInstance(ULocale where)	[icu] Returns a new instance of BreakIterator that locates sentence boundaries.
static ScientificNumberFormatter	ScientificNumberFormatter.getSuperscriptInstance(ULocale locale)	Gets a ScientificNumberFormatter instance that uses superscript characters for exponents for this locale.
static DateFormat	DateFormat.getTimeInstance(int style, ULocale locale)	Returns the time formatter with the given formatting style for the given locale.
static DateFormat	DateFormat.getTimeInstance(Calendar cal, int timeStyle, ULocale locale)	Creates a DateFormat object that can be used to format times in the calendar system specified by cal.
abstract TimeZoneNames	TimeZoneNames.Factory.getTimeZoneNames(ULocale locale)	Deprecated. This API is ICU internal only.
static BreakIterator	BreakIterator.getTitleInstance(ULocale where)	Deprecated. ICU 64 Use BreakIterator.getWordInstance() instead.
static TimeZoneNames	TimeZoneNames.getTZDBInstance(ULocale locale)	Returns an instance of TimeZoneNames containing only short specific zone names (TimeZoneNames.NameType.SHORT_STANDARD and TimeZoneNames.NameType.SHORT_DAYLIGHT), compatible with the IANA tz database's zone abbreviations (not localized).
static BreakIterator	BreakIterator.getWordInstance(ULocale where)	[icu] Returns a new instance of BreakIterator that locates word boundaries.
abstract boolean	PluralRules.Factory.hasOverride(ULocale locale)	Deprecated. This API is ICU internal only.
protected void	ChineseDateFormatSymbols.initializeData(ULocale loc, com.ibm.icu.impl.ICUResourceBundle b, String calendarType)	Deprecated. ICU 50
protected void	DateFormatSymbols.initializeData(ULocale desiredLocale, com.ibm.icu.impl.ICUResourceBundle b, String calendarType)	Deprecated. This API is ICU internal only.
protected void	DateFormatSymbols.initializeData(ULocale desiredLocale, String type)	Initializes format symbols for the locale and calendar type
abstract String	LocaleDisplayNames.localeDisplayName(ULocale locale)	Returns the display name of the provided ulocale.
static Object	BreakIterator.registerInstance(BreakIterator iter, ULocale locale, int kind)	[icu] Registers a new break iterator of the indicated kind, to use in the given locale.
static Object	Collator.registerInstance(Collator collator, ULocale locale)	[icu] Registers a collator as the default collator for the provided locale.
void	CurrencyPluralInfo.setLocale(ULocale loc)	Set locale.
void	MessageFormat.setLocale(ULocale locale)	Sets the locale to be used for creating argument Format objects.
void	PluralFormat.setLocale(ULocale ulocale)	Deprecated. ICU 50 This method clears the pattern and might create a different kind of PluralRules instance; use one of the constructors to create a new instance instead.
TimeUnitFormat	TimeUnitFormat.setLocale(ULocale locale)	Deprecated. ICU 53 see MeasureFormat.

Method parameters in com.ibm.icu.text with type arguments of type ULocale

Modifier and Type	Method	Description
List<LocaleDisplayNames.UiListItem>	LocaleDisplayNames.getUiList(Set<ULocale> localeSet, boolean inSelf, Comparator<Object> collator)	Return a list of information used to construct a UI list of locale names.
abstract List<LocaleDisplayNames.UiListItem>	LocaleDisplayNames.getUiListCompareWholeItems(Set<ULocale> localeSet, Comparator<LocaleDisplayNames.UiListItem> comparator)	Return a list of information used to construct a UI list of locale names, providing more access to control the sorting.
SpoofChecker.Builder	SpoofChecker.Builder.setAllowedLocales(Set<ULocale> locales)	Limit characters that are acceptable in identifiers being checked to those normally used with the languages associated with the specified locales.

Constructors in com.ibm.icu.text with parameters of type ULocale

Constructor	Description
AlphabeticIndex(ULocale locale)	Create the index object.
ChineseDateFormat(String pattern, ULocale locale)	Deprecated. ICU 50
ChineseDateFormat(String pattern, String override, ULocale locale)	Deprecated. ICU 50
ChineseDateFormatSymbols(Calendar cal, ULocale locale)	Deprecated. ICU 50
ChineseDateFormatSymbols(ULocale locale)	Deprecated. ICU 50
CurrencyPluralInfo(ULocale locale)	Create a CurrencyPluralInfo object for the given locale.
DateFormatSymbols(Calendar cal, ULocale locale)	Returns the DateFormatSymbols object that should be used to format a calendar system's dates in the given locale.
DateFormatSymbols(ULocale locale)	[icu] Constructs a DateFormatSymbols object by loading format data from resources for the given ulocale.
DateFormatSymbols(Class<? extends Calendar> calendarClass, ULocale locale)	Variant of DateFormatSymbols(Calendar, ULocale) that takes the Calendar class instead of a Calendar instance.
DateFormatSymbols(ResourceBundle bundle, ULocale locale)	Fetches a custom calendar's DateFormatSymbols out of the given resource bundle.
DateIntervalInfo(ULocale locale)	Construct DateIntervalInfo for the given locale,
DecimalFormatSymbols(ULocale locale)	[icu] Creates a DecimalFormatSymbols object for the given locale.
DurationFormat(ULocale locale)	Deprecated. This API is ICU internal only.
MessageFormat(String pattern, ULocale locale)	Constructs a MessageFormat for the specified locale and pattern.
PluralFormat(ULocale ulocale)	Creates a new cardinal-number PluralFormat for a given locale.
PluralFormat(ULocale ulocale, PluralRules rules)	Creates a new cardinal-number PluralFormat for a given set of rules.
PluralFormat(ULocale ulocale, PluralRules.PluralType type)	Creates a new PluralFormat for the plural type.
PluralFormat(ULocale ulocale, PluralRules.PluralType type, String pattern)	Creates a new PluralFormat for a plural type, a pattern and a locale.
PluralFormat(ULocale ulocale, PluralRules rules, String pattern)	Creates a new cardinal-number PluralFormat for a given set of rules, a pattern and a locale.
PluralFormat(ULocale ulocale, String pattern)	Creates a new cardinal-number PluralFormat for a given pattern string and locale.
RuleBasedNumberFormat(ULocale locale, int format)	Creates a RuleBasedNumberFormat from a predefined description.
RuleBasedNumberFormat(String description, ULocale locale)	Creates a RuleBasedNumberFormat that behaves according to the description passed in.
RuleBasedNumberFormat(String description, String[][] localizations, ULocale locale)	Creates a RuleBasedNumberFormat that behaves according to the description passed in.
SimpleDateFormat(String pattern, DateFormatSymbols formatData, ULocale loc)	Deprecated. This API is ICU internal only.
SimpleDateFormat(String pattern, ULocale loc)	Constructs a SimpleDateFormat using the given pattern and locale.
SimpleDateFormat(String pattern, String override, ULocale loc)	Constructs a SimpleDateFormat using the given pattern , override and locale.
SimpleNumberFormatFactory(ULocale locale)	Constructs a SimpleNumberFormatFactory with the given locale.
SimpleNumberFormatFactory(ULocale locale, boolean visible)	Constructs a SimpleNumberFormatFactory with the given locale and the visibility.
StringSearch(String pattern, CharacterIterator target, ULocale locale)	Initializes the iterator to use the language-specific rules and break iterator rules defined in the argument locale to search for argument pattern in the argument target text.
TimeUnitFormat(ULocale locale)	Deprecated. ICU 53 use MeasureFormat instead.
TimeUnitFormat(ULocale locale, int style)	Deprecated. ICU 53 use MeasureFormat instead.
TimeZoneFormat(ULocale locale)	The protected constructor for subclassing.
UiListItem(ULocale minimized, ULocale modified, String nameInDisplayLocale, String nameInSelf)	Constructor, normally only called internally.

Uses of ULocale in com.ibm.icu.util

Fields in com.ibm.icu.util declared as ULocale

Modifier and Type	Field	Description
static ULocale	ULocale.CANADA	Useful constant for country/region.
static ULocale	ULocale.CANADA_FRENCH	Useful constant for country/region.
static ULocale	ULocale.CHINA	Useful constant for country/region.
static ULocale	ULocale.CHINESE	Useful constant for language.
static ULocale	ULocale.ENGLISH	Useful constant for language.
static ULocale	ULocale.FRANCE	Useful constant for country/region.
static ULocale	ULocale.FRENCH	Useful constant for language.
static ULocale	ULocale.GERMAN	Useful constant for language.
static ULocale	ULocale.GERMANY	Useful constant for country/region.
static ULocale	ULocale.ITALIAN	Useful constant for language.
static ULocale	ULocale.ITALY	Useful constant for country/region.
static ULocale	ULocale.JAPAN	Useful constant for country/region.
static ULocale	ULocale.JAPANESE	Useful constant for language.
static ULocale	ULocale.KOREA	Useful constant for country/region.
static ULocale	ULocale.KOREAN	Useful constant for language.
static ULocale	ULocale.PRC	Useful constant for country/region.
static ULocale	ULocale.ROOT	The root ULocale.
static ULocale	ULocale.SIMPLIFIED_CHINESE	Useful constant for language.
static ULocale	ULocale.TAIWAN	Useful constant for country/region.
static ULocale	ULocale.TRADITIONAL_CHINESE	Useful constant for language.
static ULocale	ULocale.UK	Useful constant for country/region.
static ULocale	ULocale.US	Useful constant for country/region.

Methods in com.ibm.icu.util that return ULocale

Modifier and Type	Method	Description
static ULocale	ULocale.acceptLanguage(ULocale[] acceptLanguageList, boolean[] fallback)	[icu] Based on an ordered array of acceptable locales, determine an available locale for the user.
static ULocale	ULocale.acceptLanguage(ULocale[] acceptLanguageList, ULocale[] availableLocales, boolean[] fallback)	[icu] Based on a list of acceptable locales, determine an available locale for the user.
static ULocale	ULocale.acceptLanguage(String acceptLanguageList, boolean[] fallback)	[icu] Based on a HTTP formatted list of acceptable locales, determine an available locale for the user.
static ULocale	ULocale.acceptLanguage(String acceptLanguageList, ULocale[] availableLocales, boolean[] fallback)	[icu] Based on a HTTP formatted list of acceptable locales, determine an available locale for the user.
static ULocale	ULocale.addLikelySubtags(ULocale loc)	[icu] Adds the likely subtags for a provided locale ID, per the algorithm described in the following CLDR technical report: http://www.unicode.org/reports/tr35/#Likely_Subtags If the provided ULocale instance is already in the maximal form, or there is no data available available for maximization, it will be returned.
ULocale	ULocale.Builder.build()	Returns an instance of ULocale created from the fields set on this builder.
ULocale	LocaleMatcher.canonicalize(ULocale locale)	Partially canonicalizes a locale (language).
ULocale	ULocale.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'.
static ULocale	ULocale.createCanonical(ULocale locale)	Creates a ULocale from the locale by first canonicalizing the locale according to CLDR.
static ULocale	ULocale.createCanonical(String nonCanonicalID)	[icu] Creates a ULocale from the id by first canonicalizing the id according to CLDR.
static ULocale	ULocale.forLanguageTag(String languageTag)	Returns a locale for the specified IETF BCP 47 language tag string.
static ULocale	ULocale.forLocale(Locale loc)	[icu] Returns a ULocale object for a Locale.
static ULocale[]	ULocale.getAvailableLocales()	[icu] Note: Unlike the Locale API, this returns an array of ULocale, not Locale.
static ULocale[]	Calendar.getAvailableULocales()	[icu] Returns the list of locales for which Calendars are installed.
static ULocale[]	Currency.getAvailableULocales()	Return an array of the ulocales for which a currency is defined.
ULocale	LocaleMatcher.getBestMatch(ULocale desiredLocale)	Returns the supported locale which best matches the desired locale.
ULocale	LocaleMatcher.getBestMatch(Iterable<ULocale> desiredLocales)	Returns the supported locale which best matches one of the desired locales.
ULocale	LocaleMatcher.getBestMatch(String desiredLocaleList)	Parses the string like LocalePriorityList does and returns the supported locale which best matches one of the desired locales.
static ULocale	ULocale.getDefault()	Returns the current default ULocale.
static ULocale	ULocale.getDefault(ULocale.Category category)	Returns the current default ULocale for the specified category.
ULocale	LocaleMatcher.Result.getDesiredULocale()	Returns the best-matching desired locale.
ULocale	ULocale.getFallback()	[icu] Returns the fallback locale for this locale.
ULocale	Calendar.FormatConfiguration.getLocale()	Deprecated. This API is ICU internal only.
ULocale	Calendar.getLocale(ULocale.Type type)	[icu] Returns the locale that was used to create this object, or null.
ULocale	GlobalizationPreferences.getLocale(int index)	Convenience function for getting the locales in priority order
ULocale	LocaleMatcher.Result.getSupportedULocale()	Returns the best-matching supported locale.
abstract ULocale	UResourceBundle.getULocale()	[icu] Returns the RFC 3066 conformant locale id of this resource bundle.
ULocale	LocaleMatcher.Result.makeResolvedULocale()	Takes the best-matching supported locale and adds relevant fields of the best-matching desired locale, such as the -t- and -u- extensions.
static ULocale	ULocale.minimizeSubtags(ULocale loc)	[icu] Minimizes the subtags for a provided locale ID, per the algorithm described in the following CLDR technical report: http://www.unicode.org/reports/tr35/#Likely_Subtags If the provided ULocale instance is already in the minimal form, or there is no data available for minimization, it will be returned.
static ULocale	ULocale.minimizeSubtags(ULocale loc, ULocale.Minimize fieldToFavor)	Deprecated. This API is ICU internal only.
ULocale	ULocale.setKeywordValue(String keyword, String value)	[icu] Given a keyword and a value, return a new locale with an updated keyword and value.

Methods in com.ibm.icu.util that return types with arguments of type ULocale

Modifier and Type	Method	Description
static Collection<ULocale>	ULocale.getAvailableLocalesByType(ULocale.AvailableType type)	Returns a list of all installed locales according to the specified type.
List<ULocale>	GlobalizationPreferences.getLocales()	Get a copy of the language/locale priority list
Set<ULocale>	LocalePriorityList.getULocales()	Returns the locales as an immutable Set view.
protected List<ULocale>	GlobalizationPreferences.guessLocales()	This function can be overridden by subclasses to use different heuristics It MUST return a 'safe' value, one whose modification will not affect this object.
Iterator<ULocale>	LocalePriorityList.iterator()
protected List<ULocale>	GlobalizationPreferences.processLocales(List<ULocale> inputLocales)	Process a language/locale priority list specified via setLocales.

Methods in com.ibm.icu.util with parameters of type ULocale

Modifier and Type	Method	Description
static ULocale	ULocale.acceptLanguage(ULocale[] acceptLanguageList, boolean[] fallback)	[icu] Based on an ordered array of acceptable locales, determine an available locale for the user.
static ULocale	ULocale.acceptLanguage(ULocale[] acceptLanguageList, ULocale[] availableLocales, boolean[] fallback)	[icu] Based on a list of acceptable locales, determine an available locale for the user.
static ULocale	ULocale.acceptLanguage(String acceptLanguageList, ULocale[] availableLocales, boolean[] fallback)	[icu] Based on a HTTP formatted list of acceptable locales, determine an available locale for the user.
static LocalePriorityList.Builder	LocalePriorityList.add(ULocale... locales)	Creates a Builder and adds locales, each with weight 1.0.
static LocalePriorityList.Builder	LocalePriorityList.add(ULocale locale, double weight)	Creates a Builder and adds a locale with a specified weight.
LocalePriorityList.Builder	LocalePriorityList.Builder.add(ULocale locale)	Adds a locale with weight 1.0.
LocalePriorityList.Builder	LocalePriorityList.Builder.add(ULocale... locales)	Adds locales, each with weight 1.0.
LocalePriorityList.Builder	LocalePriorityList.Builder.add(ULocale locale, double weight)	Adds a locale with a specified weight.
static ULocale	ULocale.addLikelySubtags(ULocale loc)	[icu] Adds the likely subtags for a provided locale ID, per the algorithm described in the following CLDR technical report: http://www.unicode.org/reports/tr35/#Likely_Subtags If the provided ULocale instance is already in the maximal form, or there is no data available available for maximization, it will be returned.
LocaleMatcher.Builder	LocaleMatcher.Builder.addSupportedULocale(ULocale locale)	Adds another supported locale.
ULocale	LocaleMatcher.canonicalize(ULocale locale)	Partially canonicalizes a locale (language).
int	ULocale.compareTo(ULocale other)	Compares two ULocale for ordering.
static ULocale	ULocale.createCanonical(ULocale locale)	Creates a ULocale from the locale by first canonicalizing the locale according to CLDR.
static TimeZone	TimeZone.forULocaleOrDefault(ULocale locale)	Deprecated. This API is ICU internal only.
static String[]	Currency.getAvailableCurrencyCodes(ULocale loc, Date d)	Returns an array of Strings which contain the currency identifiers that are valid for the given locale on the given date.
ULocale	LocaleMatcher.getBestMatch(ULocale desiredLocale)	Returns the supported locale which best matches the desired locale.
LocaleMatcher.Result	LocaleMatcher.getBestMatchResult(ULocale desiredLocale)	Returns the best match between the desired locale and the supported locales.
static UResourceBundle	UResourceBundle.getBundleInstance(ULocale locale)	[icu] Creates a UResourceBundle for the locale specified, from which users can extract resources by using their corresponding keys.
static UResourceBundle	UResourceBundle.getBundleInstance(String baseName, ULocale locale)	[icu] Creates a UResourceBundle, from which users can extract resources by using their corresponding keys.
static UResourceBundle	UResourceBundle.getBundleInstance(String baseName, ULocale locale, ClassLoader loader)	[icu] Creates a UResourceBundle, from which users can extract resources by using their corresponding keys. Note: Please use this API for loading non-ICU resources.
static String	Calendar.getDateAtTimePattern(Calendar cal, ULocale uLocale, int dateStyle)	Deprecated. This API is ICU internal only.
DateFormat	Calendar.getDateTimeFormat(int dateStyle, int timeStyle, ULocale loc)	[icu] Returns a DateFormat appropriate to this calendar.
static String	Calendar.getDateTimePattern(Calendar cal, ULocale uLocale, int dateStyle)	Deprecated. This API is ICU internal only.
String	ULocale.getDisplayCountry(ULocale displayLocale)	Returns this locale's country localized for display in the provided locale.
static String	ULocale.getDisplayCountry(String localeID, ULocale displayLocale)	[icu] Returns a locale's country localized for display in the provided locale.
static String	ULocale.getDisplayKeyword(String keyword, ULocale displayLocale)	[icu] Returns a keyword localized for display in the specified locale.
String	ULocale.getDisplayKeywordValue(String keyword, ULocale displayLocale)	[icu] Returns a keyword value localized for display in the specified locale.
static String	ULocale.getDisplayKeywordValue(String localeID, String keyword, ULocale displayLocale)	[icu] Returns a keyword value localized for display in the specified locale.
String	ULocale.getDisplayLanguage(ULocale displayLocale)	Returns this locale's language localized for display in the provided locale.
static String	ULocale.getDisplayLanguage(String localeID, ULocale displayLocale)	[icu] Returns a locale's language localized for display in the provided locale.
String	ULocale.getDisplayLanguageWithDialect(ULocale displayLocale)	[icu] Returns this locale's language localized for display in the provided locale.
static String	ULocale.getDisplayLanguageWithDialect(String localeID, ULocale displayLocale)	[icu] Returns a locale's language localized for display in the provided locale.
String	Calendar.getDisplayName(ULocale loc)	Returns the name of this calendar in the language of the given locale.
String	Holiday.getDisplayName(ULocale locale)	Return the name of this holiday in the language of the specified locale The name parameter passed to this object's constructor is used as a key to look up the holiday's localized name in a ResourceBundle object named HolidayBundle.
String	TimeZone.getDisplayName(boolean daylight, int style, ULocale locale)	Returns a name of this time zone suitable for presentation to the user in the specified locale.
String	TimeZone.getDisplayName(ULocale locale)	Returns a name of this time zone suitable for presentation to the user in the specified locale.
String	ULocale.getDisplayName(ULocale displayLocale)	Returns this locale name localized for display in the provided locale.
static String	ULocale.getDisplayName(String localeID, ULocale displayLocale)	[icu] Returns the locale ID localized for display in the provided locale.
String	ULocale.getDisplayNameWithDialect(ULocale displayLocale)	[icu] Returns this locale name localized for display in the provided locale.
static String	ULocale.getDisplayNameWithDialect(String localeID, ULocale displayLocale)	[icu] Returns the locale ID localized for display in the provided locale.
String	ULocale.getDisplayScript(ULocale displayLocale)	Returns this locale's script localized for display in the provided locale.
static String	ULocale.getDisplayScript(String localeID, ULocale displayLocale)	[icu] Returns a locale's script localized for display in the provided locale.
String	ULocale.getDisplayScriptInContext(ULocale displayLocale)	Deprecated. This API is ICU internal only.
static String	ULocale.getDisplayScriptInContext(String localeID, ULocale displayLocale)	Deprecated. This API is ICU internal only.
String	ULocale.getDisplayVariant(ULocale displayLocale)	Returns this locale's variant localized for display in the provided locale.
static String	ULocale.getDisplayVariant(String localeID, ULocale displayLocale)	[icu] Returns a locale's variant localized for display in the provided locale.
static UnicodeSet	LocaleData.getExemplarSet(ULocale locale, int options)	Returns the set of exemplar characters for a locale.
static UnicodeSet	LocaleData.getExemplarSet(ULocale locale, int options, int extype)	Returns the set of exemplar characters for a locale.
static Holiday[]	Holiday.getHolidays(ULocale locale)
static Calendar	Calendar.getInstance(TimeZone zone, ULocale locale)	Returns a calendar with the specified time zone and locale.
static Calendar	Calendar.getInstance(ULocale locale)	Returns a calendar using the default time zone and specified locale.
static Currency	Currency.getInstance(ULocale locale)	Returns a currency object for the default currency in the given locale.
static GenderInfo	GenderInfo.getInstance(ULocale uLocale)	Deprecated. This API is ICU internal only.
static LocaleData	LocaleData.getInstance(ULocale locale)	Gets the LocaleData object associated with the ULocale specified in locale
static String[]	Calendar.getKeywordValuesForLocale(String key, ULocale locale, boolean commonlyUsed)	[icu] Given a key and a locale, returns an array of string values in a preferred order that would make a difference.
static String[]	Currency.getKeywordValuesForLocale(String key, ULocale locale, boolean commonlyUsed)	Given a key and a locale, returns an array of values for the key for which data exists.
static LocaleData.MeasurementSystem	LocaleData.getMeasurementSystem(ULocale locale)	Returns the measurement system used in the locale specified by the locale.
String	Currency.getName(ULocale locale, int nameStyle, boolean[] isChoiceFormat)	Returns the display name for the given currency in the given locale.
String	Currency.getName(ULocale locale, int nameStyle, String pluralCount, boolean[] isChoiceFormat)	Returns the display name for the given currency in the given locale.
static LocaleData.PaperSize	LocaleData.getPaperSize(ULocale locale)	Returns the size of paper used in the locale.
static com.ibm.icu.impl.TextTrieMap<Currency.CurrencyStringInfo>	Currency.getParsingTrie(ULocale locale, int type)	Deprecated. This API is ICU internal only.
static String	ULocale.getRegionForSupplementalData(ULocale locale, boolean inferRegion)	Deprecated. This API is ICU internal only.
String	Currency.getSymbol(ULocale uloc)	Convenience and compatibility override of getName that requests the symbol name.
Double	LocalePriorityList.getWeight(ULocale locale)	Returns the weight for a given language/locale, or null if there is none.
protected DateFormat	Calendar.handleGetDateFormat(String pattern, ULocale locale)	Creates a DateFormat appropriate to this calendar.
protected DateFormat	Calendar.handleGetDateFormat(String pattern, String override, ULocale locale)	Creates a DateFormat appropriate to this calendar.
protected DateFormat	ChineseCalendar.handleGetDateFormat(String pattern, String override, ULocale locale)	Creates a DateFormat appropriate to this calendar.
boolean	LocaleMatcher.isMatch(ULocale desired, ULocale supported)	Returns true if the pair of locales matches acceptably.
double	LocaleMatcher.match(ULocale desired, ULocale desiredMax, ULocale supported, ULocale supportedMax)	Deprecated. ICU 65 Build and use a matcher rather than comparing pairs of locales.
static ULocale	ULocale.minimizeSubtags(ULocale loc)	[icu] Minimizes the subtags for a provided locale ID, per the algorithm described in the following CLDR technical report: http://www.unicode.org/reports/tr35/#Likely_Subtags If the provided ULocale instance is already in the minimal form, or there is no data available for minimization, it will be returned.
static ULocale	ULocale.minimizeSubtags(ULocale loc, ULocale.Minimize fieldToFavor)	Deprecated. This API is ICU internal only.
static String	Currency.parse(ULocale locale, String text, int type, ParsePosition pos)	Deprecated. This API is ICU internal only.
static Object	Currency.registerInstance(Currency currency, ULocale locale)	Registers a new currency for the provided locale.
static void	ULocale.setDefault(ULocale newLocale)	Sets the default ULocale.
static void	ULocale.setDefault(ULocale.Category category, ULocale newLocale)	Sets the default ULocale for the specified Category.
LocaleMatcher.Builder	LocaleMatcher.Builder.setDefaultULocale(ULocale defaultLocale)	Sets the default locale; if null, or if it is not set explicitly, then the first supported locale is used as the default locale.
GlobalizationPreferences	GlobalizationPreferences.setLocale(ULocale uLocale)	Convenience routine for setting the language/locale priority list from a single locale/language.
ULocale.Builder	ULocale.Builder.setLocale(ULocale locale)	Resets the Builder to match the provided locale.
GlobalizationPreferences	GlobalizationPreferences.setLocales(ULocale[] uLocales)	Convenience routine for setting the language/locale priority list from an array.
LocaleMatcher.Builder	LocaleMatcher.Builder.setMaxDistance(ULocale desired, ULocale supported)	Sets the maximum distance for an acceptable match.

Method parameters in com.ibm.icu.util with type arguments of type ULocale

Modifier and Type	Method	Description
ULocale	LocaleMatcher.getBestMatch(Iterable<ULocale> desiredLocales)	Returns the supported locale which best matches one of the desired locales.
LocaleMatcher.Result	LocaleMatcher.getBestMatchResult(Iterable<ULocale> desiredLocales)	Returns the best match between the desired and supported locales.
protected List<ULocale>	GlobalizationPreferences.processLocales(List<ULocale> inputLocales)	Process a language/locale priority list specified via setLocales.
GlobalizationPreferences	GlobalizationPreferences.setLocales(List<ULocale> inputLocales)	Sets the language/locale priority list.
LocaleMatcher.Builder	LocaleMatcher.Builder.setSupportedULocales(Collection<ULocale> locales)	Copies the supported locales, preserving iteration order.

Constructors in com.ibm.icu.util with parameters of type ULocale

Constructor	Description
BuddhistCalendar(TimeZone zone, ULocale locale)	Constructs a BuddhistCalendar based on the current time in the given time zone with the given locale.
BuddhistCalendar(ULocale locale)	Constructs a BuddhistCalendar based on the current time in the default time zone with the given locale.
Calendar(TimeZone zone, ULocale locale)	Constructs a calendar with the specified time zone and locale.
ChineseCalendar(TimeZone zone, ULocale locale)	Construct a ChineseCalendar based on the current time with the given time zone with the given locale.
ChineseCalendar(TimeZone zone, ULocale locale, TimeZone zoneAstroCalc)	Deprecated. This API is ICU internal only.
ChineseCalendar(ULocale locale)	Constructs a ChineseCalendar based on the current time in the default time zone with the given locale.
CopticCalendar(TimeZone zone, ULocale locale)	Constructs a CopticCalendar based on the current time in the given time zone with the given locale.
CopticCalendar(ULocale locale)	Constructs a CopticCalendar based on the current time in the default time zone with the given locale.
DangiCalendar(TimeZone zone, ULocale locale)	Deprecated. This API is ICU internal only.
EthiopicCalendar(TimeZone zone, ULocale locale)	Constructs a EthiopicCalendar based on the current time in the given time zone with the given locale.
EthiopicCalendar(ULocale locale)	Constructs a EthiopicCalendar based on the current time in the default time zone with the given locale.
GregorianCalendar(TimeZone zone, ULocale locale)	Constructs a GregorianCalendar based on the current time in the given time zone with the given locale.
GregorianCalendar(ULocale locale)	[icu] Constructs a GregorianCalendar based on the current time in the default time zone with the given locale.
HebrewCalendar(TimeZone zone, ULocale locale)	Constructs a HebrewCalendar based on the current time in the given time zone with the given locale.
HebrewCalendar(ULocale locale)	Constructs a HebrewCalendar based on the current time in the default time zone with the given locale.
IndianCalendar(TimeZone zone, ULocale locale)	Constructs a IndianCalendar based on the current time in the given time zone with the given locale.
IndianCalendar(ULocale locale)	Constructs a IndianCalendar based on the current time in the default time zone with the given locale.
IslamicCalendar(TimeZone zone, ULocale locale)	Constructs an IslamicCalendar based on the current time in the given time zone with the given locale.
IslamicCalendar(ULocale locale)	Constructs an IslamicCalendar based on the current time in the default time zone with the given locale.
JapaneseCalendar(TimeZone zone, ULocale locale)	Constructs a JapaneseCalendar based on the current time in the given time zone with the given locale.
JapaneseCalendar(ULocale locale)	Constructs a JapaneseCalendar based on the current time in the default time zone with the given locale.
PersianCalendar(TimeZone zone, ULocale locale)	Deprecated. This API is ICU internal only.
PersianCalendar(ULocale locale)	Deprecated. This API is ICU internal only.
TaiwanCalendar(TimeZone zone, ULocale locale)	Constructs a TaiwanCalendar based on the current time in the given time zone with the given locale.
TaiwanCalendar(ULocale locale)	Constructs a TaiwanCalendar based on the current time in the default time zone with the given locale.