java.text
클래스 SimpleDateFormat

java.lang.Object 
  java.text.Format 
      java.text.DateFormat 
          java.text.SimpleDateFormat

모든 구현된 인터페이스:

Serializable, Cloneable

public class SimpleDateFormat
extends DateFormat 

SimpleDateFormat는 날짜와 시간의 포맷과 해석을 로케일을 고려해 실시하기 위한 구상 클래스입니다. 이것에 의해 포맷 (일자 -> 텍스트), 해석 (텍스트 -> 날짜와 시간) 및 정규화를 실시할 수 있습니다 .

SimpleDateFormat를 사용하면, 날짜와 시간 시각 포맷의 사용자 정의 패턴을 선택하는 것에 의해 우선 사용을 개시할 수 있습니다 . 그러나, 가능한 한, DateFormat getTimeInstance, getDateInstance, 또는 getDateTimeInstance로 날짜와 시간 시각 포매터를 작성하도록의해 주세요. 이러한 클래스 메서드는 모두, 디폴트 포맷 패턴으로 초기화된 날짜와 시간 시각 포매터를 돌려줄 수가 있습니다. 포맷 패턴은 필요에 따라서, applyPattern 메서드를 사용해 수정할 수 있습니다 . 이러한 메서드의 사용법에 대해서는 DateFormat를 참조하십시오.

일자/시각 패턴

일자/시각 포맷은 「일자/시각 패턴」캐릭터 라인으로 지정됩니다. 날짜와 시간/시각 패턴 캐릭터 라인내에서는 인용부호로 둘러싸이지 않은 'A' ~ 'Z' 및 'a' ~ 'z'는 날짜와 시간 또는 시각 캐릭터 라인의 컴퍼넌트를 나타내는 패턴 문자로서 해석됩니다. 텍스트는 단일 인용부호 (')로 둘러싸는 것으로 해석을 회피할 수 있습니다. 「''」는 단일 인용부호를 나타냅니다. 다른 모든 문자는 해석되지 않고, 포맷중에 출력 캐릭터 라인에 단순하게 카피되는지, 해석중에 입력 캐릭터 라인에 대해서 일치 당합니다.

다음의 패턴 문자가 정의됩니다. (다른 'A' ~ 'Z' 및 'a' ~ 'z' 모든 문자는 예약이 끝난)

문자	일자 또는 시각의 컴퍼넌트	표시	예
G	기원	텍스트	AD
y	연	연	1996; 96
M	월	월	July; Jul; 07
w	년에 있어서의 주	수치	27
W	월에 있어서의 주	수치	2
D	년에 있어서의 날	수치	189
d	월에 있어서의 날	수치	10
F	월에 있어서의 요일	수치	2
E	요일	텍스트	Tuesday; Tue
a	오전/오후	텍스트	PM
H	1 일에 있어서의 때 (0 ~ 23)	수치	0
k	1 일에 있어서의 때 (1 ~ 24)	수치	24
K	오전/오후때 (0 ~ 11)	수치	0
h	오전/오후때 (1 ~ 12)	수치	12
m	분	수치	30
s	초	수치	55
S	밀리 세컨드	수치	978
z	타임 존	일반적인 타임 존	Pacific Standard Time; PST; GMT-08:00
Z	타임 존	RFC 822 타임 존	-0800

패턴 문자는 그 수로 정확한 표현이 정해지기 때문에 보통 반복해집니다.

• 텍스트: 패턴 문자의 수가 4 이상의 경우, 포맷에는 풀 형식을 사용합니다. 그렇지 않은 경우, 짧은 형식 또는 생략 된 형식이 있으면, 그것을 사용합니다. 해석에는 패턴 문자의 수치에 관계없이, 어느 쪽의 형식도 받아들일 수 있습니다.
• 수치: 포맷에는 패턴 문자의 수는 최소 자리수가 됩니다. 이것보다 짧은 수치는 이 자리수까지 제로가 추가됩니다. 해석에는 2개의 인접하는 필드를 단락지을 필요가 없는 한, 패턴 문자의 수는 무시됩니다.
• 해: 패턴 문자의 수가 2인 경우, 포맷에는 해가 2 자리수에 단축됩니다. 그렇지 않은 경우는 수치로서 해석됩니다.

  해석에는 패턴 문자의 수가 2 이상의 경우, 해는 자리수에 관계없이 문자대로 해석됩니다. 「MM/dd/yyyy」의 패턴을 이용하면, 「01/11/12」은 A.D. 12 년 1 월 11 일로 해석됩니다.

  단축년 패턴 ( 「y」또는 「yy」)으로 해석할 때는 SimpleDateFormat는 특정의 세기에 맞추어 단축년을 해석할 필요가 있습니다. 이 해석은, SimpleDateFormat 인스턴스의 생성전의 80 년 이내로부터 생성 후의 20 년 이내에 날짜와 시간를 조정하는 것에 의해 행해집니다. 예를 들어 「MM/dd/yy」의 패턴과 1997 년 1 월 1 일에 생성된 SimpleDateFormat 인스턴스를 사용하면, 「01/11/12」이라고 하는 캐릭터 라인은 2012 년 1 월 11 일로 해석되어 「05/04/64」이라고 하는 캐릭터 라인은 1964 년 5 월 4 일로 해석됩니다. 해석중은, Character.isDigit(char) 로 정의된 2 자리수를 포함한 캐릭터 라인만이 디폴트의 세기에 해석됩니다. 1 자리수의 캐릭터 라인, 3 자리수 이상의 캐릭터 라인, 혹은 수치 이외를 포함한 2 자리수의 캐릭터 라인 (-1 등)이라고 하는 그 외의 수치 캐릭터 라인은 문자대로 해석됩니다. 즉, 같은 패턴을 이용해 「01/02/3」또는 「01/02/003」을 해석하면, A.D. 3 년 1 월 2 일이 됩니다. 같이 「01/02/-3」은 B.C. 4 년 1 월 2 일로 해석됩니다.

• 달: 패턴 문자의 수가 3 이상의 경우, 포맷에는 달이텍스트로서 해석됩니다. 그렇지 않은 경우는 수치로서 해석됩니다.
• 일반적인 타임 존: 타임 존에 이름이 있는 경우, 텍스트로서 해석됩니다. GMT 오프셋(offset)치를 나타내는 타임 존에는 다음의 구문이 사용됩니다.

   GMTOffsetTimeZone:  GMT Sign Hours : Minutes Sign: one of + - Hours: Digit Digit Digit Minutes: Digit Digit Digit: one of 0 1 2 3 4 5 6 7 8 9

  시는 0 ~ 23, 분은 00 ~ 59 입니다. 포맷은 로케일에 존하지 않고, 숫자는 Unicode 표준의 Basic Latin 블록의 숫자가 아니면 안됩니다.

  해석에는 RFC 822 타임 존도 받아들일 수 있습니다.

• RFC 822 타임 존: 포맷에는 RFC 822 4 자리수 타임 존 형식이 사용됩니다.

   RFC822TimeZone: Sign TwoDigitHours Minutes TwoDigitHours: Digit Digit

  TwoDigitHours는 00 ~ 23 입니다. 다른 정의는일반적인 타임 존과 같습니다.

  해석에는 일반적인 타임 존도 받아들일 수 있습니다.

SimpleDateFormat는 「지역 대응된 날짜와 시간/시각 패턴」캐릭터 라인도 지원 합니다. 이 캐릭터 라인에서는 전술한 패턴 문자는 로케일 존의 다른 문자 패턴으로 옮겨집니다. SimpleDateFormat는 패턴 문자 이외의 텍스트의 지역 대응을 실시하지 않습니다. 이 지역 대응은 클래스의 클라이언트에 합니다.

례

다음의 예에 U.S. 로케일로 날짜와 시간/시각 패턴이 어떻게 해석되는지를 나타냅니다. 지정된 날짜와 시간와 시각은 U.S. Pacific Time 타임 존의 로컬 타임 2001 년 7 월 4 일 12 시 8 분 56 초입니다.

일자/시각 패턴	결과
「yyyy.MM.dd G 'at' HH:mm:ss z」	2001.07. 04 AD at 12:08:56 PDT
「EEE, MMM d, ''yy」	Wed, Jul 4, '01
「h:mm a」	12:08 PM
「hh 'o''clock' a, zzzz」	12 o'clock PM, Pacific Daylight Time
「K:mm a, z」	0:08 PM, PDT
「yyyyy.MMMMM.dd GGG hh:mm aaa」	02001. July. 04 AD 12:08 PM
「EEE, d MMM yyyy HH:mm:ss Z」	Wed, 4 Jul 2001 12:08:56 -0700
「yyMMddHHmmssZ」	010704120856-0700
「yyyy-MM-dd'T'HH:mm:ss.SSSZ」	2001-07-04T12:08:56. 235-0700

동기

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

관련 항목:

Java Tutorial, Calendar, TimeZone, DateFormat, DateFormatSymbols, 직렬화 된 형식

중첩(Nested) 클래스 개요

클래스 java.text. DateFormat 로부터 상속된 중첩(Nested) 클래스/인터페이스

DateFormat.Field

필드 개요

클래스 java.text. DateFormat 로부터 상속된 필드

AM_PM_FIELD, calendar, DATE_FIELD, DAY_OF_WEEK_FIELD, DAY_OF_WEEK_IN_MONTH_FIELD, DAY_OF_YEAR_FIELD, DEFAULT, ERA_FIELD, FULL, HOUR_OF_DAY0_FIELD, HOUR_OF_DAY1_FIELD, HOUR0_FIELD, HOUR1_FIELD, LONG, MEDIUM, MILLISECOND_FIELD, MINUTE_FIELD, MONTH_FIELD, numberFormat, SECOND_FIELD, SHORT, TIMEZONE_FIELD, WEEK_OF_MONTH_FIELD, WEEK_OF_YEAR_FIELD, YEAR_FIELD

생성자 개요

SimpleDateFormat ()
디폴트 로케일의 디폴트 패턴과 날짜와 시간 포맷 기호를 사용해 SimpleDateFormat를 구축합니다.

SimpleDateFormat (String pattern)
지정된 패턴과 디폴트 로케일의 디폴트 날짜와 시간 포맷 기호를 사용해 SimpleDateFormat를 구축합니다.

SimpleDateFormat (String pattern, DateFormatSymbols formatSymbols)
지정된 패턴과 날짜와 시간 포맷 기호를 사용해 SimpleDateFormat를 구축합니다.

SimpleDateFormat (String pattern, Locale locale)
지정된 패턴과 지정된 로케일의 디폴트 날짜와 시간 포맷 기호를 사용해 SimpleDateFormat를 구축합니다.

메서드 개요

void	applyLocalizedPattern (String pattern) 지정된 지역 대응된 패턴 캐릭터 라인을 이 날짜와 시간 포맷에 적용합니다.
void	applyPattern (String pattern) 지정된 패턴 캐릭터 라인을 이 날짜와 시간 포맷에 적용합니다.
Object	clone () 이 SimpleDateFormat 복사본을 작성합니다.
boolean	equals (Object obj) 지정된 객체와 이 SimpleDateFormat이 동일한지 어떤지를 비교합니다.
StringBuffer	format (Date date, StringBuffer toAppendTo, FieldPosition pos) 지정된 Date를 날짜와 시간/시각 캐릭터 라인에 포맷 해, 지정된 StringBuffer에 결과를 추가합니다.
AttributedCharacterIterator	formatToCharacterIterator (Object obj) Object를 포맷 해, AttributedCharacterIterator를 생성합니다.
Date	get2DigitYearStart () 2 형년이 속한다고 해석되는 100 년간의 개시 날짜와 시간를 리턴합니다.
DateFormatSymbols	getDateFormatSymbols () 이 날짜와 시간 포맷의, 날짜와 시간와 시각의 포맷 기호의 복사본을 취득합니다.
int	hashCode () 이 SimpleDateFormat 객체의 해시 코드값을 리턴합니다.
Date	parse (String text, ParsePosition pos) 캐릭터 라인으로부터 텍스트를 해석해 Date를 생성합니다.
void	set2DigitYearStart (Date startDate) 2 형년이 속한다고 해석되는 100 년간을 사용자가 지정하는 날짜와 시간로부터 시작되도록 설정합니다.
void	setDateFormatSymbols (DateFormatSymbols newFormatSymbols) 이 날짜와 시간 포맷의, 날짜와 시간와 시각의 포맷 기호를 설정합니다.
String	toLocalizedPattern () 이 날짜와 시간 포맷의 지역 대응된 패턴 캐릭터 라인을 리턴합니다.
String	toPattern () 이 날짜와 시간 포맷을 기술하는 패턴 캐릭터 라인을 리턴합니다.

클래스 java.text. DateFormat 로부터 상속된 메서드

format, format, getAvailableLocales, getCalendar, getDateInstance, getDateInstance, getDateInstance, getDateTimeInstance, getDateTimeInstance, getDateTimeInstance, getInstance, getNumberFormat, getTimeInstance, getTimeInstance, getTimeInstance, getTimeZone, isLenient, parse, parseObject, setCalendar, setLenient, setNumberFormat, setTimeZone

클래스 java.text. Format 로부터 상속된 메서드

format, parseObject

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

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

생성자 상세

SimpleDateFormat

public SimpleDateFormat()

디폴트 로케일의 디폴트 패턴과 날짜와 시간 포맷 기호를 사용해 SimpleDateFormat를 구축합니다. 주: 이 생성자는 모든 로케일을 지원하는 것은 아닙니다. 모든 것을 커버하려면, DateFormat 클래스의 팩토리 메서드를 사용해 주세요.

SimpleDateFormat

public SimpleDateFormat(String  pattern)

지정된 패턴과 디폴트 로케일의 디폴트 날짜와 시간 포맷 기호를 사용해 SimpleDateFormat를 구축합니다. 주: 이 생성자는 모든 로케일을 지원하는 것은 아닙니다. 모든 것을 커버하려면, DateFormat 클래스의 팩토리 메서드를 사용해 주세요.

파라미터:

pattern - 날짜와 시간와 시각의 포맷을 기술하는 패턴

예외:

NullPointerException - 지정된 패턴이 null인 경우

IllegalArgumentException - 지정된 패턴이 올바르지 않은 경우

SimpleDateFormat

public SimpleDateFormat(String  pattern,
                        Locale  locale)

지정된 패턴과 지정된 로케일의 디폴트 날짜와 시간 포맷 기호를 사용해 SimpleDateFormat를 구축합니다. 주: 이 생성자는 모든 로케일을 지원하는 것은 아닙니다. 모든 것을 커버하려면, DateFormat 클래스의 팩토리 메서드를 사용해 주세요.

파라미터:

pattern - 날짜와 시간와 시각의 포맷을 기술하는 패턴

locale - 날짜와 시간 포맷 기호를 사용하는 로케일

예외:

NullPointerException - 지정된 패턴이 null인 경우

IllegalArgumentException - 지정된 패턴이 올바르지 않은 경우

SimpleDateFormat

public SimpleDateFormat(String  pattern,
                        DateFormatSymbols  formatSymbols)

지정된 패턴과 날짜와 시간 포맷 기호를 사용해 SimpleDateFormat를 구축합니다.

파라미터:

pattern - 날짜와 시간와 시각의 포맷을 기술하는 패턴

formatSymbols - 포맷에 사용하는 날짜와 시간 포맷 기호

예외:

NullPointerException - 지정된 패턴 또는 formatSymbols가 null인 경우

IllegalArgumentException - 지정된 패턴이 올바르지 않은 경우

메서드의 상세

set2DigitYearStart

public void set2DigitYearStart(Date  startDate)

2 자리수년이 속한다고 해석되는 100 년간을 사용자가 지정하는 날짜와 시간로부터 시작되도록 설정합니다.

파라미터:

startDate - 해석중, 2 자리수년은 startDate ~ startDate + 100 years 범위에 배치되는

도입된 버전 :

1.2

관련 항목:

get2DigitYearStart()

get2DigitYearStart

public Date  get2DigitYearStart()

2 자리수년이 속한다고 해석되는 100 년간의 개시 날짜와 시간를 리턴합니다.

반환값:

2 자리수년이 해석되는 100 년간의 시작

도입된 버전 :

1.2

관련 항목:

set2DigitYearStart(java.util.Date)

format

public StringBuffer  format(Date  date,
                           StringBuffer  toAppendTo,
                           FieldPosition  pos)

지정된 Date를 날짜와 시간/시각 캐릭터 라인에 포맷 해, 지정된 StringBuffer에 결과를 추가합니다.

정의:

클래스 DateFormat 내의 format

파라미터:

date - 날짜와 시간/시각 캐릭터 라인에 포맷 하는 날짜와 시간/시각치

toAppendTo - 새로운 날짜와 시간/시각 텍스트를 추가하는 위치

pos - 포맷 하는 위치. 입력으로는 필요하면 위치 맞춤 필드. 출력으로는 그 위치 맞춤 필드의 오프셋(offset)

반환값:

포맷된 날짜와 시간/시각 캐릭터 라인

예외:

NullPointerException - 지정된 날짜와 시간가 null인 경우

formatToCharacterIterator

public AttributedCharacterIterator  formatToCharacterIterator(Object  obj)

Object를 포맷 해, AttributedCharacterIterator를 생성합니다. 리턴된 AttributedCharacterIterator를 사용하면, 결과의 String를 구축할 수 있는 것과 동시에 결과의 String에 대한 정보를 판정할 수 있습니다.

AttributedCharacterIterator 각 속성 키는 DateFormat.Field 형입니다. 대응하는 속성값는 속성 키와 동일합니다.

오버라이드(override):

클래스 Format 내의 formatToCharacterIterator

파라미터:

obj - 포맷 하는 객체

반환값:

포맷된 값을 설명하는 AttributedCharacterIterator

예외:

NullPointerException - obj가 null인 경우

IllegalArgumentException - 지정된 객체를 Format 로 포맷 할 수 없는 경우, 또는 Format 패턴 캐릭터 라인이 무효인 경우

도입된 버전 :

1.4

parse

public Date  parse(String  text,
                  ParsePosition  pos)

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

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

정의:

클래스 DateFormat 내의 parse

파라미터:

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

pos - 상기의 인덱스 및 에러 인덱스 정보를 가지는 ParsePosition 객체

반환값:

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

예외:

NullPointerException - text 또는 pos가 null인 경우

관련 항목:

DateFormat.setLenient(boolean)

toPattern

public String  toPattern()

이 날짜와 시간 포맷을 기술하는 패턴 캐릭터 라인을 리턴합니다.

반환값:

이 날짜와 시간 포맷을 기술하는 패턴 캐릭터 라인

toLocalizedPattern

public String  toLocalizedPattern()

이 날짜와 시간 포맷의 지역 대응된 패턴 캐릭터 라인을 리턴합니다.

반환값:

이 날짜와 시간 포맷을 기술하는 지역 대응된 패턴 캐릭터 라인

applyPattern

public void applyPattern(String  pattern)

지정된 패턴 캐릭터 라인을 이 날짜와 시간 포맷에 적용합니다.

파라미터:

pattern - 이 날짜와 시간 포맷을 위한 새로운 날짜와 시간와 시각의 패턴

예외:

NullPointerException - 지정된 패턴이 null인 경우

IllegalArgumentException - 지정된 패턴이 올바르지 않은 경우

applyLocalizedPattern

public void applyLocalizedPattern(String  pattern)

지정된 지역 대응된 패턴 캐릭터 라인을 이 날짜와 시간 포맷에 적용합니다.

파라미터:

pattern - 이 날짜와 시간 포맷을 위해서 새로운 날짜와 시간와 시각의 포맷 패턴에 맵 되는 String

예외:

NullPointerException - 지정된 패턴이 null인 경우

IllegalArgumentException - 지정된 패턴이 올바르지 않은 경우

getDateFormatSymbols

public DateFormatSymbols  getDateFormatSymbols()

이 날짜와 시간 포맷의, 날짜와 시간와 시각의 포맷 기호의 복사본을 취득합니다.

반환값:

이 날짜와 시간 포맷의, 날짜와 시간와 시각의 포맷 기호

관련 항목:

setDateFormatSymbols(java.text.DateFormatSymbols)

setDateFormatSymbols

public void setDateFormatSymbols(DateFormatSymbols  newFormatSymbols)

이 날짜와 시간 포맷의, 날짜와 시간와 시각의 포맷 기호를 설정합니다.

파라미터:

newFormatSymbols - 새로운 날짜와 시간와 시각의 포맷 기호

예외:

NullPointerException - 지정된 newFormatSymbols 이 null인 경우

관련 항목:

getDateFormatSymbols()

clone

public Object  clone()

이 SimpleDateFormat 복사본을 작성합니다. 또, 포맷의 날짜와 시간 포맷 기호를 복제합니다.

오버라이드(override):

클래스 DateFormat 내의 clone

반환값:

이 SimpleDateFormat 복제

관련 항목:

Cloneable

hashCode

public int hashCode()

이 SimpleDateFormat 객체의 해시 코드값을 리턴합니다.

오버라이드(override):

클래스 DateFormat 내의 hashCode

반환값:

이 SimpleDateFormat 객체의 해시 코드값

관련 항목:

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

equals

public boolean equals(Object  obj)

지정된 객체와 이 SimpleDateFormat이 동일한지 어떤지를 비교합니다.

오버라이드(override):

클래스 DateFormat 내의 equals

파라미터:

obj - 비교 대상의 참조 객체

반환값:

지정된 객체가 SimpleDateFormat와 동일한 경우는 true

관련 항목:

Object.hashCode(), Hashtable