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	기원	Text	AD
y	년	년	1996; 96
M	월	월	July; Jul; 07
w	해에 있어서의 주	수치	27
W	달에 있어서의 주	수치	2
D	해에 있어서의 날	수치	189
d	달에 있어서의 날	수치	10
F	달에 있어서의 요일	수치	2
E	요일	Text	Tuesday; Tue
a	오전/오후	Text	PM
H	하루에 있어서의 때 (0 ~ 23)	수치	0
k	하루에 있어서의 때 (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 개의 인접하는 필드를 단락지을 필요가 없는 한, 패턴 문자의 수는 무시됩니다.
• 해: 포매터의 Calendar 가 태양력의 경우는, 다음에 나타내는 규칙이 적용됩니다.
  
  • 패턴 문자의 수가 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 일로 해석됩니다.
  그렇지 않은 경우는, 달력 시스템 고유의 형식이 적용됩니다. 패턴 문자의 수가 4 이상의 경우, 포맷과 해석의 양쪽 모두에, 달력 고유의긴 형식이 사용됩니다. 그렇지 않은 경우는, 달력 고유의짧은 형식 또는 생략 된 형식이 사용됩니다.
• 달: 패턴 문자의 수가 3 이상의 경우, 포맷에는 달이텍스트로서 해석됩니다. 그렇지 않은 경우는,수치로서 해석됩니다.
• 일반적인 타임 존: 타임 존에 이름이 있는 경우,텍스트로서 해석됩니다. GMT 오프셋(offset)치를 나타내는 타임 존에는, 다음의 구문이 사용됩니다.

       GMTOffsetTimeZone: 
               GMT 부호 시 :Minutes
       Sign: 다음의 어떤 것인가
               + -
       Hours:
               숫자
               Digit Digit
       Minutes:
               Digit Digit
       Digit: 다음의 어떤 것인가
               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 튜토리얼, Calendar , TimeZone , DateFormat , DateFormatSymbols , 직렬화 된 형식

상자의 클래스의 개요

클래스 java.text. DateFormat 로부터 상속된 상자의 클래스/인터페이스

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 년 의 범위에 배치되는

도입된 버젼:

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 - if the Format cannot format the given object, or if the Format's pattern string is invalid.

도입된 버젼:

1.4

parse

public Date  parse(String  text,
                  ParsePosition  pos)

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

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

정의:

클래스 DateFormat 내의 parse

파라미터:

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

pos - A ParsePosition object with index and error index information as described above.

반환값:

캐릭터 라인으로부터 해석되는 Date In case of error, returns 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 - a String to be mapped to the new date and time format pattern for this format

예외:

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 - 비교 대상의 참조 객체

반환값:

지정된 Object 가 이 SimpleDateFormat 와 동일한 경우는 ture

관련 항목:

Object.hashCode() , Hashtable