java.util.Locale
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
java.lang.Object
public final class Locale
Locale객체는
특정의 지리적, 국가적, 또는 문화적 지역을 나타내기 위한 것입니다. 어느 조작으로 Locale를 필요로 하는 태스크가 있는 경우, 그 조작을 로케일에
의존된 조작이라고 합니다. 이 경우
정보는 Locale에 의해 사용자에 맞추어 조정됩니다. 예를 들어
수치를 표시하는 것은 로케일에
의존된 조작입니다. 이 수치는 사용자
의 나라나 지역, 문화의 습관이나 규칙에 따라 포맷 할 필요가 있습니다.
Locale 객체를 작성하려면,
이 클래스의 생성자를 사용합니다.
언어의 인수는 유효한 ISO 언어 코드입니다. 이러한 코드는 ISO-639 로 정의되는 2 자리수의 소문자입니다. 코드의 완전한 리스트는Locale(String language) Locale(String language, String country) Locale(String language, String country, String variant)
http://www.loc.gov/standards/iso639-2/englangn.html 등, 다수의 사이트에서 입수할 수 있습니다.
나라의 인수는 유효한 ISO 국 코드입니다. 이러한 코드는 ISO-3166 로 정의되는 2 자리수의 대문자입니다. 코드의 완전한 리스트는
http://www.iso.ch/iso/en/prods-services/iso3166ma/02iso-3166-code-lists/list-en1.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개의 메서드가 있습니다.
이러한 메서드에는 2개의 변형이 있습니다. 명시적인 로케일을 가지는 것과 가지지 않는 것입니다. 후자의 경우는 디폴트 로케일이 사용됩니다.NumberFormat.getInstance() NumberFormat.getCurrencyInstance() NumberFormat.getPercentInstance()
NumberFormat.getInstance(myLocale) NumberFormat.getCurrencyInstance(myLocale) NumberFormat.getPercentInstance(myLocale)
Locale는
어느 객체 (NumberFormat)를 사용하는지를 지정하기 위한 도구
입니다. 로케일은 객체를 지정하기 위한 단순한 도구이며, 객체 자체의 컨테이너가 아닙니다.
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 |
| 필드의 상세 |
|---|
public static final Locale ENGLISH
public static final Locale FRENCH
public static final Locale GERMAN
public static final Locale ITALIAN
public static final Locale JAPANESE
public static final Locale KOREAN
public static final Locale CHINESE
public static final Locale SIMPLIFIED_CHINESE
public static final Locale TRADITIONAL_CHINESE
public static final Locale FRANCE
public static final Locale GERMANY
public static final Locale ITALY
public static final Locale JAPAN
public static final Locale KOREA
public static final Locale CHINA
public static final Locale PRC
public static final Locale TAIWAN
public static final Locale UK
public static final Locale US
public static final Locale CANADA
public static final Locale CANADA_FRENCH
| 생성자 상세 |
|---|
public Locale(String language,
String country,
String variant)
language - 2 자리수의 소문자로부터 되는 ISO-639 코드country - 2 자리수의 대문자로부터 되는 ISO-3166 코드variant - 벤더와 브라우저에 고유의 코드. 클래스의 설명을 참조
NullPointerException - 인수가 null인 경우에 Throw 된다
public Locale(String language,
String country)
language - 2 자리수의 소문자로부터 되는 ISO-639 코드country - 2 자리수의 대문자로부터 되는 ISO-3166 코드
NullPointerException - 어느 쪽인가의 인수가 null인 경우에 Throw 된다public Locale(String language)
language - 2 자리수의 소문자로부터 되는 ISO-639 코드
NullPointerException - 인수가 null인 경우에 발생되는 | 메서드의 상세 |
|---|
public static Locale getDefault()
Java 가상 머신에서는 호스트 환경에 근거해 시작시에 디폴트 로케일이 설정됩니다. 로케일이 명시적으로 지정되어 있지 않은 경우, 로케일에
의존된 메서드가 많고로 디폴트 로케일이 사용됩니다. setDefault 메서드를 사용해 변경할 수 있습니다.
public static void setDefault(Locale newLocale)
시큐러티 매니저가 존재하는 경우, 디폴트 로케일이 변경되기 전에
시큐러티 매니저의 checkPermission 메서드가 접근 권한 PropertyPermission("user.language", "write")를 지정해 호출합니다.
Java 가상 머신에서는 호스트 환경에 근거해 시작시에 디폴트 로케일이 설정됩니다. 로케일이 명시적으로 지정되어 있지 않은 경우, 로케일에 의존된 메서드가 많고로 디폴트 로케일이 사용됩니다.
디폴트 로케일의 변경은 다양한 기능의 영역에 영향을 줄 가능성이 있기 때문에 이 메서드는 사용자 인터페이스 등, 같은 Java 가상 머신으로 실행되는 로케일 존 코드를, 호출측이 재초기화할 수 있는 경우에만 사용합니다.
newLocale - 새로운 디폴트의 로케일
SecurityException - 시큐러티 매니저가 존재하는 경우에
시큐러티 매니저의 checkPermission 메서드가 오퍼레이션을 허가하지 않을 때
NullPointerException - newLocale가 null인 경우SecurityManager.checkPermission(java.security.Permission),
PropertyPermission public static Locale [] getAvailableLocales()
Locale.US 와
등가인 Locale인스턴스가 적어도 1개
포함되어 있을 필요가 있습니다.
public static String [] getISOCountries()
public static String [] getISOLanguages()
public String getLanguage()
주: ISO 639는 확정한 규격이 아닙니다. 일부의 언어의 코드는 변경되고 있습니다. 로케일의 생성자는 코드가 변경된 언어의 새로운 코드와 종래의 코드의 양쪽 모두를 인식합니다만, 이 함수는 항상 낡은 (분)편의 코드를 리턴합니다. 코드가 변경된 특정의 언어를 조사하는 경우는
if (locale.getLanguage(). equals("he")
...
를 사용하지 말고, 다음과 같이 코딩 합니다.
if (locale.getLanguage(). equals(new Locale("he", "", ""). getLanguage()) ...
getDisplayLanguage() public String getCountry()
getDisplayCountry() public String getVariant()
getDisplayVariant() public final String toString()
Object 내의 toString getDisplayName()
public String getISO3Language()
throws MissingResourceException
http://www.loc.gov/standards/iso639-2/englangn.html에 있습니다.
MissingResourceException - 로케일에 대한 3 문자의 언어 생략형이 없으면 MissingResourceException가 Throw 된다
public String getISO3Country()
throws MissingResourceException
http://www.davros.org/misc/iso3166.txt에 있습니다.
MissingResourceException - 로케일에 대한 3 문자의 나라 생략형이 없으면 MissingResourceException가 Throw 된다public final String getDisplayLanguage()
public String getDisplayLanguage(Locale inLocale)
public final String getDisplayCountry()
public String getDisplayCountry(Locale inLocale)
public final String getDisplayVariant()
public String getDisplayVariant(Locale inLocale)
public final String getDisplayName()
language (country, variant)사용되는 형식은 로케일로 가리키는 필드에 의해 변화합니다. 언어, 나라 및 변형의 각 필드가 모두 비어있는 경우, 이 함수는 비어있는 캐릭터 라인을 리턴합니다.language (country)
language (variant)
country (variant)
language
country
variant
public String getDisplayName(Locale inLocale)
language (country, variant)사용되는 형식은 로케일로 가리키는 필드에 의해 변화합니다. 언어, 나라 및 변형의 각 필드가 모두 비어있는 경우, 이 함수는 비어있는 캐릭터 라인을 리턴합니다.language (country)
language (variant)
country (variant)
language
country
variant
public Object clone()
Object 내의 clone Cloneable public int hashCode()
Object 내의 hashCode Object.equals(java.lang.Object),
Hashtable public boolean equals(Object obj)
Object 내의 equals obj - 비교 대상의 참조 객체
Object.hashCode(),
Hashtable
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.