java.text
클래스 DateFormatSymbols

java.lang.Object 
  java.text.DateFormatSymbols

모든 구현된 인터페이스:

Serializable , Cloneable

public class DateFormatSymbols
extends Object 
implements Serializable , Cloneable 

DateFormatSymbols 는, 달, 요일, 타임 존 데이터 등, 지역 대응이 가능한 일자/시각 포맷 데이터를 캡슐화하기 위한 public 클래스입니다. DateFormat 과 SimpleDateFormat 은 DateFormatSymbols 를 사용해 이 정보를 캡슐화합니다.

일반적으로는,DateFormatSymbols 를 직접 사용하는 것은 하지 않습니다. 그 대신에, 가능한 한 DateFormat 클래스의 팩토리 메소드 getTimeInstance,getDateInstance, 또는 getDateTimeInstance 를 사용해 일자/시각 포매터를 작성해 주세요. 이러한 메소드를 사용하면(자), 그 포매터의 DateFormatSymbols 가 자동적으로 작성되므로, 새롭게 작성할 필요는 없습니다. 포매터가 작성되면(자), 그 포맷 패턴은 setPattern 메소드를 사용해 수정할 수가 있습니다. DateFormat 의 팩토리 메소드를 사용해 포맷을 작성하는 방법에 대해서는,DateFormat 를 참조해 주세요.

특정의 로케일에 대한 특정의 포맷 패턴을 사용해 일자/시각을 작성하는 경우에는, 다음과 같이 합니다.

 new SimpleDateFormat(aPattern, DateFormatSymbols.getInstance(aLocale)).
 

DateFormatSymbols 객체는 복제 가능합니다. DateFormatSymbols 객체를 취득하면(자), 그 일자/시각 포맷 데이터를 자유롭게 수정할 수가 있습니다. 예를 들어, 지역 대응된 일자/시각 포맷 패턴 문자를, 기억하기 쉬운 것에 옮겨놓을 수가 있습니다. 혹은, 대표적인 도시명을 기호의 것으로 바꿀 수가 있습니다.

추가 로케일에 대한 일자/시각 포맷 기능을 위해서(때문에), 새로운 DateFormatSymbols 서브 클래스를 추가해 SimpleDateFormat 를 지원할 수가 있습니다.

관련 항목:

DateFormat , SimpleDateFormat , SimpleTimeZone , 직렬화 된 형식

생성자 의 개요

DateFormatSymbols ()
디폴트 로케일에 대한 자원으로부터 포맷 데이터를 읽어들이는 것에 의해, DateFormatSymbols 객체를 구축합니다.

DateFormatSymbols (Locale locale)
지정된 로케일에 대한 자원으로부터 포맷 데이터를 읽어들이는 것에 의해, DateFormatSymbols 객체를 구축합니다.

메소드의 개요

Object	clone () Cloneable 를 오버라이드(override) 합니다.
boolean	equals (Object obj) equals 를 오버라이드(override) 합니다.
String []	getAmPmStrings () 오전/오후의 캐릭터 라인 「AM」나 「PM」를 가져옵니다.
static Locale []	getAvailableLocales () 이 클래스의 getInstance 메소드가 지역 대응의 인스턴스를 돌려줄 수 있는 로케일 모든 배열을 돌려줍니다.
String []	getEras () 기원의 캐릭터 라인 「AD」나 「BC」등을 가져옵니다.
static DateFormatSymbols	getInstance () 디폴트 로케일의 DateFormatSymbols 인스턴스를 가져옵니다.
static DateFormatSymbols	getInstance (Locale locale) 지정된 로케일의 DateFormatSymbols 인스턴스를 가져옵니다.
String	getLocalPatternChars () 로컬라이즈 된 일자/시각 패턴 문자 「u」, 「t」등을 가져옵니다.
String []	getMonths () 달의 캐릭터 라인 「January」, 「February」등을 가져옵니다.
String []	getShortMonths () 달의 단축 캐릭터 라인 「Jan」, 「Feb」등을 가져옵니다.
String []	getShortWeekdays () 요일의 단축 캐릭터 라인 「Sun」, 「Mon」등을 가져옵니다.
String []	getWeekdays () 요일의 캐릭터 라인 「Sunday」, 「Monday」등을 가져옵니다.
String [][]	getZoneStrings () 타임 존의 캐릭터 라인을 가져옵니다.
int	hashCode () hashCode 를 오버라이드(override) 합니다.
void	setAmPmStrings (String [] newAmpms) 오전/오후의 캐릭터 라인 「AM」나 「PM」를 설정합니다.
void	setEras (String [] newEras) 기원의 캐릭터 라인 「AD」나 「BC」등을 설정합니다.
void	setLocalPatternChars (String newLocalPatternChars) 로컬라이즈 된 일자/시각 패턴 문자 「u」, 「t」등을 설정합니다.
void	setMonths (String [] newMonths) 달의 캐릭터 라인 「January」, 「February」등을 설정합니다.
void	setShortMonths (String [] newShortMonths) 달의 단축 캐릭터 라인 「Jan」, 「Feb」등을 설정합니다.
void	setShortWeekdays (String [] newShortWeekdays) 요일의 단축 캐릭터 라인 「Sun」, 「Mon」등을 설정합니다.
void	setWeekdays (String [] newWeekdays) 요일의 캐릭터 라인 「Sunday」, 「Monday」등을 설정합니다.
void	setZoneStrings (String [][] newZoneStrings) 타임 존의 캐릭터 라인을 설정합니다.

클래스 java.lang. Object 로부터 상속된 메소드

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

생성자 의 상세

DateFormatSymbols

public DateFormatSymbols()

디폴트 로케일에 대한 자원으로부터 포맷 데이터를 읽어들이는 것에 의해, DateFormatSymbols 객체를 구축합니다. 이 생성자 에서는, Java 실행 환경에서 지원되고 있는 로케일에 대한 보고, 인스턴스를 구축할 수 있습니다. 인스톨 되고 있는 DateFormatSymbolsProvider 구현으로 지원되고 있는 로케일에 대해서는, 인스턴스를 구축할 수 없습니다. 모든 로케일을 커버하려면 ,getInstance 메소드를 사용해 주세요.

예외:

MissingResourceException - 디폴트 로케일에 대한 자원이 발견되지 않는가, 읽어들일 수 없는 경우

관련 항목:

getInstance()

DateFormatSymbols

public DateFormatSymbols(Locale  locale)

지정된 로케일에 대한 자원으로부터 포맷 데이터를 읽어들이는 것에 의해, DateFormatSymbols 객체를 구축합니다. 이 생성자 에서는, Java 실행 환경에서 지원되고 있는 로케일에 대한 보고, 인스턴스를 구축할 수 있습니다. 인스톨 되고 있는 DateFormatSymbolsProvider 구현으로 지원되고 있는 로케일에 대해서는, 인스턴스를 구축할 수 없습니다. 모든 로케일을 커버하려면 ,getInstance 메소드를 사용해 주세요.

예외:

MissingResourceException - 지정된 로케일에 대한 자원이 발견되지 않는가, 읽어들일 수 없는 경우

관련 항목:

getInstance(Locale)

메소드의 상세

getAvailableLocales

public static Locale [] getAvailableLocales()

이 클래스의 getInstance 메소드가 지역 대응의 인스턴스를 돌려줄 수 있는 로케일 모든 배열을 돌려줍니다. 반환되는 배열은, Java 런타임 및 인스톨 되고 있는 DateFormatSymbolsProvider 구현에 의해 지원되고 있는 로케일의 화집합을 나타냅니다. 이것에는,Locale.US 와 등가인 Locale 인스턴스가 적어도 1 개(살) 포함되어 있을 필요가 있습니다.

반환값:

로컬라이즈 된 DateFormatSymbols 인스턴스를 사용 가능한 로케일의 배열

도입된 버젼:

1.6

getInstance

public static final DateFormatSymbols  getInstance()

디폴트 로케일의 DateFormatSymbols 인스턴스를 가져옵니다. 이 메소드를 사용하면(자), Java 런타임 자체로 지원되고 있는 로케일과 인스톨 되고 있는 DateFormatSymbolsProvider 구현으로 지원되고 있는 로케일의,DateFormatSymbols 인스턴스에 액세스 할 수 있습니다.

반환값:

DateFormatSymbols 의 인스턴스

도입된 버젼:

1.6

getInstance

public static final DateFormatSymbols  getInstance(Locale  locale)

지정된 로케일의 DateFormatSymbols 인스턴스를 가져옵니다. 이 메소드를 사용하면(자), Java 런타임 자체로 지원되고 있는 로케일과 인스톨 되고 있는 DateFormatSymbolsProvider 구현으로 지원되고 있는 로케일의,DateFormatSymbols 인스턴스에 액세스 할 수 있습니다.

파라미터:

locale - 지정된 로케일

반환값:

DateFormatSymbols 의 인스턴스

예외:

NullPointerException - locale 가 null 의 경우

도입된 버젼:

1.6

getEras

public String [] getEras()

기원의 캐릭터 라인 「AD」나 「BC」등을 가져옵니다.

반환값:

기원의 캐릭터 라인

setEras

public void setEras(String [] newEras)

기원의 캐릭터 라인 「AD」나 「BC」등을 설정합니다.

파라미터:

newEras - 새로운 기원의 캐릭터 라인

getMonths

public String [] getMonths()

달의 캐릭터 라인 「January」, 「February」등을 가져옵니다.

반환값:

월의 캐릭터 라인

setMonths

public void setMonths(String [] newMonths)

달의 캐릭터 라인 「January」, 「February」등을 설정합니다.

파라미터:

newMonths - 새로운 달의 캐릭터 라인

getShortMonths

public String [] getShortMonths()

달의 단축 캐릭터 라인 「Jan」, 「Feb」등을 가져옵니다.

반환값:

월의 단축 캐릭터 라인

setShortMonths

public void setShortMonths(String [] newShortMonths)

달의 단축 캐릭터 라인 「Jan」, 「Feb」등을 설정합니다.

파라미터:

newShortMonths - 새로운 달의 단축 캐릭터 라인

getWeekdays

public String [] getWeekdays()

요일의 캐릭터 라인 「Sunday」, 「Monday」등을 가져옵니다.

반환값:

요일의 캐릭터 라인 결과의 배열의 인덱스에는, Calendar.SUNDAY,Calendar.MONDAY 등을 사용

setWeekdays

public void setWeekdays(String [] newWeekdays)

요일의 캐릭터 라인 「Sunday」, 「Monday」등을 설정합니다.

파라미터:

newWeekdays - 새로운 요일의 캐릭터 라인. 배열의 인덱스에는, Calendar.SUNDAY, Calendar.MONDAY 등을 사용

getShortWeekdays

public String [] getShortWeekdays()

요일의 단축 캐릭터 라인 「Sun」, 「Mon」등을 가져옵니다.

반환값:

요일의 단축 캐릭터 라인. 결과의 배열의 인덱스에는, Calendar.SUNDAY,Calendar.MONDAY 등을 사용

setShortWeekdays

public void setShortWeekdays(String [] newShortWeekdays)

요일의 단축 캐릭터 라인 「Sun」, 「Mon」등을 설정합니다.

파라미터:

newShortWeekdays - 새로운 요일의 단축 캐릭터 라인. 배열의 인덱스에는, Calendar.SUNDAY, Calendar.MONDAY 등을 사용

getAmPmStrings

public String [] getAmPmStrings()

오전/오후의 캐릭터 라인 「AM」나 「PM」를 가져옵니다.

반환값:

오전/오후의 캐릭터 라인

setAmPmStrings

public void setAmPmStrings(String [] newAmpms)

오전/오후의 캐릭터 라인 「AM」나 「PM」를 설정합니다.

파라미터:

newAmpms - 새로운 오전/오후의 캐릭터 라인

getZoneStrings

public String [][] getZoneStrings()

타임 존의 캐릭터 라인을 가져옵니다. 이 메소드를 사용하는 것은 추천 되지 않습니다. 대신에,TimeZone.getDisplayName() 를 사용해 주세요.

반환되는 값은, 사이즈가 n × m 의 2 차원의 캐릭터 라인 배열로, 이 경우의 m 는 5 이상이 됩니다. 각 n 행은, 단일의 TimeZone 에 대해서 로컬라이즈 된 이름을 포함한 엔트리입니다. 각 행에는 다음의 것이 포함됩니다 (i 는 0 ~ n-1 의 범위내).

• zoneStrings[i][0] - 타임 존 ID
• zoneStrings[i][1] - 표준시각의 존의 긴 이름
• zoneStrings[i][2] - 표준시각의 존의 짧은 이름
• zoneStrings[i][3] - 서머타임의 존의 긴 이름
• zoneStrings[i][4] - 서머타임의 존의 짧은 이름

존 ID 는 로컬라이즈 되고 있지 않습니다. TimeZone 클래스의,커스텀 ID 는 아닌 유효한 ID 의 어느 쪽인가에 됩니다. 다른 엔트리는 모두 지역 대응된 이름입니다. 존에서 서머타임이 구현되어 있지 않은 경우, 서머타임의 이름은 사용하지 않게 해 주세요.

이 DateFormatSymbols 인스턴스에 대해서 setZoneStrings 가 벌써 불려 가고 있었을 경우는, 그 호출에 의해 지정된 캐릭터 라인이 돌려주어집니다. 그 이외의 경우, 반환되는 배열에는, Java 런타임 및 인스톨 되고 있는 TimeZoneNameProvider 구현에 의해 제공되고 있는 이름이 포함됩니다.

반환값:

타임 존의 캐릭터 라인

관련 항목:

setZoneStrings(String[][])

setZoneStrings

public void setZoneStrings(String [][] newZoneStrings)

타임 존의 캐릭터 라인을 설정합니다. 인수는, 사이즈가 n × m 의 2 차원의 캐릭터 라인 배열을 지정할 필요가 있어, 이 경우의 m 는 5 이상이 됩니다. 각 n 행은, 단일의 TimeZone 에 대해서 로컬라이즈 된 이름을 포함한 엔트리입니다. 각 행에는 다음의 것이 포함됩니다 (i 는 0 ~ n-1 의 범위내).

• zoneStrings[i][0] - 타임 존 ID
• zoneStrings[i][1] - 표준시각의 존의 긴 이름
• zoneStrings[i][2] - 표준시각의 존의 짧은 이름
• zoneStrings[i][3] - 서머타임의 존의 긴 이름
• zoneStrings[i][4] - 서머타임의 존의 짧은 이름

존 ID 는 로컬라이즈 되고 있지 않습니다. TimeZone 클래스의,커스텀 ID 는 아닌 유효한 ID 의 어느 쪽인가에 됩니다. 다른 엔트리는 모두 지역 대응된 이름입니다.

파라미터:

newZoneStrings - 새로운 타임 존 캐릭터 라인

예외:

IllegalArgumentException - newZoneStrings 의 몇개의 행이 5 보다 짧은 경우

NullPointerException - newZoneStrings 가 null 의 경우

관련 항목:

getZoneStrings()

getLocalPatternChars

public String  getLocalPatternChars()

로컬라이즈 된 일자/시각 패턴 문자 「u」, 「t」등을 가져옵니다.

반환값:

지역 대응된 일자/시각 패턴 문자

setLocalPatternChars

public void setLocalPatternChars(String  newLocalPatternChars)

로컬라이즈 된 일자/시각 패턴 문자 「u」, 「t」등을 설정합니다.

파라미터:

newLocalPatternChars - 새로운 로컬라이즈 된 일자/시각 패턴 문자

clone

public Object  clone()

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

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 인스턴스의 복제

관련 항목:

Cloneable

hashCode

public int hashCode()

hashCode 를 오버라이드(override) 합니다. DateFormatSymbols 객체의 해시 코드를 생성합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

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

equals

public boolean equals(Object  obj)

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

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 비교 대상의 참조 객체

반환값:

obj 인수로 지정된 객체와 이 객체가 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode() , Hashtable