java.text
클래스 DateFormat

java.lang.Object 
  |
  +--java.text.Format 
        |
        +--java.text.DateFormat

모든 구현 인터페이스:

Cloneable , Serializable

직계의 기존의 서브 클래스:

SimpleDateFormat

public abstract class DateFormat

extends Format

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 < a.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 에). 정확한 결과는 로케일에 의존합니다만, 일반적으로는 다음과 같이 됩니다.

• SHORT 는 모두 수치로, 12.13. 52 나 3:30pm 등
• MEDIUM 는 그것보다 긴 형식에서, Jan 12, 1952 등
• LONG 는 한층 더 긴 형식에서, January 12, 1952 나 3:30:32pm 등
• FULL 는 거의 완전하게 지정하는 형식에서, Tuesday, April 12, 1952 AD 나 3:30:42pm PST 등

필요에 따라서, 포맷에 타임 존을 설정할 수도 있습니다. 포맷이나 해석을 한층 더 제어하는 경우 (또는 유저에게 그러한 제어를 주는 경우)에는 팩토리 메소드로부터 얻은 DateFormat 을 SimpleDateFormat 에 캐스트 하는 방법을 시행할 수도 있습니다. 이 방법은 대부분의 나라에 유효합니다만, 그렇지 않은 경우에 대비해, try 블록에 넣도록 해 주세요.

게다가 parse 와 format 메소드의 형식을 ParsePosition 와 FieldPosition 와 함께 사용하면, 다음 일 을 할 수가 있습니다.

• 캐릭터 라인의 각각의 부분을 단계적으로 해석한다
• 특정의 필드를 위치 맞춤 하거나 화면상의 어디가 선택 상태인가를 조사한다

동기

date 포맷은 동기화 되지 않습니다. thread 마다 다른 포맷 인스턴스를 작성하는 것을 추천합니다. 복수의 thread가 포맷에 동시에 액세스 하는 경우는 외부적으로 동기화할 필요가 있습니다.

관련 항목:

Format , NumberFormat , SimpleDateFormat , Calendar , GregorianCalendar , TimeZone , 직렬화 된 형식

중첩된 클래스의 개요

static class

DateFormat.Field DateFormat.formatToCharacterIterator 로부터 돌려주어진 AttributedCharacterIterator 내의 속성 키, 및 FieldPosition 내의 필드 식별자로서 사용하는 정수를 정의합니다.

클래스 java.text. Format 을 상속받은 중첩된 클래스

필드의 개요

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 () DateFormat 가 도입되고 있는 로케일 세트를 취득합니다.
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

필드의 상세

calendar

protected Calendar  calendar

일자와 시각의 포맷을 행하기 위한 타임 필드의 값을 생성하기 위해서 DateFormat 가 사용하는 달력입니다. 서브 클래스는 이 달력을, 이 DateFormat 에 대응하는 로케일에 적절한 달력에 초기화할 필요가 있습니다.

numberFormat

protected NumberFormat  numberFormat

일자와 시각의 수치를 포맷 하기 위해서 DateFormat 가 사용하는 수치 포매터입니다. 서브 클래스는 이 수치 포매터를, 이 DateFormat 에 대응하는 로케일에 적절한 수치 포맷에 초기화할 필요가 있습니다.

ERA_FIELD

public static final int ERA_FIELD

ERA 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

YEAR_FIELD

public static final int YEAR_FIELD

YEAR 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

MONTH_FIELD

public static final int MONTH_FIELD

MONTH 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

DATE_FIELD

public static final int DATE_FIELD

DATE 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

HOUR_OF_DAY1_FIELD

public static final int HOUR_OF_DAY1_FIELD

1 으로부터 시작되는 HOUR_OF_DAY 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다. HOUR_OF_DAY1_FIELD 는 1 으로부터 시작되는 24 시간 시계로 사용합니다. 예를 들어,23:59 + 01:00 는 24:59 됩니다.

관련 항목:

정수 필드치

HOUR_OF_DAY0_FIELD

public static final int HOUR_OF_DAY0_FIELD

0 으로부터 시작되는 HOUR_OF_DAY 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다. HOUR_OF_DAY0_FIELD 는 0 으로부터 시작되는 24 시간 시계로 사용합니다. 예를 들어,23:59 + 01:00 는 00:59 됩니다.

관련 항목:

정수 필드치

MINUTE_FIELD

public static final int MINUTE_FIELD

MINUTE 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

SECOND_FIELD

public static final int SECOND_FIELD

SECOND 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

MILLISECOND_FIELD

public static final int MILLISECOND_FIELD

MILLISECOND 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

DAY_OF_WEEK_FIELD

public static final int DAY_OF_WEEK_FIELD

DAY_OF_WEEK 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

DAY_OF_YEAR_FIELD

public static final int DAY_OF_YEAR_FIELD

DAY_OF_YEAR 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

DAY_OF_WEEK_IN_MONTH_FIELD

public static final int DAY_OF_WEEK_IN_MONTH_FIELD

DAY_OF_WEEK_IN_MONTH 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

WEEK_OF_YEAR_FIELD

public static final int WEEK_OF_YEAR_FIELD

WEEK_OF_YEAR 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

WEEK_OF_MONTH_FIELD

public static final int WEEK_OF_MONTH_FIELD

WEEK_OF_MONTH 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

AM_PM_FIELD

public static final int AM_PM_FIELD

AM_PM 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

HOUR1_FIELD

public static final int HOUR1_FIELD

1 으로부터 시작되는 HOUR 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다. HOUR1_FIELD 는 1 으로부터 시작되는 12 시간 시계로 사용합니다. 예를 들어,11:30 PM + 1 시간은 12:30 AM 가 됩니다.

관련 항목:

정수 필드치

HOUR0_FIELD

public static final int HOUR0_FIELD

0 으로부터 시작되는 HOUR 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다. HOUR0_FIELD 는 0 으로부터 시작되는 12 시간 시계로 사용합니다. 예를 들어,11:30 PM + 1 시간은 00:30 AM 가 됩니다.

관련 항목:

정수 필드치

TIMEZONE_FIELD

public static final int TIMEZONE_FIELD

TIMEZONE 필드의 위치 맞춤을 위한 정수입니다. 일자/시각 포맷 기능의 FieldPosition 로 사용합니다.

관련 항목:

정수 필드치

FULL

public static final int FULL

전스타일 패턴을 위한 정수입니다.

관련 항목:

정수 필드치

LONG

public static final int LONG

긴 스타일 패턴을 위한 정수입니다.

관련 항목:

정수 필드치

MEDIUM

public static final int MEDIUM

길이가 중위의 스타일 패턴을 위한 정수입니다.

관련 항목:

정수 필드치

SHORT

public static final int SHORT

짧은 스타일 패턴을 위한 정수입니다.

관련 항목:

정수 필드치

DEFAULT

public static final int DEFAULT

디폴트 스타일 패턴을 위한 정수입니다. 값은 MEDIUM 입니다.

관련 항목:

정수 필드치

생성자의 상세

DateFormat

protected DateFormat()

새로운 일자 포맷을 작성합니다.

메소드의 상세

format

public final StringBuffer  format(Object  obj,
                                 StringBuffer  toAppendTo,
                                 FieldPosition  fieldPosition)

Format 를 오버라이드(override) 합니다. 시각 오브젝트를 시각 캐릭터 라인에 포맷 합니다. 시각 오브젝트의 예로서는 밀리 세컨드와 Date 오브젝트로 나타낼 때 각치가 있습니다.

정의:

클래스 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

format

public abstract StringBuffer  format(Date  date,
                                    StringBuffer  toAppendTo,
                                    FieldPosition  fieldPosition)

Date 를 일자/시각 캐릭터 라인에 포맷 합니다.

파라미터:

date - 일자/시각 캐릭터 라인에 포맷 하는 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 final String  format(Date  date)

Date 를 일자/시각 캐릭터 라인에 포맷 합니다.

파라미터:

date - 시각 캐릭터 라인에 포맷 할 때 각치

반환값:

포맷 되었을 때 각캐릭터 라인

parse

public Date  parse(String  source)
           throws ParseException 

지정된 캐릭터 라인의 선두로부터 텍스트를 해석해 일자를 생성합니다. 메소드는 지정된 캐릭터 라인의 텍스트 전체에 사용되지 않는 경우도 있습니다.

일자의 해석에 대한 자세한 것은 parse(String, ParsePosition) 를 참조해 주세요.

파라미터:

source - 선두가 해석되는 String

반환값:

캐릭터 라인으로부터 해석되는 Date

예외:

ParseException - 지정된 캐릭터 라인의 선두를 해석할 수 없는 경우

parse

public abstract Date  parse(String  source,
                           ParsePosition  pos)

지정된 해석 위치에 따라 일자/시각 캐릭터 라인을 해석합니다. 예를 들어, 시각 텍스트 「07/10/96 4:5 PM, PDT」가, Date(837039928046)와 동등한 Date 에 해석됩니다.

디폴트 값에서는 해석은 엄밀하지는 않습니다. 입력이, 이 오브젝트의 포맷 메소드로 사용되는 형식은 아니지만, 일자로서 해석 가능하면, 해석은 정상적으로 행해집니다. 클라이언트는 setLenient(false)를 호출하는 것에 의해, 이 포맷을 엄밀하게 요구할 수 있습니다.

파라미터:

source - 해석하는 일자/시각 캐릭터 라인

pos - 입력시는 해석을 개시하는 위치. 출력시는 해석이 종료한 위치, 또는 해석이 실패했을 경우에는 개시 위치

반환값:

Date. 입력 해석을 할 수 없는 경우는 null

관련 항목:

setLenient(boolean)

parseObject

public Object  parseObject(String  source,
                          ParsePosition  pos)

캐릭터 라인으로부터 텍스트를 해석해 Date 를 생성합니다.

메소드는 pos 에 의해 지정된 인덱스를 개시 위치로서 텍스트의 해석을 시도합니다. 해석이 완료하면(자),pos 의 인덱스는 사용된 마지막 캐릭터 (해석에서는 캐릭터 라인의 끝까지의 모든 캐릭터가 사용된다고는 할 수 없다)의 뒤의 인덱스에 갱신되어 해석된 일자가 돌려주어집니다. 갱신된 pos 는 이 메소드의 다음의 호출의 개시점을 나타내는데 사용할 수 있습니다. 에러가 발생했을 경우는 pos 의 인덱스는 변경되지 않고 에러가 발생한 캐릭터의 인덱스에 pos 의 에러 인덱스가 설정되어 null 가 돌려주어집니다.

일자의 해석에 대한 자세한 것은 parse(String, ParsePosition) 를 참조해 주세요.

정의:

클래스 Format 내의 parseObject

파라미터:

source - 부분적으로 해석되는 String

pos - 상기의 인덱스 및 에러 인덱스 정보를 가지는 ParsePosition 오브젝트

반환값:

캐릭터 라인으로부터 해석된 Date. 에러의 경우는 null 를 돌려준다

예외:

NullPointerException - pos 가 null 의 경우

getTimeInstance

public static final DateFormat  getTimeInstance()

디폴트의 로케일에 대해, 디폴트의 포맷 스타일을 가질 때 각포매터를 취득합니다.

반환값:

시각 포매터

getTimeInstance

public static final DateFormat  getTimeInstance(int style)

디폴트의 로케일에 대해, 지정된 포맷 스타일을 가질 때 각포매터를 취득합니다.

파라미터:

style - 지정하는 포맷 스타일. 예를 들어, US 로케일에서의 "h:mm a" 에 대한 SHORT

반환값:

시각 포매터

getTimeInstance

public static final DateFormat  getTimeInstance(int style,
                                               Locale  aLocale)

지정된 로케일에 대해, 지정된 포맷 스타일을 가질 때 각포매터를 취득합니다.

파라미터:

style - 지정하는 포맷 스타일. 예를 들어, US 로케일에서의 "h:mm a" 에 대한 SHORT

aLocale - 지정된 로케일

반환값:

시각 포매터

getDateInstance

public static final DateFormat  getDateInstance()

디폴트의 로케일에 대해, 디폴트의 포맷 스타일을 가지는 일자 포매터를 취득합니다.

반환값:

일자 포매터

getDateInstance

public static final DateFormat  getDateInstance(int style)

디폴트의 로케일에 대해, 지정된 포맷 스타일을 가지는 일자 포매터를 취득합니다.

파라미터:

style - 지정하는 포맷 스타일. 예를 들어, US 로케일에서의 "M/d/yy" 에 대한 SHORT

반환값:

일자 포매터

getDateInstance

public static final DateFormat  getDateInstance(int style,
                                               Locale  aLocale)

지정된 로케일에 대해, 지정된 포맷 스타일을 가지는 일자 포매터를 취득합니다.

파라미터:

style - 지정하는 포맷 스타일. 예를 들어, US 로케일에서의 "M/d/yy" 에 대한 SHORT

aLocale - 지정된 로케일

반환값:

일자 포매터

getDateTimeInstance

public static final DateFormat  getDateTimeInstance()

디폴트의 로케일에 대해, 디폴트의 포맷 스타일을 가지는 일자/시각 포매터를 취득합니다.

반환값:

일자/시각 포매터

getDateTimeInstance

public static final DateFormat  getDateTimeInstance(int dateStyle,
                                                   int timeStyle)

디폴트의 로케일에 대해, 지정된 일자/시각 포맷 스타일을 가지는 일자/시각 포매터를 취득합니다.

파라미터:

dateStyle - 지정하는 일자 포맷 스타일. 예를 들어, US 로케일에서의 "M/d/yy" 에 대한 SHORT

timeStyle - 지정할 때 각포맷 스타일. 예를 들어, US 로케일에서의 "h:mm a" 에 대한 SHORT

반환값:

일자/시각 포매터

getDateTimeInstance

public static final DateFormat  getDateTimeInstance(int dateStyle,
                                                   int timeStyle,
                                                   Locale  aLocale)

지정된 로케일에 대해, 지정된 포맷 스타일을 가지는 일자/시각 포매터를 취득합니다.

파라미터:

dateStyle - 지정하는 일자 포맷 스타일

timeStyle - 지정할 때 각포맷 스타일

aLocale - 지정된 로케일

반환값:

일자/시각 포매터

getInstance

public static final DateFormat  getInstance()

일자와 시각의 양쪽 모두에 대해 SHORT 스타일을 가지는 일자/시각 포매터를 취득합니다.

getAvailableLocales

public static Locale [] getAvailableLocales()

DateFormat 가 도입되고 있는 로케일 세트를 취득합니다.

반환값:

DateFormat 가 도입되고 있는 로케일 세트

setCalendar

public void setCalendar(Calendar  newCalendar)

이 일자 포맷으로 사용하는 달력을 설정합니다. 처음은 지정된 로케일 또는 디폴트의 로케일에 대해, 디폴트의 달력이 사용됩니다.

파라미터:

newCalendar - 일자 포맷으로 사용하는 새로운 Calendar

getCalendar

public Calendar  getCalendar()

이 일자/시각 포매터에 대응하는 달력을 취득합니다.

반환값:

이 일자/시각 포매터에 대응하는 달력

setNumberFormat

public void setNumberFormat(NumberFormat  newNumberFormat)

수치 포매터를 설정합니다.

파라미터:

newNumberFormat - 지정하는 새로운 NumberFormat

getNumberFormat

public NumberFormat  getNumberFormat()

시각의 포맷과 해석을 위해서(때문에) 이 일자/시각 포매터가 사용하는 수치 포매터를 취득합니다.

반환값:

이 일자/시각 포매터가 사용하는 수치 포매터

setTimeZone

public void setTimeZone(TimeZone  zone)

이 DateFormat 오브젝트의 달력의 타임 존을 설정합니다.

파라미터:

zone - 지정하는 새로운 타임 존

getTimeZone

public TimeZone  getTimeZone()

타임 존을 취득합니다.

반환값:

DateFormat 의 달력에 대응하는 타임 존

setLenient

public void setLenient(boolean lenient)

일자/시각 해석을 엄밀하게 실시할지 어떨지를 설정합니다. 엄밀하지 않은 해석에서는 해석 기능은 발견적인 방법을 사용해, 이 오브젝트의 포맷과 완전하게는 일치하지 않는 입력을 해석하는 일이 있습니다. 엄밀한 해석에서는 입력은 이 오브젝트의 포맷과 일치하지 않으면 안됩니다.

파라미터:

lenient - true 의 경우는 엄밀하지 않는 해석

관련 항목:

Calendar.setLenient(boolean)

isLenient

public boolean isLenient()

일자/시각의 해석을 엄밀하게 실시할지 어떨지를 판정합니다.

hashCode

public int hashCode()

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

오버라이드(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

clone

public Object  clone()

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

오버라이드(override):

클래스 Format 내의 clone

반환값:

이 인스턴스의 복제