oracle.i18n.util
Class OraLocaleInfo

java.lang.Object
  |
  +--oracle.i18n.util.OraLocaleInfo

public class OraLocaleInfo

extends Object

OraLocaleInfo is a Oracle locale class that include the language, territory, and collator objects.

Since:

10.1.0.2

getInstance

public static oracle.i18n.util.OraLocaleInfo getInstance(String language,
String territory,
String linguisticSort)

Constructs a Oracle locale from Oracle language, territory, and sorting rule.

Parameters:

language - Oracle language

linguisticSort - Oracle linguistic sort rule name

Returns:

OraLocaleInfo instance

getInstance

public static oracle.i18n.util.OraLocaleInfo getInstance(String language,
String territory)

Constructs a Oracle locale from Oracle language, territory. Use the default sorting rule for this locale.

Parameters:

language - Oracle or ISO language

Returns:

OraLocaleInfo instance

getInstance

public static oracle.i18n.util.OraLocaleInfo getInstance(Locale locale)

Constructs a Oracle locale from Java Locale object.

Parameters:

locale - Locale object

Returns:

OraLocaleInfo instance

getLocale

public Locale getLocale()

Returns the Java locale corresponding to this object.

Returns:

Java locale

getLanguage

public String getLanguage()

Returns the Oracle language name based on the current OraLocaleInfo

Returns:

the Oracle language name

getTerritory

public String getTerritory()

Returns the Oracle territory name based on the current OraLocaleInfo

Returns:

the Oracle territory name

getLinguisticSort

public String getLinguisticSort()

Returns the Oracle linguistic sorting name based on the current OraLocaleInfo

Returns:

the Oracle linguistic name

getWritingDirection

public int getWritingDirection()

Returns the Oracle writing direction based on the current OracleLocaleInfo

Returns:

the writing direction 0 = LEFT to RIGHT, 1=RIGHT to LEFT.

getShortLanguage

public String getShortLanguage()

Returns Oracle short language name

Returns:

String a short Oracle language name

getLocalCharacterSets

public String[] getLocalCharacterSets()

Returns the common Oracle character sets based on the language of the current OraLocaleInfo. 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 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 the current OraLocaleInfo. 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.

Parameters:

platform - either LocaleMapper.UNIX or LocaleMapper.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 OraDisplayLocaleInfo.getDisplayCharacterSet to find its translation.

Note the common character sets vary among platforms. This method returns the list for Unix platforms.

Parameters:

language - Oracle language

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 OraDisplayLocaleInfo.getDisplayCharacterSet to find its translation.

Note the common character sets vary among platforms.

Parameters:

language - Oracle language

platform - either LocaleMapper.UNIX or LocaleMapper.WINDOWS to specify the platform

Returns:

an array of character sets that are commonly used

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 OraDisplayLocaleInfo.getDisplayLinguisticSort to find its translation.

Parameters:

language - Oracle language

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 the current OraLocaleInfo. The return strings are in English. Using the string, you can use OraDisplayLocaleInfo.getDisplayLinguisticSort 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 based on the given territory. The return strings are in English. Using the string, you can use OraDisplayLocaleInfo.getDisplayCurrency to find its translation.

Parameters:

territory - Oracle territory

Returns:

ISO currency symbols

getLocalCurrencies

public String[] getLocalCurrencies()

Returns the common ISO 4217 currency based on the territory of the current OraLocaleInfo. The return strings are in English. Using the string, you can use OraDisplayLocaleInfo.getDisplayCurrency to find its translation.

Returns:

ISO 4217 currency codes

getCurrencySymbol

public static String getCurrencySymbol(String iso4217code)

Returns the currency symbol based on the given ISO4217 code

Parameters:

iso4217code - ISO 4217 currency code

Returns:

a currency symbol

getCurrencySymbol

public String getCurrencySymbol()

Returns the currency symbol based on the current OraLocaleInfo

Returns:

a currency symbol

getLocalTerritories

public String[] getLocalTerritories()

Returns the common Oracle territories based on the language of the current OraLocaleInfo. The return strings are in English. Using the string, you can use OraDisplayLocaleInfo.getDisplayTerritory 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 OraDisplayLocaleInfo.getDisplayTerritory to find its translation.

Parameters:

language - Oracle language

Returns:

an array of territories that are commonly used.

getLocalLanguages

public String[] getLocalLanguages()

Returns the common Oracle languages based on the territory of the current OraLocaleInfo. The return strings are in English. Using the string, you can use OraDisplayLocaleInfo.getDisplayLanguage 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 OraDisplayLocaleInfo.getDisplayLanguage to find its translation.

Parameters:

territory - Oracle territory

Returns:

an array of languages that are commonly used

getLocalTimeZones

public static TimeZone[] getLocalTimeZones(String territory)

Returns the common TimeZone list for the territory of the current OraLocaleInfo.

Returns:

a common TimeZone object list.

getLocalTimeZones

public TimeZone[] getLocalTimeZones()

Returns the common TimeZone list for the territory of the current OraLocaleInfo.

Returns:

a common TimeZone object list.

getAvailableLocale

public static String[] getAvailableLocale()

Returns the availabe Oracle Locale list.

Returns:

a list of Oracle locale in lang_terr pairs.

getCommonTimeZones

public static TimeZone[] getCommonTimeZones()

Returns the common TimeZone 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 Locales list.

Returns:

a common Locale object list.

getAvailableLanguages

public static String[] getAvailableLanguages()

Returns a list of the available Oracle languages

Returns:

an array of Oracle languages

getAvailableTerritories

public static String[] getAvailableTerritories()

Returns a list of the available Oracle territories

Returns:

an array of Oracle territories

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

getStartDayOfTheWeek

public int getStartDayOfTheWeek()

Returns the start day of the week for the object. It is indicated as a number of 0 ~ 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 as a number of 0 ~ 6.

Parameters:

territory - the given 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 as a number of 0 ~ 6.

Parameters:

language - the given Oracle language name.

territory - the given Oracle territory name.

Returns:

the start day of the week.

clone

public Object clone()

Returns a copy of this instance

Overrides:

clone in class Object

Returns:

a copy of OraLocaleInfo

equals

public boolean equals(Object obj)

Returns true if this OraLocaleInfo object is equals to another

Overrides:

equals in class Object

Parameters:

obj - a target object to compare

Returns:

true if equal or false if not.

getDefault

public static oracle.i18n.util.OraLocaleInfo getDefault()

Returns the default OraLocaleInfo object based on the Java default locale

Returns:

OraLocaleInfo object.

toString

public String toString()

Returns the string representation of OraLocaleInfo

Overrides:

toString in class Object

Returns:

a string

hashCode

public int hashCode()

Returns a hash value of the OraLocaleInfo.

Overrides:

hashCode in class Object

Returns:

a hash value

getLocaleFromString

public static Locale getLocaleFromString(String localestring)

Constructs a Locale object from the ISO locale string.

Either a dash (U+002d) or a underbar (U+005f) can be used to connect ISO 639 and ISO 3166 elements.

Parameters:

localestring - the string representing a ISO locale. For example, ja-JP represents Japanese language used in Japan. The connector of ISO 639 and ISO 3166 can be either "-" or "_".

Returns:

the generated Localeobject.