java.text.Format
java.text.DateFormat
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
java.lang.Object
public abstract class DateFormat
DateFormat는
언어에
존하지 않는 방법으로 날짜와 시간 또는 시각을 포맷 및 해석하는 날짜와 시간/시각 포맷 서브 클래스의 추상 클래스입니다. SimpleDateFormat 등의 날짜와 시간/시각 포맷 서브 클래스에의해 포맷 (일자 -> 텍스트), 해석 (텍스트 -> 날짜와 시간) 및 정규화를 실시할 수 있습니다
. 날짜와 시간는 Date 객체 또는 1970 년 1 월 1 일 그리니지 표준시 00:00:00 부터의 밀리 세컨드로 표현됩니다.
DateFormat는 기본값, 지정된 로케일, 많은 포맷 스타일에 기반해 디폴트의 날짜와 시간/시각 포매터를 얻는 많은 클래스 메서드를 제공합니다. 포맷 스타일에는 FULL, LONG, MEDIUM 및 SHORT가 있습니다. 이러한 스타일의 상세와 사용예에 대해서는 메서드의 설명을 참조하십시오.
DateFormat는 모든 로케일의 날짜와 시간에 대해 포맷 및 해석을 지원합니다. 코드는 달, 요일, 달력 포맷, 음력 태양력 등 로케일의 관습과는 완전하게 독립하고 있습니다.
현재의 로케일용으로 날짜와 시간를 포맷 하기 위해서는 다음의 static 팩토리 메서드의 1개를 사용합니다.
myString = DateFormat.getDateInstance(). format(myDate);
복수의 날짜와 시간를 포맷 하는 경우에는 그 포맷을 취득해, 그것을 여러 차례 사용하는 (분)편이 효율적입니다. 이것에 의해 시스템이 로컬의 언어와 나라의 룰을 몇번이나 취득할 필요가 없어집니다.
DateFormat df = DateFormat.getDateInstance();
for (int i = 0; i < myDate.length; ++i) {
output.println(df.format(myDate[i]) + "; ");
}
어느 날 첨부를 다른 로케일에 대해서 포맷 하는 경우에는 getDateInstance()의 호출해에 그 날짜와 시간를 지정합니다.
DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
게다가 해석을 위해서 DateFormat를 사용할 수 있습니다.
myDate = df.parse(myString);
그 나라의 보통 의 날짜와 시간 포맷을 취득하려면, getDateInstance를 사용합니다. 그 밖에도 사용 가능한 static 팩토리 메서드가 있습니다. 그 나라의 시각 포맷을 취득하려면, getTimeInstance를 사용합니다. 날짜와 시간와 시각 포맷을 취득하려면, getDateTimeInstance를 사용합니다. 결과의 길이를 제어하기 위해서 이러한 팩토리 메서드를 다른 옵션으로 건네줄 수가 있습니다 (SHORT 로부터 MEDIUM, LONG, FULL 에). 정확한 결과는 로케일에 의존합니다만, 일반적으로는 다음과 같이 됩니다.
필요에 따라서, 포맷에 타임 존을 설정할 수도 있습니다. 포맷이나 해석을 또한 제어하는 경우 (또는 사용자에 게 그러한 제어를 주는 경우)에는 팩토리 메서드로부터 얻은 DateFormat을 SimpleDateFormat에 캐스트 하는 방법을 시행할 수도 있습니다. 이 방법은 대부분의 나라에 유효합니다만, 그렇지 않은 경우에 대비해, try 블록에 넣도록의해 주세요.
게다가 parse와 format 메서드의 형식을 ParsePosition와 FieldPosition와 함께 사용하면, 다음 일을 할 수 있습니다 .
일자 포맷은 동기화 되지 않습니다. thread 마다 다른 포맷 인스턴스를 작성하는 것을 추천합니다. 복수의 thread가 포맷에 동시에 액세스 하는 경우는 외부적으로 동기화할 필요가 있습니다.
Format,
NumberFormat,
SimpleDateFormat,
Calendar,
GregorianCalendar,
TimeZone,
직렬화 된 형식 | 중첩(Nested) 클래스 개요 | |
|---|---|
static class |
DateFormat.Field
DateFormat.formatToCharacterIterator로
부터 리턴된 AttributedCharacterIterator 내의 속성 키 및 FieldPosition 내의 필드 식별자로서 사용하는 정수를 정의합니다. |
| 필드 개요 | |
|---|---|
static int |
AM_PM_FIELD
AM_PM 필드의 위치 맞춤을 위한 정수입니다. |
protected Calendar |
calendar
일자와 시각의 포맷을 행하기 위한 타임 필드의 값을 생성하기 위해서 DateFormat이 사용하는 달력입니다. |
static int |
DATE_FIELD
DATE 필드의 위치 맞춤을 위한 정수입니다. |
static int |
DAY_OF_WEEK_FIELD
DAY_OF_WEEK 필드의 위치 맞춤을 위한 정수입니다. |
static int |
DAY_OF_WEEK_IN_MONTH_FIELD
DAY_OF_WEEK_IN_MONTH 필드의 위치 맞춤을 위한 정수입니다. |
static int |
DAY_OF_YEAR_FIELD
DAY_OF_YEAR 필드의 위치 맞춤을 위한 정수입니다. |
static int |
DEFAULT
디폴트 스타일 패턴을 위한 정수입니다. |
static int |
ERA_FIELD
ERA 필드의 위치 맞춤을 위한 정수입니다. |
static int |
FULL
전스타일 패턴을 위한 정수입니다. |
static int |
HOUR_OF_DAY0_FIELD
0 로부터 시작되는 HOUR_OF_DAY 필드의 위치 맞춤을 위한 정수입니다. |
static int |
HOUR_OF_DAY1_FIELD
1 로부터 시작되는 HOUR_OF_DAY 필드의 위치 맞춤을 위한 정수입니다. |
static int |
HOUR0_FIELD
0 로부터 시작되는 HOUR 필드의 위치 맞춤을 위한 정수입니다. |
static int |
HOUR1_FIELD
1 로부터 시작되는 HOUR 필드의 위치 맞춤을 위한 정수입니다. |
static int |
LONG
긴 스타일 패턴을 위한 정수입니다. |
static int |
MEDIUM
길이가 중위의 스타일 패턴을 위한 정수입니다. |
static int |
MILLISECOND_FIELD
MILLISECOND 필드의 위치 맞춤을 위한 정수입니다. |
static int |
MINUTE_FIELD
MINUTE 필드의 위치 맞춤을 위한 정수입니다. |
static int |
MONTH_FIELD
MONTH 필드의 위치 맞춤을 위한 정수입니다. |
protected NumberFormat |
numberFormat
일자와 시각의 수치를 포맷 하기 위해서 DateFormat이 사용하는 수치 포매터입니다. |
static int |
SECOND_FIELD
SECOND 필드의 위치 맞춤을 위한 정수입니다. |
static int |
SHORT
짧은 스타일 패턴을 위한 정수입니다. |
static int |
TIMEZONE_FIELD
TIMEZONE 필드의 위치 맞춤을 위한 정수입니다. |
static int |
WEEK_OF_MONTH_FIELD
WEEK_OF_MONTH 필드의 위치 맞춤을 위한 정수입니다. |
static int |
WEEK_OF_YEAR_FIELD
WEEK_OF_YEAR 필드의 위치 맞춤을 위한 정수입니다. |
static int |
YEAR_FIELD
YEAR 필드의 위치 맞춤을 위한 정수입니다. |
| 생성자 개요 | |
|---|---|
protected |
DateFormat ()
새로운 날짜와 시간 포맷을 작성합니다. |
| 메서드 개요 | |
|---|---|
Object |
clone ()
Cloneable를 오버라이드(override) 합니다. |
boolean |
equals (Object obj)
equals를 오버라이드(override) 합니다. |
String |
format (Date date)
Date를 날짜와 시간/시각 캐릭터 라인에 포맷 합니다. |
abstract StringBuffer |
format (Date date,
StringBuffer toAppendTo,
FieldPosition fieldPosition)
Date를 날짜와 시간/시각 캐릭터 라인에 포맷 합니다. |
StringBuffer |
format (Object obj,
StringBuffer toAppendTo,
FieldPosition fieldPosition)
Format를 오버라이드(override) 합니다. |
static Locale [] |
getAvailableLocales ()
이 클래스의 get*Instance 메서드가 지역 대응의 인스턴스를 돌려줄 수 있는 로케일 모든 배열을 리턴합니다. |
Calendar |
getCalendar ()
이 날짜와 시간/시각 포매터에 대응하는 달력을 취득합니다. |
static DateFormat |
getDateInstance ()
디폴트의 로케일에 대해, 디폴트의 포맷 스타일을 가지는 날짜와 시간 포매터를 취득합니다. |
static DateFormat |
getDateInstance (int style)
디폴트의 로케일에 대해, 지정된 포맷 스타일을 가지는 날짜와 시간 포매터를 취득합니다. |
static DateFormat |
getDateInstance (int style,
Locale aLocale)
지정된 로케일에 대해, 지정된 포맷 스타일을 가지는 날짜와 시간 포매터를 취득합니다. |
static DateFormat |
getDateTimeInstance ()
디폴트의 로케일에 대해, 디폴트의 포맷 스타일을 가지는 날짜와 시간/시각 포매터를 취득합니다. |
static DateFormat |
getDateTimeInstance (int dateStyle,
int timeStyle)
디폴트의 로케일에 대해, 지정된 날짜와 시간/시각 포맷 스타일을 가지는 날짜와 시간/시각 포매터를 취득합니다. |
static DateFormat |
getDateTimeInstance (int dateStyle,
int timeStyle,
Locale aLocale)
지정된 로케일에 대해, 지정된 포맷 스타일을 가지는 날짜와 시간/시각 포매터를 취득합니다. |
static DateFormat |
getInstance ()
일자와 시각의 양쪽 모두에 대해 SHORT 스타일을 가지는 날짜와 시간/시각 포매터를 취득합니다. |
NumberFormat |
getNumberFormat ()
시각의 포맷과 해석을 위해서 이 날짜와 시간/시각 포매터가 사용하는 수치 포매터를 취득합니다. |
static DateFormat |
getTimeInstance ()
디폴트의 로케일에 대해, 디폴트의 포맷 스타일을 가질 때 각포매터를 취득합니다. |
static DateFormat |
getTimeInstance (int style)
디폴트의 로케일에 대해, 지정된 포맷 스타일을 가질 때 각포매터를 취득합니다. |
static DateFormat |
getTimeInstance (int style,
Locale aLocale)
지정된 로케일에 대해, 지정된 포맷 스타일을 가질 때 각포매터를 취득합니다. |
TimeZone |
getTimeZone ()
타임 존을 취득합니다. |
int |
hashCode ()
hashCode를 오버라이드(override) 합니다. |
boolean |
isLenient ()
일자/시각의 해석을 엄밀하게 실시할지 어떨지를 판정합니다. |
Date |
parse (String source)
지정된 캐릭터 라인의 선두로부터 텍스트를 해석해 날짜와 시간를 생성합니다. |
abstract Date |
parse (String source,
ParsePosition pos)
지정된 해석 위치에 따라 날짜와 시간/시각 캐릭터 라인을 해석합니다. |
Object |
parseObject (String source,
ParsePosition pos)
캐릭터 라인으로부터 텍스트를 해석해 Date를 생성합니다. |
void |
setCalendar (Calendar newCalendar)
이 날짜와 시간 포맷으로 사용하는 달력을 설정합니다. |
void |
setLenient (boolean lenient)
일자/시각 해석을 엄밀하게 실시할지 어떨지를 설정합니다. |
void |
setNumberFormat (NumberFormat newNumberFormat)
수치 포매터를 설정합니다. |
void |
setTimeZone (TimeZone zone)
이 DateFormat 객체의 달력의 타임 존을 설정합니다. |
| 클래스 java.text. Format 로부터 상속된 메서드 |
|---|
format,
formatToCharacterIterator,
parseObject |
| 클래스 java.lang. Object 로부터 상속된 메서드 |
|---|
finalize,
getClass,
notify,
notifyAll,
toString,
wait,
wait,
wait |
| 필드의 상세 |
|---|
protected Calendar calendar
DateFormat이 사용하는 달력입니다. 서브 클래스는 이 달력을 이 DateFormat에 대응하는 로케일에 적절한 달력에 초기화할 필요가 있습니다.
protected NumberFormat numberFormat
DateFormat이 사용하는 수치 포매터입니다. 서브 클래스는 이 수치 포매터를, 이 DateFormat에 대응하는 로케일에 적절한 수치 포맷에 초기화할 필요가 있습니다.
public static final int ERA_FIELD
public static final int YEAR_FIELD
public static final int MONTH_FIELD
public static final int DATE_FIELD
public static final int HOUR_OF_DAY1_FIELD
public static final int HOUR_OF_DAY0_FIELD
public static final int MINUTE_FIELD
public static final int SECOND_FIELD
public static final int MILLISECOND_FIELD
public static final int DAY_OF_WEEK_FIELD
public static final int DAY_OF_YEAR_FIELD
public static final int DAY_OF_WEEK_IN_MONTH_FIELD
public static final int WEEK_OF_YEAR_FIELD
public static final int WEEK_OF_MONTH_FIELD
public static final int AM_PM_FIELD
public static final int HOUR1_FIELD
public static final int HOUR0_FIELD
public static final int TIMEZONE_FIELD
public static final int FULL
public static final int LONG
public static final int MEDIUM
public static final int SHORT
public static final int DEFAULT
| 생성자 상세 |
|---|
protected DateFormat()
| 메서드의 상세 |
|---|
public final StringBuffer format(Object obj,
StringBuffer toAppendTo,
FieldPosition fieldPosition)
Format 내의 format obj - Number 또는 Date 로 할 필요가 있는toAppendTo - 돌려주고질 때 각캐릭터 라인을 위한 캐릭터 라인 버퍼fieldPosition - 리턴된 캐릭터 라인내의 필드 위치를 파악한다. 입력시는 필요하면 위치 맞춤 필드. 출력시는 위치 맞춤 필드의 오프셋(offset). 예를 들어 「1996.07. 10 AD at 15:08:56 PDT」라고 할 때 각텍스트가 지정되었을 경우에
지정된 fieldPosition가 DateFormat.YEAR_FIELD 이면, fieldPosition
개시 인덱스와 종료 인덱스는 각각 0 으로 4 로 설정된다. 같은 시각 필드가 패턴내에서 여러 차례 나타나는 경우, fieldPosition는 그 때 각필드의 최초의 것으로 설정된다. 예를 들어
패턴 「h a z (zzzz)」라고 위치 맞춤 필드의 DateFormat.TIMEZONE_FIELD를 사용해 Date를 시각 캐릭터 라인 「1 PM PDT (Pacific Daylight Time)」에 포맷 하면, fieldPosition
개시 인덱스와 종료 인덱스는 각각, 최초로 나타난 타임 존 패턴 문자 「z」에 대해서 5 로 8 으로 설정된다
Format
public abstract StringBuffer format(Date date,
StringBuffer toAppendTo,
FieldPosition fieldPosition)
date - 날짜와 시간/시각 캐릭터 라인에 포맷 하는 DatetoAppendTo - 리턴된
날짜와 시간/시각 캐릭터 라인을 위한 캐릭터 라인 버퍼fieldPosition - 리턴된 캐릭터 라인내의 필드 위치를 파악한다. 입력시는 필요하면 위치 맞춤 필드. 출력시는 위치 맞춤 필드의 오프셋(offset). 예를 들어 「1996.07. 10 AD at 15:08:56 PDT」라고 할 때 각텍스트가 지정되었을 경우에
지정된 fieldPosition가 DateFormat.YEAR_FIELD 이면, fieldPosition
개시 인덱스와 종료 인덱스는 각각 0 으로 4 로 설정된다. 같은 시각 필드가 패턴내에서 여러 차례 나타나는 경우, fieldPosition는 그 때 각필드의 최초의 것으로 설정된다. 예를 들어
패턴 「h a z (zzzz)」라고 위치 맞춤 필드의 DateFormat.TIMEZONE_FIELD를 사용해 Date를 시각 캐릭터 라인 「1 PM PDT (Pacific Daylight Time)」에 포맷 하면, fieldPosition
개시 인덱스와 종료 인덱스는 각각, 최초로 나타난 타임 존 패턴 문자 「z」에 대해서 5 로 8 으로 설정된다
public final String format(Date date)
date - 시각 캐릭터 라인에 포맷 할 때 각치
public Date parse(String source)
throws ParseException
일자의 해석에 대한자세한 내용은 parse(String, ParsePosition) 메서드를 참조하십시오.
source - 선두가 해석되는 String
Date
ParseException - 지정된 캐릭터 라인의 선두를 해석할 수 없는 경우
public abstract Date parse(String source,
ParsePosition pos)
기본값에 서는 해석은 엄밀하지는 않습니다. 입력이, 이 객체의 포맷 메서드로 사용되는 형식은 아니지만, 날짜와 시간로서 해석 가능하면, 해석은 정상적으로 행해집니다. 클라이언트는 setLenient(false)를 호출하는 것에의해 이 포맷을 엄밀하게 요구할 수 있습니다.
source - 해석하는 날짜와 시간/시각 캐릭터 라인pos - 입력시는 해석을 개시하는 위치. 출력시는 해석이 종료한 위치, 또는 해석이 실패했을 경우에는 개시 위치
setLenient(boolean)
public Object parseObject(String source,
ParsePosition pos)
Date를 생성합니다.
메서드는 pos에 의해 지정된 인덱스를 개시 위값으로
텍스트의 해석을 시도합니다. 해석이 완료하면, pos
인덱스는 사용된 마지막 문자 (해석에서는 캐릭터 라인의 끝까지의 모든 문자를 사용할 필요는 없다)의 뒤의 인덱스에 갱신되어 해석된 날짜와 시간가 리턴됩니다
. 갱신된 pos는
이 메서드의 다음의 호출의 개시점을 나타내는데 사용할 수 있습니다. 에러가 발생했을 경우는 pos
인덱스는 변경되지 않고, 에러가 발생한 문자의 인덱스에 pos
에러 인덱스가 설정되어 null이 리턴됩니다
.
일자의 해석에 대한자세한 내용은 parse(String, ParsePosition) 메서드를 참조하십시오.
Format 내의 parseObject source - 부분적으로 해석되는 Stringpos - 상기의 인덱스 및 에러 인덱스 정보를 가지는 ParsePosition 객체
Date. 에러의 경우는 null
NullPointerException - pos가 null인 경우public static final DateFormat getTimeInstance()
public static final DateFormat getTimeInstance(int style)
style - 지정하는 포맷 스타일. 예를 들어
US 로케일에서의 "h:mm a"에 대한 SHORT
public static final DateFormat getTimeInstance(int style,
Locale aLocale)
style - 지정하는 포맷 스타일. 예를 들어
US 로케일에서의 "h:mm a"에 대한 SHORTaLocale - 지정된 로케일
public static final DateFormat getDateInstance()
public static final DateFormat getDateInstance(int style)
style - 지정하는 포맷 스타일. 예를 들어
US 로케일에서의 "M/d/yy"에 대한 SHORT
public static final DateFormat getDateInstance(int style,
Locale aLocale)
style - 지정하는 포맷 스타일. 예를 들어
US 로케일에서의 "M/d/yy"에 대한 SHORTaLocale - 지정된 로케일
public static final DateFormat getDateTimeInstance()
public static final DateFormat getDateTimeInstance(int dateStyle,
int timeStyle)
dateStyle - 지정하는 날짜와 시간 포맷 스타일. 예를 들어
US 로케일에서의 "M/d/yy"에 대한 SHORTtimeStyle - 지정할 때 각포맷 스타일. 예를 들어
US 로케일에서의 "h:mm a"에 대한 SHORT
public static final DateFormat getDateTimeInstance(int dateStyle,
int timeStyle,
Locale aLocale)
dateStyle - 지정하는 날짜와 시간 포맷 스타일timeStyle - 지정할 때 각포맷 스타일aLocale - 지정된 로케일
public static final DateFormat getInstance()
public static Locale [] getAvailableLocales()
get*Instance 메서드가 지역 대응의 인스턴스를 돌려줄 수 있는 로케일 모든 배열을 리턴합니다. 리턴된
배열은 최저한 Locale.US에 동일한 Locale인스턴스를 포함하고 있을 필요가 있습니다.
DateFormat인스턴스를 사용 가능한 로케일의 배열public void setCalendar(Calendar newCalendar)
newCalendar - 날짜와 시간 포맷으로 사용하는 새로운 Calendarpublic Calendar getCalendar()
public void setNumberFormat(NumberFormat newNumberFormat)
newNumberFormat - 지정하는 새로운 NumberFormatpublic NumberFormat getNumberFormat()
public void setTimeZone(TimeZone zone)
zone - 지정하는 새로운 타임 존public TimeZone getTimeZone()
public void setLenient(boolean lenient)
lenient - true인 경우는 엄밀하지 않는 해석Calendar.setLenient(boolean) public boolean isLenient()
public int hashCode()
Object 내의 hashCode Object.equals(java.lang.Object),
Hashtable public boolean equals(Object obj)
Object 내의 equals obj - 비교 대상의 참조 객체
true, 그렇지 않은 경우는 falseObject.hashCode(),
Hashtable public Object clone()
Format 내의 clone Cloneable
|
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 도 참조하십시오.