java.util
클래스 Locale

java.lang.Object 
  |
  +--java.util.Locale

모든 구현 인터페이스:

Cloneable , Serializable

public final class Locale

extends Object

implements Cloneable , Serializable

Locale 오브젝트는 특정의 지리적, 국가적, 또는 문화적 지역을 나타내기 위한 것입니다. 어느 조작으로 Locale 를 필요로 하는 태스크가 있는 경우, 그 조작을 로케일에 의존하는 조작이라고 합니다. 이 경우, 정보는 Locale 에 의해 유저에 맞추어 조정됩니다. 예를 들어, 수치를 표시하는 것은 로케일에 의존하는 조작입니다. 이 수치는 유저의 나라나 지역, 문화의 습관이나 규칙에 따라 포맷 할 필요가 있습니다.

Locale 오브젝트를 작성하려면 , 이 클래스의 constructor를 사용합니다.

 Locale(String language)
 Locale(String language, String country)
 Locale(String language, String country, String variant)

언어의 인수는 유효한 ISO 언어 코드입니다. 이러한 코드는 ISO-639 로 정의되는 2 자리수의 소문자입니다. 코드의 완전한 리스트는
http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt 를 시작해 몇개의 장소에서 입수할 수 있습니다.

나라의 인수는 유효한 ISO 국 코드입니다. 이러한 코드는 ISO-3166 로 정의되는 2 자리수의 대문자입니다. 코드의 완전한 리스트는
http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html 를 시작해 몇개의 장소에서 입수할 수 있습니다.

변형의 인수는 벤더 또는 브라우저에 고유의 코드입니다. 예를 들어, Windows 에는 WIN, Macintosh 에는 MAC, POSIX 에는 POSIX 를 사용합니다. 변형이 2 개 있는 경우에는 그것들을 밑줄로 단락지어, 중요한 것을 최초로 지정합니다. 예를 들어, Traditional Spanish (에스파니아어)의 조합을 사용하는 경우는 언어, 나라, 변형의 파라미터로서 「es」, 「ES」, 및 「Traditional_WIN」를 지정해 로케일을 구축합니다.

Locale 오브젝트는 어느 지역을 나타내는 단순한 식별자이므로,Locale 를 구축할 때, 그것이 타당한가 어떤가의 검사는 행해지지 않습니다. 구축하는 Locale 에 대해 특정의 리소스가 있을지 어떨지를 조사하려면 , 이러한 리소스의 조회를 실시할 필요가 있습니다. 예를 들어,NumberFormat 에, 그 getAvailableLocales 메소드를 사용해, 그것이 서포트하는 로케일을 조회합니다.
주: 특정의 로케일의 리소스에 대해 조회하면(자), 사용 가능한 그 중에서 와도 자주(잘) 일치하는 것이 돌려주어집니다. 요구에 완전하게 적합한다고는 할 수 없습니다. 자세한 것은 ResourceBundle 를 참조해 주세요.

Locale 클래스에는 몇개의 편리한 정수가 있으므로, 이것들을 사용해, 자주(잘) 사용되는 로케일의 Locale 오브젝트를 작성할 수가 있습니다. 예를 들어, 다음의 예는 미국의 Locale 오브젝트를 작성하는 예입니다.

 Locale.US

Locale 를 작성한 뒤는 이 오브젝트에 그것 자신의 정보를 조회할 수가 있습니다. ISO 국 코드를 얻으려면 getCountry 를, ISO 언어 코드를 얻으려면 getLanguage 를 각각 사용합니다. getDisplayCountry 를 사용하면, 적합한 국명이 유저에게 표시됩니다. 똑같이,getDisplayLanguage 를 사용하면, 적합한 언어의 이름이 유저에게 표시됩니다. 흥미로운 것에,getDisplayXXX 메소드 자체도 로케일에 의존합니다. 이것에는 2 개의 버젼이 있어, 한편은 디폴트의 로케일을 사용해, 한편은 인수로서 지정된 로케일을 사용합니다.

Java 2 플랫폼에는 로케일에 의존하는 조작을 실시하는 몇개의 클래스가 있습니다. 예를 들어,NumberFormat 클래스는 수치나 통화, 퍼센트를 로케일에 의존하는 형태로 포맷 합니다. NumberFormat 등의 클래스에는 이 형태의 오브젝트를 작성하기 위한 간이 메소드가 몇개인가 있습니다. 예를 들어,NumberFormat 클래스에는 디폴트의 NumberFormat 오브젝트를 작성하기 위해서 다음의 3 개의 메소드가 있습니다.

 NumberFormat.getInstance()
 NumberFormat.getCurrencyInstance()
 NumberFormat.getPercentInstance()

이러한 메소드에는 2 개의 변형이 있습니다. 명시적인 로케일을 가지는 것과 가지지 않는 것입니다. 후자의 경우는 디폴트 로케일이 사용됩니다.

 NumberFormat.getInstance(myLocale)
 NumberFormat.getCurrencyInstance(myLocale)
 NumberFormat.getPercentInstance(myLocale)

Locale 는 어느 오브젝트 (NumberFormat)를 사용하는지를 지정하기 위한 기구입니다. 로케일은 오브젝트를 지정하기 위한 단순한 기구이며, 오브젝트 자체의 컨테이너가 아닙니다.

로케일에 의존하는 조작을 실시하는 클래스에서는 그 형태를 가지는 사용 가능한 모든 오브젝트를 얻을 수 있습니다. 이러한 오브젝트를 언어나 나라, 변형에 의해 선별해, 그러한 표시명을 사용해 메뉴를 유저에게 표시할 수가 있습니다. 예를 들어, 어느 언어에 적절한 모든 조합 오브젝트를 나타내는 메뉴를 작성할 수가 있습니다. 이러한 클래스에는 다음에 나타내는 3 개의 클래스 메소드의 구현이 필요합니다.

 public static Locale[] getAvailableLocales()
 public static String getDisplayName(Locale objectLocale,
                                     Locale displayLocale)
 public static final String getDisplayName(Locale objectLocale)
     // getDisplayName will throw MissingResourceException if the locale
     // is not one of the available locales.
 

도입된 버젼:

1.1

관련 항목:

ResourceBundle , Format , NumberFormat , Collator , 직렬화 된 형식

필드의 개요

static Locale	CANADA 나라에 사용하는 정수입니다.
static Locale	CANADA_FRENCH 나라에 사용하는 정수입니다.
static Locale	CHINA 나라에 사용하는 정수입니다.
static Locale	CHINESE 언어에 사용하는 정수입니다.
static Locale	ENGLISH 언어에 사용하는 정수입니다.
static Locale	FRANCE 나라에 사용하는 정수입니다.
static Locale	FRENCH 언어에 사용하는 정수입니다.
static Locale	GERMAN 언어에 사용하는 정수입니다.
static Locale	GERMANY 나라에 사용하는 정수입니다.
static Locale	ITALIAN 언어에 사용하는 정수입니다.
static Locale	ITALY 나라에 사용하는 정수입니다.
static Locale	JAPAN 나라에 사용하는 정수입니다.
static Locale	JAPANESE 언어에 사용하는 정수입니다.
static Locale	KOREA 나라에 사용하는 정수입니다.
static Locale	KOREAN 언어에 사용하는 정수입니다.
static Locale	PRC 나라에 사용하는 정수입니다.
static Locale	SIMPLIFIED_CHINESE 언어에 사용하는 정수입니다.
static Locale	TAIWAN 나라에 사용하는 정수입니다.
static Locale	TRADITIONAL_CHINESE 언어에 사용하는 정수입니다.
static Locale	UK 나라에 사용하는 정수입니다.
static Locale	US 나라에 사용하는 정수입니다.

생성자의 개요

Locale (String language)
언어 코드로부터 로케일을 구축합니다.

Locale (String language, String country)
언어, 나라로부터 로케일을 구축합니다.

Locale (String language, String country, String variant)
언어, 나라, 변형으로부터 로케일을 구축합니다.

메소드의 개요

Object	clone () Cloneable 를 오버라이드(override) 합니다.
boolean	equals (Object obj) 이 Locale 가 이제(벌써) 1 개의 오브젝트와 동일한 경우에 true 를 돌려줍니다.
static Locale []	getAvailableLocales () 인스톨 떠날 수 있어 모든 로케일의 리스트를 돌려줍니다.
String	getCountry () 로케일의 나라/지역 코드를 돌려줍니다.
static Locale	getDefault () Java 가상 머신의 이 인스턴스에 대해서, 디폴트 로케일의 현재의 값을 취득합니다.
String	getDisplayCountry () 유저에게로의 표시에 적절한, 로케일의 나라의 이름을 돌려줍니다.
String	getDisplayCountry (Locale inLocale) 유저에게로의 표시에 적절한, 로케일의 나라의 이름을 돌려줍니다.
String	getDisplayLanguage () 유저에게로의 표시에 적절한, 로케일의 언어의 이름을 돌려줍니다.
String	getDisplayLanguage (Locale inLocale) 유저에게로의 표시에 적절한, 로케일의 언어의 이름을 돌려줍니다.
String	getDisplayName () 유저에게로의 표시에 적절한, 로케일의 이름을 돌려줍니다.
String	getDisplayName (Locale inLocale) 유저에게로의 표시에 적절한, 로케일의 이름을 돌려줍니다.
String	getDisplayVariant () 유저에게로의 표시에 적절한, 로케일의 베어리언트 코드의 이름을 돌려줍니다.
String	getDisplayVariant (Locale inLocale) 유저에게로의 표시에 적절한, 로케일의 베어리언트 코드의 이름을 돌려줍니다.
String	getISO3Country () 로케일의 나라의 3 캐릭터의 생략형을 돌려줍니다.
String	getISO3Language () 로케일의 언어의 3 캐릭터의 생략형을 돌려줍니다.
static String []	getISOCountries () ISO 3166 으로 정의되고 있는 2 자리수의 나라 코드의 리스트를 돌려줍니다.
static String []	getISOLanguages () ISO 639 로 정의되고 있는 2 자리수의 언어 코드의 리스트를 돌려줍니다.
String	getLanguage () 로케일의 언어 코드를 돌려줍니다.
String	getVariant () 로케일의 베어리언트 코드를 돌려줍니다.
int	hashCode () hashCode 를 오버라이드(override) 합니다.
static void	setDefault (Locale newLocale) Java 가상 머신의 이 인스턴스에 대한 디폴트 로케일을 설정합니다.
String	toString () 로케일 전체의 프로그램상의 이름을 취득합니다.

클래스 java.lang. Object 에서 상속받은 메소드

finalize , getClass , notify , notifyAll , wait , wait , wait

필드의 상세

ENGLISH

public static final Locale  ENGLISH

언어에 사용하는 정수입니다.

FRENCH

public static final Locale  FRENCH

언어에 사용하는 정수입니다.

GERMAN

public static final Locale  GERMAN

언어에 사용하는 정수입니다.

ITALIAN

public static final Locale  ITALIAN

언어에 사용하는 정수입니다.

JAPANESE

public static final Locale  JAPANESE

언어에 사용하는 정수입니다.

KOREAN

public static final Locale  KOREAN

언어에 사용하는 정수입니다.

CHINESE

public static final Locale  CHINESE

언어에 사용하는 정수입니다.

SIMPLIFIED_CHINESE

public static final Locale  SIMPLIFIED_CHINESE

언어에 사용하는 정수입니다.

TRADITIONAL_CHINESE

public static final Locale  TRADITIONAL_CHINESE

언어에 사용하는 정수입니다.

FRANCE

public static final Locale  FRANCE

나라에 사용하는 정수입니다.

GERMANY

public static final Locale  GERMANY

나라에 사용하는 정수입니다.

ITALY

public static final Locale  ITALY

나라에 사용하는 정수입니다.

JAPAN

public static final Locale  JAPAN

나라에 사용하는 정수입니다.

KOREA

public static final Locale  KOREA

나라에 사용하는 정수입니다.

CHINA

public static final Locale  CHINA

나라에 사용하는 정수입니다.

PRC

public static final Locale  PRC

나라에 사용하는 정수입니다.

TAIWAN

public static final Locale  TAIWAN

나라에 사용하는 정수입니다.

UK

public static final Locale  UK

나라에 사용하는 정수입니다.

US

public static final Locale  US

나라에 사용하는 정수입니다.

CANADA

public static final Locale  CANADA

나라에 사용하는 정수입니다.

CANADA_FRENCH

public static final Locale  CANADA_FRENCH

나라에 사용하는 정수입니다.

생성자의 상세

Locale

public Locale(String  language,
              String  country,
              String  variant)

언어, 나라, 변형으로부터 로케일을 구축합니다. 주: ISO 639 는 확정한 규격이 아닙니다. ISO 639 로 정의된 일부의 언어 코드 (예를 들어, iw, ji, 및 in)는 변경되고 있습니다. 이 constructor 은 종래의 코드 (iw, ji, 및 in)와 새로운 코드 (he, yi, 및 id)의 양쪽 모두를 받습니다만, Locale 외 모든 API 에서는 낡은 (분)편의 코드만이 돌려주어집니다.

파라미터:

language - 2 자리수의 소문자로부터 되는 ISO-639 코드

country - 2 자리수의 대문자로부터 되는 ISO-3166 코드

variant - 벤더와 브라우저에 고유의 코드. 클래스의 설명을 참조

예외:

NullPointerException - 인수가 null 의 경우에 슬로우 됩니다.

Locale

public Locale(String  language,
              String  country)

언어, 나라로부터 로케일을 구축합니다. 주: ISO 639 는 확정한 규격이 아닙니다. ISO 639 로 정의된 일부의 언어 코드 (예를 들어, iw, ji, 및 in)는 변경되고 있습니다. 이 constructor 은 종래의 코드 (iw, ji, 및 in)와 새로운 코드 (he, yi, 및 id)의 양쪽 모두를 받습니다만, Locale 외 모든 API 에서는 낡은 (분)편의 코드만이 돌려주어집니다.

파라미터:

language - 2 자리수의 소문자로부터 되는 ISO-639 코드

country - 2 자리수의 대문자로부터 되는 ISO-3166 코드

예외:

NullPointerException - 어느 쪽인가의 인수가 null 의 경우에 슬로우 됩니다.

Locale

public Locale(String  language)

언어 코드로부터 로케일을 구축합니다. 주: ISO 639 는 확정한 규격이 아닙니다. ISO 639 로 정의된 일부의 언어 코드 (예를 들어, iw, ji, 및 in)는 변경되고 있습니다. 이 constructor 은 종래의 코드 (iw, ji, 및 in)와 새로운 코드 (he, yi, 및 id)의 양쪽 모두를 받습니다만, Locale 외 모든 API 에서는 낡은 (분)편의 코드만이 돌려주어집니다.

파라미터:

language - 2 자리수의 소문자로부터 되는 ISO-639 코드

예외:

NullPointerException - 인수가 null 의 경우에 슬로우 됩니다.

도입된 버젼:

1.4

메소드의 상세

getDefault

public static Locale  getDefault()

Java 가상 머신의 이 인스턴스에 대해서, 디폴트 로케일의 현재의 값을 취득합니다.

Java 가상 머신에서는 호스트 환경에 근거해 기동시에 디폴트 로케일이 설정됩니다. 로케일이 명시적으로 지정되어 있지 않은 경우, 로케일에 의존하는 메소드가 많고로 디폴트 로케일이 사용됩니다. setDefault 메소드를 사용해 변경할 수 있습니다.

반환값:

Java 가상 머신의 이 인스턴스에 대한 디폴트 로케일

setDefault

public static void setDefault(Locale  newLocale)

Java 가상 머신의 이 인스턴스에 대한 디폴트 로케일을 설정합니다. 이것은 호스트 로케일에는 영향을 주지 않습니다.

시큐러티 매니저가 존재하는 경우, 디폴트 로케일이 변경되기 전에, 시큐러티 매니저의 checkPermission 메소드가 액세스권 PropertyPermission("user.language", "write") 를 지정해 불려 갑니다.

Java 가상 머신에서는 호스트 환경에 근거해 기동시에 디폴트 로케일이 설정됩니다. 로케일이 명시적으로 지정되어 있지 않은 경우, 로케일에 의존하는 메소드가 많고로 디폴트 로케일이 사용됩니다.

디폴트 로케일의 변경은 다양한 기능의 area에 영향을 줄 가능성이 있기 (위해)때문에, 이 메소드는 유저 인터페이스 등, 같은 Java 가상 머신으로 실행되는 로케일 의존 코드를 호출해 옆이 재초기화할 수 있는 경우에만 사용합니다.

파라미터:

newLocale - 새로운 디폴트의 로케일

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우에, 시큐러티 매니저의 checkPermission 메소드가 오퍼레이션을 허가하지 않을 때

NullPointerException - newLocale 가 null 의 경우

관련 항목:

SecurityManager.checkPermission(java.security.Permission) , PropertyPermission

getAvailableLocales

public static Locale [] getAvailableLocales()

인스톨 떠날 수 있어 모든 로케일의 리스트를 돌려줍니다.

getISOCountries

public static String [] getISOCountries()

ISO 3166 으로 정의되고 있는 2 자리수의 나라 코드의 리스트를 돌려줍니다. Locale 를 작성할 경우에 사용할 수 있습니다.

getISOLanguages

public static String [] getISOLanguages()

ISO 639 로 정의되고 있는 2 자리수의 언어 코드의 리스트를 돌려줍니다. Locale 를 작성할 경우에 사용할 수 있습니다. [주: ISO 639 는 확정한 규격이 아닙니다. 일부의 언어의 코드는 변경되고 있습니다. 이 함수가 돌려주는 리스트에는 코드가 변경된 언어의 새로운 코드와 종래의 코드의 양쪽 모두가 포함되어 있습니다. ]

getLanguage

public String  getLanguage()

로케일의 언어 코드를 돌려줍니다. 하늘의 캐릭터 라인 또는 소문자의 ISO 639 코드의 어느 쪽인지가 돌려주어집니다.

주: ISO 639 는 확정한 규격이 아닙니다. 일부의 언어의 코드는 변경되고 있습니다. 로케일의 constructor 은 코드가 변경된 언어의 새로운 코드와 종래의 코드의 양쪽 모두를 인식합니다만, 이 함수는 항상 낡은 (분)편의 코드를 돌려줍니다. 코드가 변경된 특정의 언어를 조사하는 경우는

 if (locale.getLanguage(). equals("he")
    ...

(을)를 사용하지 말고, 다음과 같이 코딩 합니다.

 if (locale.getLanguage(). equals(new Locale("he", "", ""). getLanguage())
    ...

관련 항목:

getDisplayLanguage()

getCountry

public String  getCountry()

로케일의 나라/지역 코드를 돌려줍니다. 하늘의 캐릭터 라인 또는 2 자리수의 대문자의 ISO 3166 코드의 어느 쪽인지가 돌려주어집니다.

관련 항목:

getDisplayCountry()

getVariant

public String  getVariant()

로케일의 베어리언트 코드를 돌려줍니다.

관련 항목:

getDisplayVariant()

toString

public final String  toString()

로케일 전체의 프로그램상의 이름을 취득합니다. 언어, 나라, 변형이 밑줄로 단락지어집니다. 언어는 항상 소문자로, 나라는 항상 대문자입니다. 언어가 결핍 하고 있는 경우는 캐릭터 라인의 선두는 밑줄이 됩니다. 언어 필드와 나라 필드가 결핍 하고 있는 경우는 변형 필드가 지정되고 있어도, 이 함수는 하늘의 캐릭터 라인을 돌려줍니다. 변형만을 가지는 로케일은 작성할 수 없습니다. 변형은 유효한 언어 코드 또는 나라 코드와 함께 사용할 필요가 있습니다. 예: 「en」, 「de_DE」, 「GB」, 「en_US_WIN」, 「de__POSIX」, 및 「fr__MAC」

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 오브젝트의 캐릭터 라인 표현

관련 항목:

getDisplayName()

getISO3Language

public String  getISO3Language()
                       throws MissingResourceException 

로케일의 언어의 3 캐릭터의 생략형을 돌려줍니다. 로케일이 언어를 지정하고 있지 않는 경우는 하늘의 캐릭터 라인이 돌려주어집니다. 그렇지 않은 경우는 ISO 639-2/T 의 소문자의 언어 코드가 돌려주어집니다. ISO 639-2 언어 코드는 온라인의 ftp://dkuug.dk/i18n/iso-639-2.txt 에 있습니다.

예외:

MissingResourceException - 로케일에 대한 3 캐릭터의 언어 생략형이 없으면 MissingResourceException 가 슬로우 된다

getISO3Country

public String  getISO3Country()
                      throws MissingResourceException 

로케일의 나라의 3 캐릭터의 생략형을 돌려줍니다. 로케일이 나라를 지정하고 있지 않는 경우는 하늘의 캐릭터 라인이 돌려주어집니다. 그렇지 않은 경우는 ISO 3166 의 대문자 3 캐릭터의 나라 코드가 돌려주어집니다.

예외:

MissingResourceException - 로케일에 대한 3 캐릭터의 나라 생략형이 없으면 MissingResourceException 가 슬로우 된다

getDisplayLanguage

public final String  getDisplayLanguage()

유저에게로의 표시에 적절한, 로케일의 언어의 이름을 돌려줍니다. 가능한 경우는 돌려주어지는 이름은 디폴트 로케일에 지역 대응됩니다. 예를 들어, 로케일이 fr_FR 로 디폴트 로케일이 en_US 의 경우, getDisplayLanguage()는 「French」를 돌려주어, 로케일이 en_US 로 디폴트 로케일이 fr_FR 의 경우, getDisplayLanguage()는 「anglais」를 돌려줍니다. 돌려주어지는 이름이 디폴트 로케일에 지역 대응할 수 없는 경우는 (예를 들어, 크로아티아어에 대한 일본어명은 없다), 이 함수는 영어명을 대용해, 그것도 불가능한 경우는 ISO 코드를 사용합니다. 로케일이 언어를 지정하고 있지 않는 경우는 이 함수는 하늘의 캐릭터 라인을 돌려줍니다.

getDisplayLanguage

public String  getDisplayLanguage(Locale  inLocale)

유저에게로의 표시에 적절한, 로케일의 언어의 이름을 돌려줍니다. 가능한 경우는 돌려주어지는 이름은 inLocale 에 따라 지역 대응됩니다. 예를 들어, 로케일이 fr_FR 로 inLocale 가 en_US 의 경우, getDisplayLanguage()는 「French」를 돌려주어, 로케일이 en_US 로 inLocale 가 fr_FR 의 경우, getDisplayLanguage()는 「anglais」를 돌려줍니다. 돌려주어지는 이름이 inLocale 에 따라 지역 대응할 수 없는 경우는 (예를 들어, 크로아티아어에 대한 일본어명은 없다), 이 함수는 우선 디폴트 로케일을 대용해, 다음에 영어명을 대용해, 그것도 불가능한 경우는 ISO 코드를 사용합니다. 로케일이 언어를 지정하고 있지 않는 경우는 이 함수는 하늘의 캐릭터 라인을 돌려줍니다.

getDisplayCountry

public final String  getDisplayCountry()

유저에게로의 표시에 적절한, 로케일의 나라의 이름을 돌려줍니다. 가능한 경우는 돌려주어지는 이름은 디폴트 로케일에 지역 대응됩니다. 예를 들어, 로케일이 fr_FR 로 디폴트 로케일이 en_US 의 경우, getDisplayCountry()는 「French」를 돌려주어, 로케일이 en_US 로 디폴트 로케일이 fr_FR 의 경우, getDisplayCountry()는 「Etats-Unis」를 돌려줍니다. 돌려주어지는 이름이 디폴트 로케일에 지역 대응할 수 없는 경우는 (예를 들어, 크로아티아에 대한 일본어명은 없다), 이 함수는 영어명을 대용해, 그것도 불가능한 경우는 ISO 코드를 사용합니다. 로케일이 나라를 지정하고 있지 않는 경우는 이 함수는 하늘의 캐릭터 라인을 돌려줍니다.

getDisplayCountry

public String  getDisplayCountry(Locale  inLocale)

유저에게로의 표시에 적절한, 로케일의 나라의 이름을 돌려줍니다. 가능한 경우는 돌려주어지는 이름은 inLocale 에 따라 지역 대응됩니다. 예를 들어, 로케일이 fr_FR 로 inLocale 가 en_US 의 경우, getDisplayCountry()는 「French」를 돌려주어, 로케일이 en_US 로 inLocale 가 fr_FR 의 경우, getDisplayCountry()는 「Etats-Unis」를 돌려줍니다. 돌려주어지는 이름이 inLocale 에 따라 지역 대응할 수 없는 경우는 (예를 들어, 크로아티아에 대한 일본어명은 없다), 이 함수는 우선 디폴트 로케일을 대용해, 다음에 영어명을 대용해, 그것도 불가능한 경우는 ISO 코드를 사용합니다. 로케일이 나라를 지정하고 있지 않는 경우는 이 함수는 하늘의 캐릭터 라인을 돌려줍니다.

getDisplayVariant

public final String  getDisplayVariant()

유저에게로의 표시에 적절한, 로케일의 베어리언트 코드의 이름을 돌려줍니다. 가능한 경우는 돌려주어지는 이름은 디폴트 로케일에 지역 대응됩니다. 로케일이 베어리언트 코드를 지정하고 있지 않는 경우는 이 함수는 하늘의 캐릭터 라인을 돌려줍니다.

getDisplayVariant

public String  getDisplayVariant(Locale  inLocale)

유저에게로의 표시에 적절한, 로케일의 베어리언트 코드의 이름을 돌려줍니다. 가능한 경우는 돌려주어지는 이름은 inLocale 에 따라 지역 대응됩니다. 로케일이 베어리언트 코드를 지정하고 있지 않는 경우는 이 함수는 하늘의 캐릭터 라인을 돌려줍니다.

getDisplayName

public final String  getDisplayName()

유저에게로의 표시에 적절한, 로케일의 이름을 돌려줍니다. 돌려주어지는 이름은 getDisplayLanguage(), getDisplayCountry(), 및 getDisplayVariant()로부터 돌려주어진 값을 1 개의 캐릭터 라인에 집계한 것입니다. 표시명은 로케일로 지정되고 있는 필드에 의해, 다음의 어떤 것인가의 형식이 됩니다.

language (country, variant)

language (country)

language (variant)

country (variant)

language

country

variant

로케일로 지정되고 있는 필드가 무언가에보다 바뀝니다. 언어, 나라, 및 변형의 각 필드가 모두 비었을 경우, 이 함수는 하늘의 캐릭터 라인을 돌려줍니다.

getDisplayName

public String  getDisplayName(Locale  inLocale)

유저에게로의 표시에 적절한, 로케일의 이름을 돌려줍니다. 돌려주어지는 이름은 getDisplayLanguage(), getDisplayCountry(), 및 getDisplayVariant()로부터 돌려주어진 값을 1 개의 캐릭터 라인에 집계한 것입니다. 표시명은 로케일로 지정되고 있는 필드에 의해, 다음의 어떤 것인가의 형식이 됩니다.

language (country, variant)

language (country)

language (variant)

country (variant)

language

country

variant

로케일로 지정되고 있는 필드가 무언가에보다 바뀝니다. 언어, 나라, 및 변형의 각 필드가 모두 비었을 경우, 이 함수는 하늘의 캐릭터 라인을 돌려줍니다.

clone

public Object  clone()

Cloneable 를 오버라이드(override) 합니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 인스턴스의 복제

관련 항목:

Cloneable

hashCode

public int hashCode()

hashCode 를 오버라이드(override) 합니다. 해시 테이블에서는 Locale 가 자주 사용되므로, 속도를 올리기 위해서(때문에) 값이 캐슈 됩니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 오브젝트의 해시 코드치

관련 항목:

Object.equals(java.lang.Object) , Hashtable

equals

public boolean equals(Object  obj)

이 Locale 가 이제(벌써) 1 개의 오브젝트와 동일한 경우에 true 를 돌려줍니다. 2 개의 Locale 는 언어, 나라, 및 변형이 같은 경우에 동일하다고 보여집니다. 그렇지 않은 경우는 동일하지는 않습니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 비교 대상의 참조 오브젝트

반환값:

이 Locale 가 지정된 오브젝트와 동일한 경우는 true

관련 항목:

Object.hashCode() , Hashtable