Package oracle.i18n.util
Class OraLocaleInfo
- java.lang.Object
-
- oracle.i18n.util.OraLocaleInfo
-
public class OraLocaleInfo extends Object
TheOraLocaleInfo
is a utility class that provides locale related information regarding locale attributes like language, territory, character set, timezone, collators, etc... Additionally it exposes methods that provide lists for available and common locale attributes. This class can be used in conjunction with theOraDisplayLocaleInfo
class to provide localized names for the various attributes.- Since:
- 10.1.0.2
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description Object
clone()
Overrides theclone
method.boolean
equals(Object obj)
Overrides theequals
method.static String[]
getAvailableCharacterSets()
Returns a list of the available Oracle character sets.static String[]
getAvailableCurrencies()
Returns a list of the available ISO 4217 currencies.static String[]
getAvailableDBCharacterSets()
Returns a list of the available database character set names depending on whether the platform is ascii-based or ebcdic-based.static String[]
getAvailableLanguages()
Returns a list of the available Oracle languages, i.e. languages supported by the GDK.static String[][]
getAvailableLanguages(Locale translocale)
Returns the available language IDs along with their corresponding display names sorted in the translated display name order.static String[]
getAvailableLinguisticSorts()
Returns a list of the available Oracle linguistic sorts.static String[]
getAvailableLocale()
Returns the available Oracle locale list.static String[]
getAvailableNationalCharacterSets()
Returns a list of the available national character sets.static String[]
getAvailableTerritories()
Returns a list of the available Oracle territories.static String[][]
getAvailableTerritories(Locale translocale)
Returns the available territory IDs along with their corresponding display names sorted in the display name order.static Locale[]
getCommonLocales()
Returns the common locale list, i.e. locales that are commonly used.static Locale[]
getCommonLocales(Locale translocale)
Returns the common locale list that is sorted based on the given translation locale.static String[]
getCommonTimeZoneIDs()
Returns the common time zone IDs in an array.static TimeZone[]
getCommonTimeZones()
Returns the common time zone list.String
getCurrencySymbol()
Returns the currency symbol for thisOraLocaleInfo
instance.static String
getCurrencySymbol(String iso4217code)
Returns the currency symbol based on the given ISO 4217 code.static OraLocaleInfo
getDefault()
Returns the defaultOraLocaleInfo
instance based on the Oracle default locale.static OraLocaleInfo
getInstance(String language, String territory)
Retrieves an instance of the OraLocaleInfo object for the given language and territory.static OraLocaleInfo
getInstance(String language, String territory, String linguisticSort)
Retrieves an instance of the OraLocaleInfo object for the given language, territory and sort parameter.static OraLocaleInfo
getInstance(Locale locale)
Retrieves an instance of the OraLocaleInfo object for the given JavaLocale
object.String
getLanguage()
Returns the Oracle language name for thisOraLocaleInfo
instance.String
getLinguisticSort()
Returns the Oracle linguistic sorting name for thisOraLocaleInfo
instance.String[]
getLocalCharacterSets()
Returns the common Oracle character sets based on the language of thisOraLocaleInfo
instance.String[]
getLocalCharacterSets(int platform)
Returns the common Oracle character sets based on the language of thisOraLocaleInfo
instance.static String[]
getLocalCharacterSets(String language)
Returns the common Oracle character sets based on the given language.static String[]
getLocalCharacterSets(String language, int platform)
Returns the common Oracle character sets based on the given language.static String[][]
getLocalCommonCharacterSets(String language)
Returns the common Oracle character sets based on the given language.String[]
getLocalCurrencies()
Returns the common ISO 4217 currency based on the territory of thisOraLocaleInfo
instance.static String[]
getLocalCurrencies(String territory)
Returns the common ISO 4217 currency codes based on the given territory.Locale
getLocale()
Returns the JavaLocale
corresponding to this object.static Locale
getLocaleFromString(String localestring)
Retrieves a JavaLocale
object that maps to the ISO locale string.String[]
getLocalLanguages()
Returns the common Oracle languages based on the territory of thisOraLocaleInfo
instance.static String[]
getLocalLanguages(String territory)
Returns the common Oracle languages based on the given territory.String[]
getLocalLinguisticSorts()
Returns the common linguistic sorts based on the language of thisOraLocaleInfo
instance.static String[]
getLocalLinguisticSorts(String language)
Returns the common linguistic sorts based on the given language.String[]
getLocalTerritories()
Returns the common Oracle territories based on the language of thisOraLocaleInfo
instance.static String[]
getLocalTerritories(String language)
Returns the common Oracle territories based on the given language.TimeZone[]
getLocalTimeZones()
Returns the common time zone list for the territory of thisOraLocaleInfo
instance.static TimeZone[]
getLocalTimeZones(String territory)
Returns the common time zone list for the given Oracle territory.static String[]
getRecommendedDBCharacterSets()
Returns an alphabetically sorted list of the recommended database character set names depending on whether the platform is ASCII-based or EBCDIC-based.String
getShortLanguage()
Returns Oracle short language name for thisOraLocaleInfo
instance.int
getStartDayOfTheWeek()
Returns the start day-of-the-week for the object.static int
getStartDayOfTheWeek(String territory)
Returns the start day of the week for the given Oracle territory for the object.static int
getStartDayOfTheWeek(String language, String territory)
Returns the start day of the week for the given Oracle language and Oracle territory for the object.String
getTerritory()
Returns the Oracle territory name for thisOraLocaleInfo
instance.int
getWritingDirection()
Returns the Oracle writing direction for thisOraLocaleInfo
instance.int
hashCode()
Overrides thehashCode
method.String
toString()
Returns the string representation of thisOraLocaleInfo
instance.
-
-
-
Method Detail
-
getInstance
public static OraLocaleInfo getInstance(String language, String territory, String linguisticSort)
Retrieves an instance of the OraLocaleInfo object for the given language, territory and sort parameter.- Parameters:
language
- the Oracle language name or the ISO language codeterritory
- the Oracle territory name or an ISO country code. The language and territory (country) must either both be Oracle based names or ISO based names. They must not be mixed and matchedlinguisticSort
- the Oracle linguistic sort rule name- Returns:
- an
OraLocaleInfo
instance or null if either language or territory is not a legal name or ISO code - Throws:
IllegalStateException
- if the linguistic sort definition is broken
-
getInstance
public static OraLocaleInfo getInstance(String language, String territory)
Retrieves an instance of the OraLocaleInfo object for the given language and territory. Uses the default sorting rule for this locale.- Parameters:
language
- the Oracle language name or the ISO language codeterritory
- the Oracle territory name or an ISO country code. The language and territory (country) must either both be Oracle based names or ISO based names. They must not be mixed and matched- Returns:
- an
OraLocaleInfo
instance or null if either language or territory is not a legal name or ISO code
-
getInstance
public static OraLocaleInfo getInstance(Locale locale)
Retrieves an instance of the OraLocaleInfo object for the given JavaLocale
object.- Parameters:
locale
- JavaLocale
object- Returns:
- an
OraLocaleInfo
instance
-
getLocale
public Locale getLocale()
Returns the JavaLocale
corresponding to this object.- Returns:
- Java
Locale
-
getLanguage
public String getLanguage()
Returns the Oracle language name for thisOraLocaleInfo
instance.- Returns:
- the Oracle language name
-
getTerritory
public String getTerritory()
Returns the Oracle territory name for thisOraLocaleInfo
instance.- Returns:
- the Oracle territory name
-
getLinguisticSort
public String getLinguisticSort()
Returns the Oracle linguistic sorting name for thisOraLocaleInfo
instance. If the sorting name is "BINARY", it will be suffixed by "-" plus oracle character set name to distinguish among different character sets. This function gets the default value from the language definition directly. But this value is often not valid for some languages. It is recommended to useLocaleMapper.getOraLinguisticSortFromLocale(Locale)
to get the default linguistic sorting name for a locale.- Returns:
- the Oracle linguistic name
-
getWritingDirection
public int getWritingDirection()
Returns the Oracle writing direction for thisOraLocaleInfo
instance.- Returns:
- the writing direction:
0 = LEFT to RIGHT, 1=RIGHT to LEFT
-
getShortLanguage
public String getShortLanguage()
Returns Oracle short language name for thisOraLocaleInfo
instance.- Returns:
- a short Oracle language name
-
getLocalCharacterSets
public String[] getLocalCharacterSets()
Returns the common Oracle character sets based on the language of thisOraLocaleInfo
instance. The return strings are in English. Using the string, you can use theOraDisplayLocaleInfo.getDisplayCharacterSet
method to find its translation.Note the common character sets vary among platforms. This method returns the list for Unix platforms.
- Returns:
- an array of character sets that are commonly used
-
getLocalCharacterSets
public String[] getLocalCharacterSets(int platform)
Returns the common Oracle character sets based on the language of thisOraLocaleInfo
instance. The return strings are in English. Using the string, you can use theOraDisplayLocaleInfo.getDisplayCharacterSet
method to find its translation.Note the common character sets vary among platforms.
- Parameters:
platform
- eitherLocaleMapper.UNIX
orLocaleMapper.WINDOWS
to specify the platform- Returns:
- an array of character sets that are commonly used
-
getLocalCharacterSets
public static String[] getLocalCharacterSets(String language)
Returns the common Oracle character sets based on the given language. The return strings are in English. Using the string, you can use theOraDisplayLocaleInfo.getDisplayCharacterSet
method to find its translation.Note the common character sets vary among platforms. This method returns the list for Unix platforms.
- Parameters:
language
- the Oracle language name- Returns:
- an array of character sets that are commonly used
-
getLocalCharacterSets
public static String[] getLocalCharacterSets(String language, int platform)
Returns the common Oracle character sets based on the given language. The return strings are in English. Using the string, you can use theOraDisplayLocaleInfo.getDisplayCharacterSet
method to find its translation.Note the common character sets vary among platforms.
- Parameters:
language
- the Oracle language nameplatform
- eitherLocaleMapper.UNIX
orLocaleMapper.WINDOWS
to specify the platform- Returns:
- an array of character sets that are commonly used
-
getLocalCommonCharacterSets
public static String[][] getLocalCommonCharacterSets(String language)
Returns the common Oracle character sets based on the given language. The return strings are in English. Using the string, you can use OraDisplayLocaleInfo.getDisplayCharacterSet to find its translation.Note the common character sets vary among platforms. This method detects the platform and returns the corresponding list.
- Parameters:
language
- the Oracle language name- Returns:
- a 2-dimensional array of character sets that are commonly used. The returned array has the structure of: {{ "primary charset", "common charset 2", "common charset 3", ... }, { "primary NCHAR charset", "common NCHAR charset 2", "common NCHAR charset 3", ... }} The first element is an array of common character set names. The first item in this array is the primary character set name, and remaining items are other common character set names. The number of items in this array is probably less than 20 (twenty). The second element is an array of common NCHAR character set names. The first item in this array is the primary NCHAR character set name, and remaining items are other common NCHAR character set names. The number of items in this array is probably only a few.
-
getLocalLinguisticSorts
public static String[] getLocalLinguisticSorts(String language)
Returns the common linguistic sorts based on the given language. The return strings are in English. Using the string, you can use theOraDisplayLocaleInfo.getDisplayLinguisticSort
method to find its translation.- Parameters:
language
- the Oracle language name- Returns:
- an array of linguistic sorting names that are commonly used
-
getLocalLinguisticSorts
public String[] getLocalLinguisticSorts()
Returns the common linguistic sorts based on the language of thisOraLocaleInfo
instance. The return strings are in English. Using the string, you can use theOraDisplayLocaleInfo.getDisplayLinguisticSort
method to find its translation.- Returns:
- an array of linguistic sorting names that are commonly used
-
getLocalCurrencies
public static String[] getLocalCurrencies(String territory)
Returns the common ISO 4217 currency codes based on the given territory. The return strings are in English. Using the string, you can use theOraDisplayLocaleInfo.getDisplayCurrency
method to find its translation.- Parameters:
territory
- the Oracle territory name- Returns:
- ISO currency symbols
-
getLocalCurrencies
public String[] getLocalCurrencies()
Returns the common ISO 4217 currency based on the territory of thisOraLocaleInfo
instance. The return strings are in English. Using the string, you can use theOraDisplayLocaleInfo.getDisplayCurrency
method to find its translation.- Returns:
- ISO 4217 currency codes
-
getCurrencySymbol
public static String getCurrencySymbol(String iso4217code)
Returns the currency symbol based on the given ISO 4217 code.- Parameters:
iso4217code
- ISO 4217 currency code- Returns:
- a currency symbol
-
getCurrencySymbol
public String getCurrencySymbol()
Returns the currency symbol for thisOraLocaleInfo
instance.- Returns:
- a currency symbol
-
getLocalTerritories
public String[] getLocalTerritories()
Returns the common Oracle territories based on the language of thisOraLocaleInfo
instance. The return strings are in English. Using the string, you can use theOraDisplayLocaleInfo.getDisplayTerritory
mehtod to find its translation.- Returns:
- an array of territories that are commonly used
-
getLocalTerritories
public static String[] getLocalTerritories(String language)
Returns the common Oracle territories based on the given language. The return strings are in English. Using the string, you can use theOraDisplayLocaleInfo.getDisplayTerritory
method to find its translation.- Parameters:
language
- the Oracle language name- Returns:
- an array of territories that are commonly used
-
getLocalLanguages
public String[] getLocalLanguages()
Returns the common Oracle languages based on the territory of thisOraLocaleInfo
instance. The return strings are in English. Using the string, you can use theOraDisplayLocaleInfo.getDisplayLanguage
method to find its translation.- Returns:
- an array of languages that are commonly used
-
getLocalLanguages
public static String[] getLocalLanguages(String territory)
Returns the common Oracle languages based on the given territory. The return strings are in English. Using the string, you can use theOraDisplayLocaleInfo.getDisplayLanguage
method to find its translation.- Parameters:
territory
- the Oracle territory name- Returns:
- an array of languages that are commonly used
-
getLocalTimeZones
public static TimeZone[] getLocalTimeZones(String territory)
Returns the common time zone list for the given Oracle territory.- Parameters:
territory
- the Oracle territory name- Returns:
- a common
TimeZone
object list
-
getLocalTimeZones
public TimeZone[] getLocalTimeZones()
Returns the common time zone list for the territory of thisOraLocaleInfo
instance.- Returns:
- a common
TimeZone
object list
-
getAvailableLocale
public static String[] getAvailableLocale()
Returns the available Oracle locale list. Available locales are locales that are supported by the GDK.- Returns:
- a list of Oracle locales in
<Oracle language>_<Oracle territory>
form
-
getCommonTimeZones
public static TimeZone[] getCommonTimeZones()
Returns the common time zone list. This is independent from locales.- Returns:
- a common
TimeZone
object list
-
getCommonTimeZoneIDs
public static String[] getCommonTimeZoneIDs()
Returns the common time zone IDs in an array. This is independent from locales.- Returns:
- a common time zone ID array
-
getCommonLocales
public static Locale[] getCommonLocales()
Returns the common locale list, i.e. locales that are commonly used. The common locale list is a subset of the "available" locales that the GDK supports.- Returns:
- a common Java
Locale
object list
-
getCommonLocales
public static Locale[] getCommonLocales(Locale translocale)
Returns the common locale list that is sorted based on the given translation locale.- Parameters:
translocale
- the translation locale- Returns:
- a common Java
Locale
object list
-
getAvailableLanguages
public static String[] getAvailableLanguages()
Returns a list of the available Oracle languages, i.e. languages supported by the GDK.- Returns:
- an array of Oracle language names
-
getAvailableLanguages
public static String[][] getAvailableLanguages(Locale translocale)
Returns the available language IDs along with their corresponding display names sorted in the translated display name order.- Parameters:
translocale
- the translation locale- Returns:
- a sorted 2-dimensional array of available languages. The returned array has the structure of: {{ "language ID 1", "language ID 2", "language ID 3", ... }, { "display name 1", "display name 2", "display name 3", ... }} The first element is an array of available language IDs sorted based on the order of their translated display names. The second element is an array of the corresponding translated display names. In other words, for the returned array lang[][], lang[0][i] is a language ID and lang[1][i] contains its corresponding translated display name.
-
getAvailableTerritories
public static String[] getAvailableTerritories()
Returns a list of the available Oracle territories.- Returns:
- an array of Oracle territory names
-
getAvailableTerritories
public static String[][] getAvailableTerritories(Locale translocale)
Returns the available territory IDs along with their corresponding display names sorted in the display name order.- Parameters:
translocale
- the translation locale- Returns:
- a sorted 2-dimensional array of available territories. The returned array has the structure of: {{ "territory ID 1", "territory ID 2", "territory ID 3", ... }, { "display name 1", "display name 2", "display name 3", ... }} The first element is an array of available territory IDs sorted based on the order of their translated display names. The second element is an array of the corresponding translated display names. In other words, for the returned array terr[][], terr[0][i] is a territory ID and terr[1][i] contains its corresponding translated display name.
-
getAvailableCharacterSets
public static String[] getAvailableCharacterSets()
Returns a list of the available Oracle character sets.- Returns:
- an array of Oracle character sets
-
getAvailableCurrencies
public static String[] getAvailableCurrencies()
Returns a list of the available ISO 4217 currencies.- Returns:
- an array of ISO 4217 currencies
-
getAvailableLinguisticSorts
public static String[] getAvailableLinguisticSorts()
Returns a list of the available Oracle linguistic sorts.- Returns:
- an array of Oracle linguistic sorts
-
getAvailableDBCharacterSets
public static String[] getAvailableDBCharacterSets()
Returns a list of the available database character set names depending on whether the platform is ascii-based or ebcdic-based.- Returns:
- an array of valid database character sets based on the platform
-
getRecommendedDBCharacterSets
public static String[] getRecommendedDBCharacterSets()
Returns an alphabetically sorted list of the recommended database character set names depending on whether the platform is ASCII-based or EBCDIC-based.- Returns:
- an alphabetically sorted array of recommended database character sets based on the platform
-
getAvailableNationalCharacterSets
public static String[] getAvailableNationalCharacterSets()
Returns a list of the available national character sets.- Returns:
- an array of national character sets
-
getStartDayOfTheWeek
public int getStartDayOfTheWeek()
Returns the start day-of-the-week for the object. It is indicated by a number of 0 through 6.- Returns:
- the start day-of-the-week
-
getStartDayOfTheWeek
public static int getStartDayOfTheWeek(String territory)
Returns the start day of the week for the given Oracle territory for the object. It is indicated by a number of 0 through 6.- Parameters:
territory
- the Oracle territory name- Returns:
- the start day of the week
-
getStartDayOfTheWeek
public static int getStartDayOfTheWeek(String language, String territory)
Returns the start day of the week for the given Oracle language and Oracle territory for the object. It is indicated by a number of 0 through 6.- Parameters:
language
- the Oracle language nameterritory
- the Oracle territory name- Returns:
- the start day of the week
-
clone
public Object clone()
Overrides theclone
method.- Overrides:
clone
in classObject
- Returns:
- a copy of this
OraLocaleInfo
instance - Throws:
IllegalStateException
- if theOraCollator
object is invalid
-
equals
public boolean equals(Object obj)
Overrides theequals
method.
-
getDefault
public static OraLocaleInfo getDefault()
Returns the defaultOraLocaleInfo
instance based on the Oracle default locale.- Returns:
- an
OraLocaleInfo
instance
-
toString
public String toString()
Returns the string representation of thisOraLocaleInfo
instance.
-
hashCode
public int hashCode()
Overrides thehashCode
method.
-
getLocaleFromString
public static Locale getLocaleFromString(String localestring)
Retrieves a JavaLocale
object that maps to the ISO locale string.Either a dash (U+002D) or an underscore (U+005F) can be used to connect ISO 639 and ISO 3166 codes.
- Parameters:
localestring
- the string representing an ISO locale. For example,ja-JP
represents the Japanese language used in Japan. The connector of ISO 639 and ISO 3166 codes can be either "-
" or "_
".- Returns:
- an Java
Locale
object
-
-