|
Oracle® Database Globalization Development Kit Java API Reference 10g Release 2 (10.2) Part No. B14224-02 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--oracle.i18n.util.OraLocaleInfo
The OraLocaleInfo
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 the
OraDisplayLocaleInfo
class to provide localized
names for the various attributes.
Method Summary | |
Object |
clone()
Overrides the clone method. |
boolean |
equals(Object obj)
Overrides the equals 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 this OraLocaleInfo instance. |
static String |
getCurrencySymbol(String iso4217code)
Returns the currency symbol based on the given ISO 4217 code. |
static oracle.i18n.util.OraLocaleInfo |
getDefault()
Returns the default OraLocaleInfo instance based on
the Oracle default locale. |
static oracle.i18n.util.OraLocaleInfo |
getInstance(Locale locale)
Retrieves an instance of the OraLocaleInfo object for the given Java Locale object. |
static oracle.i18n.util.OraLocaleInfo |
getInstance(String language,
String territory)
Retrieves an instance of the OraLocaleInfo object for the given language and territory. |
static oracle.i18n.util.OraLocaleInfo |
getInstance(String language,
String territory,
String linguisticSort)
Retrieves an instance of the OraLocaleInfo object for the given language, territory and sort parameter. |
String |
getLanguage()
Returns the Oracle language name for this OraLocaleInfo
instance. |
String |
getLinguisticSort()
Returns the Oracle linguistic sorting name for this OraLocaleInfo instance. |
String[] |
getLocalCharacterSets()
Returns the common Oracle character sets based on the language of this OraLocaleInfo instance. |
String[] |
getLocalCharacterSets(int platform)
Returns the common Oracle character sets based on the language of this OraLocaleInfo 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 this OraLocaleInfo instance. |
static String[] |
getLocalCurrencies(String territory)
Returns the common ISO 4217 currency codes based on the given territory. |
Locale |
getLocale()
Returns the Java Locale corresponding to this object. |
static Locale |
getLocaleFromString(String localestring)
Retrieves a Java Locale object that maps to the ISO
locale string.
|
String[] |
getLocalLanguages()
Returns the common Oracle languages based on the territory of this OraLocaleInfo 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 this OraLocaleInfo 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 this OraLocaleInfo 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 this OraLocaleInfo instance. |
static TimeZone[] |
getLocalTimeZones(String territory)
Returns the common time zone list for the given Oracle territory. |
String |
getShortLanguage()
Returns Oracle short language name for this OraLocaleInfo
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 this OraLocaleInfo
instance. |
int |
getWritingDirection()
Returns the Oracle writing direction for this OraLocaleInfo
instance. |
int |
hashCode()
Overrides the hashCode method. |
String |
toString()
Returns the string representation of this OraLocaleInfo
instance. |
Methods inherited from class java.lang.Object |
finalize, getClass, notify, notifyAll, wait, wait, wait |
Method Detail |
public static oracle.i18n.util.OraLocaleInfo getInstance(String language, String territory, String linguisticSort)
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
OraLocaleInfo
instance
IllegalStateException
- if the linguistic sort definition is
brokenpublic static oracle.i18n.util.OraLocaleInfo getInstance(String language, String territory)
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
OraLocaleInfo
instancepublic static oracle.i18n.util.OraLocaleInfo getInstance(Locale locale)
Locale
object.
locale
- Java Locale
object
OraLocaleInfo
instancepublic Locale getLocale()
Locale
corresponding to this object.
Locale
public String getLanguage()
OraLocaleInfo
instance.
public String getTerritory()
OraLocaleInfo
instance.
public String getLinguisticSort()
OraLocaleInfo
instance.
public int getWritingDirection()
OraLocaleInfo
instance.
0 = LEFT to RIGHT, 1=RIGHT to LEFT
public String getShortLanguage()
OraLocaleInfo
instance.
public String[] getLocalCharacterSets()
OraLocaleInfo
instance. The return strings are in English.
Using the string, you can use the
OraDisplayLocaleInfo.getDisplayCharacterSet
method to find
its translation.
Note the common character sets vary among platforms. This method returns the list for Unix platforms.
public String[] getLocalCharacterSets(int platform)
OraLocaleInfo
instance. The return strings are in English.
Using the string, you can use the
OraDisplayLocaleInfo.getDisplayCharacterSet
method to find
its translation.
Note the common character sets vary among platforms.
platform
- either LocaleMapper.UNIX
or
LocaleMapper.WINDOWS
to
specify the platform
public static String[] getLocalCharacterSets(String language)
OraDisplayLocaleInfo.getDisplayCharacterSet
method to find
its translation.
Note the common character sets vary among platforms. This method returns the list for Unix platforms.
language
- the Oracle language name
public static String[] getLocalCharacterSets(String language, int platform)
OraDisplayLocaleInfo.getDisplayCharacterSet
method to find
its translation.
Note the common character sets vary among platforms.
language
- the Oracle language nameplatform
- either LocaleMapper.UNIX
or
LocaleMapper.WINDOWS
to
specify the platform
public static String[][] getLocalCommonCharacterSets(String language)
Note the common character sets vary among platforms. This method detects the platform and returns the corresponding list.
language
- the Oracle language name
public static String[] getLocalLinguisticSorts(String language)
OraDisplayLocaleInfo.getDisplayLinguisticSort
method to find
its translation.
language
- the Oracle language name
public String[] getLocalLinguisticSorts()
OraLocaleInfo
instance. The return strings are in English.
Using the string, you can use the
OraDisplayLocaleInfo.getDisplayLinguisticSort
method to find
its translation.
public static String[] getLocalCurrencies(String territory)
OraDisplayLocaleInfo.getDisplayCurrency
method to find
its translation.
territory
- the Oracle territory name
public String[] getLocalCurrencies()
OraLocaleInfo
instance. The return strings are in English.
Using the string, you can use the
OraDisplayLocaleInfo.getDisplayCurrency
method to find its
translation.
public static String getCurrencySymbol(String iso4217code)
iso4217code
- ISO 4217 currency code
public String getCurrencySymbol()
OraLocaleInfo
instance.
public String[] getLocalTerritories()
OraLocaleInfo
instance. The return strings are in English.
Using the string, you can use the
OraDisplayLocaleInfo.getDisplayTerritory
mehtod to find
its translation.
public static String[] getLocalTerritories(String language)
OraDisplayLocaleInfo.getDisplayTerritory
method to find
its translation.
language
- the Oracle language name
public String[] getLocalLanguages()
OraLocaleInfo
instance. The return strings are in English.
Using the string, you can use the
OraDisplayLocaleInfo.getDisplayLanguage
method to find its
translation.
public static String[] getLocalLanguages(String territory)
OraDisplayLocaleInfo.getDisplayLanguage
method to find
its translation.
territory
- the Oracle territory name
public static TimeZone[] getLocalTimeZones(String territory)
territory
- the Oracle territory name
TimeZone
object listpublic TimeZone[] getLocalTimeZones()
OraLocaleInfo
instance.
TimeZone
object listpublic static String[] getAvailableLocale()
<Oracle language>_<Oracle territory>
formpublic static TimeZone[] getCommonTimeZones()
TimeZone
object listpublic static String[] getCommonTimeZoneIDs()
public static Locale[] getCommonLocales()
Locale
object listpublic static Locale[] getCommonLocales(Locale translocale)
translocale
- the translation locale
Locale
object listpublic static String[] getAvailableLanguages()
public static String[][] getAvailableLanguages(Locale translocale)
translocale
- the translation locale
public static String[] getAvailableTerritories()
public static String[][] getAvailableTerritories(Locale translocale)
translocale
- the translation locale
public static String[] getAvailableCharacterSets()
public static String[] getAvailableCurrencies()
public static String[] getAvailableLinguisticSorts()
public static String[] getAvailableDBCharacterSets()
public static String[] getAvailableNationalCharacterSets()
public int getStartDayOfTheWeek()
public static int getStartDayOfTheWeek(String territory)
territory
- the Oracle territory name
public static int getStartDayOfTheWeek(String language, String territory)
language
- the Oracle language nameterritory
- the Oracle territory name
public Object clone()
clone
method.
clone
in class Object
OraLocaleInfo
instance
IllegalStateException
- if the OraCollator
object
is invalidpublic boolean equals(Object obj)
equals
method.
equals
in class Object
obj
- a target object to compare
true
if equal or false
if notpublic static oracle.i18n.util.OraLocaleInfo getDefault()
OraLocaleInfo
instance based on
the Oracle default locale.
OraLocaleInfo
instancepublic String toString()
OraLocaleInfo
instance.
toString
in class Object
public int hashCode()
hashCode
method.
hashCode
in class Object
public static Locale getLocaleFromString(String localestring)
Locale
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.
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 "_
".
Locale
object
|
Oracle® Database Globalization Development Kit Java API Reference 10g Release 2 (10.2) Part No. B14224-02 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |