javax.xml.datatype
클래스 XMLGregorianCalendar

java.lang.Object 
  javax.xml.datatype.XMLGregorianCalendar

모든 구현된 인터페이스:

Cloneable

public abstract class XMLGregorianCalendar
extends Object 
implements Cloneable 

W3C XML Schema 1.0 일시 데이터형의 표현입니다. 특히 이러한 일시 데이터형은 XML 이름 공간 http://www.w3.org/2001/XMLSchema에 정의되고 있는 「dateTime」, 「time」, 「date」, 「gYearMonth」, 「gMonthDay」, 「gYear」, 「gMonth」 및 「gDay」 입니다. 이러한 데이터형은 표준으로서 「W3C XML Schema 1.0 Part 2」의 섹션 3.2. 7 ~ 3.2. 14에 정의되고 있습니다.

아래의 겉(표)에 XML Schema 1.0 일시 데이터형 필드와 이 클래스의 필드의 대응 짓고를 정의합니다. 게다가「W3C XML Schema 1.0 Part 2」의 부록 D 「ISO 8601 Date and Time Formats」에 정의되고 있는 일시 필드의 값의 제약에 대해서도 정리하고 있습니다.

XML Schema 1.0 으로 Java 표현의 일시 데이터형의 대응 짓고
XML Schema 1.0 데이터형 필드	관련의 XMLGregorianCalendar 악 세사	치의 범위
year	getYear() + getEon() 또는 getEonAndYear()	getYear()는 -(10^9-1)로부터 (10^9)-1 값 또는 DatatypeConstants.FIELD_UNDEFINED . getEon() 는 수십억년 단위의 큰 자리수의 해의 값. getEon() (10^9) 이상 또는 -(10^9) 아래의 값을 포함한다. null 값은 필드가 정의되어 있지 않은 것을 나타낸다. XML Schema 1.0 errata에 0 년이 XML schema의 장래의 버전 으로 유효한 자구값이 된다고 기재되어 있는 경우, 이 클래스는 year 필드를 제로로 설정하는 것을 허가한다. 그렇지 않은 경우는 year 필드의 값은 정오표 및 「SO-8601-1988」에 기재되어 있는 대로 처리된다. W3C XML Schema 1.0 검증은 year 필드의 값이 제로가 되는 것을 허가하지 않는
month	getMonth()	1 에서 12 또는 DatatypeConstants.FIELD_UNDEFINED
day	getDay()	월로 관계없이, 최대의 범위는 1 에서 31, 또는 DatatypeConstants.FIELD_UNDEFINED . 「W3C XML Schema 1.0 Part 2」의 부록 D에 month 필드의 값에 관한 기준치의 제약에 대한 설명이 있는
hour	getHour()	0 에서 24 또는 DatatypeConstants.FIELD_UNDEFINED . 값이 24인 경우, minute 및 second 필드는 XML Schema Errata 에 의해 제로가 될 필요가 있는
minute	getMinute()	0 에서 59 또는 DatatypeConstants.FIELD_UNDEFINED
second	getSecond() + getMillisecond() /1000 또는 getSecond() + getFractionalSecond()	0 에서 60 getSecond() 또는 DatatypeConstants.FIELD_UNDEFINED . (주 - 윤초에는 60 마셔 사용가능) getSecond() 가 정의되고 있는 경우는 getFractionalSecond() 는 0.0 에서 1.0 범위의 무한의 정밀도를 사용할 수 있다. FractionalSecond는 임의로 정의되어 있지 않은 경우는 null값이 된다. getMillisecond() 는 getFractionalSecond() 값의 편의상의 밀리 세컨드의 정밀도
timezone	getTimezone()	분수 또는 DatatypeConstants.FIELD_UNDEFINED . -14 시간 ( -14 * 60 분 )부터 14 시간 (14 * 60 분 )의 범위의 값

전술의 겉(표)의 필드에 나타난 모든 최대값 영역 제한은 이 클래스의 팩토리 메서드,@{link DatatypeFactory}, 설정 메서드 및 해석 메서드에 의해 체크됩니다. 파라미터의 값이 필드의 값제한외의 경우, 혹은 복합치에 의해 무효인 XMLGregorianCalendar 인스턴스가 구성되는 경우는 IllegalArgumentException가 발생 됩니다. 예를 들어 6 월 31 일이 지정되었을 경우 등입니다.

이 클래스에서는 다음의 처리가 정의됩니다.

• 독립한 일시 필드의 액세스용 메서드 또는 변경용 메서드
• 이 클래스와 W3C XML Schema 1.0 자구 표현, toString(), DatatypeFactory.newXMLGregorianCalendar(String lexicalRepresentation) 변환
• 이 클래스와 GregorianCalendar, toGregorianCalendar(java.util.TimeZone timezone, java.util.Locale aLocale, XMLGregorianCalendar defaults), DatatypeFactory 변환
• 부분 순서 릴레이션 비교 메서드 compare(XMLGregorianCalendar xmlGregorianCalendar)
• compare(XMLGregorianCalendar xmlGregorianCalendar)에 관해서 정의된 equals(Object)
• 「W3C XML Schema 1.0 Part 2」의 부록 E 「Adding durations to dateTimes」에 정의된 Duration 에 한 가산 연산 인스턴스

도입된 버전 :

1.5

관련 항목:

Duration, DatatypeFactory

생성자 개요

XMLGregorianCalendar ()

메서드 개요

abstract void	add (Duration duration) 이 인스턴스에 duration을 추가합니다.
abstract void	clear () 모든 필드를 미정도리로 설정 해제합니다.
abstract Object	clone () 이 객체의 복사본을 작성해, 리턴합니다.
abstract int	compare (XMLGregorianCalendar xmlGregorianCalendar) [W3C XML Schema 1.0 Part 2」의 섹션 3.2. 7.3 「Order relation on dateTime」에 정의된 부분 순서 릴레이션에 따라, W3C XML Schema 1.0 일시 데이터형의 2개의 인스턴스를 비교합니다.
boolean	equals (Object obj) 파라미터 obj가 이 객체와 「동일하다」화도인지를 나타냅니다.
abstract int	getDay () 날 또는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.
abstract BigInteger	getEon () year XML Schema 1.0 dataTime 데이터형 필드의 상위 컴퍼넌트를 리턴합니다.
abstract BigInteger	getEonAndYear () XML Schema 1.0 dateTime 데이터형 필드의 year를 리턴합니다.
abstract BigDecimal	getFractionalSecond () 소수점 아래의 초를 리턴합니다.
abstract int	getHour () 시간 또는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.
int	getMillisecond () getFractionalSecond() 밀리 세컨드의 정밀도를 리턴합니다.
abstract int	getMinute () 분 또는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.
abstract int	getMonth () 월수 또는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.
abstract int	getSecond () 초 또는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.
abstract int	getTimezone () 분 단위의 타임 존 오프셋(offset)를 리턴합니다.
abstract TimeZone	getTimeZone (int defaultZoneoffset) 이 클래스의 java.util.TimeZone를 리턴합니다.
abstract QName	getXMLSchemaType () 이 인스턴스가 대응하는 XML Schema 일시형의 이름을 리턴합니다.
abstract int	getYear () year XML Schema 1.0 dataTime 데이터형 필드의 하위 컴퍼넌트, 또는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.
int	hashCode () equals 메서드의 정의에 일치하는 해시 코드를 리턴합니다.
abstract boolean	isValid () getXMLSchemaType() 정수에의해 인스턴스를 검증합니다.
abstract XMLGregorianCalendar	normalize () 이 인스턴스를 UTC에 정규화합니다.
abstract void	reset () 이 XMLGregorianCalendar를 원의 값에 리셋 합니다.
abstract void	setDay (int day) 달의 날짜를 설정합니다.
abstract void	setFractionalSecond (BigDecimal fractional) 소수점 아래의 초를 설정합니다.
abstract void	setHour (int hour) 시간을 설정합니다.
abstract void	setMillisecond (int millisecond) 밀리 세컨드를 설정합니다.
abstract void	setMinute (int minute) 분을 설정합니다.
abstract void	setMonth (int month) 달을 설정합니다.
abstract void	setSecond (int second) 초를 설정합니다.
void	setTime (int hour, int minute, int second) 1 단위로서 시간을 설정합니다.
void	setTime (int hour, int minute, int second, BigDecimal fractional) 옵션의 무한 정밀도의 소수점 아래의 초를 포함한 시간을 1 단위로서 설정합니다.
void	setTime (int hour, int minute, int second, int millisecond) 옵션의 밀리 세컨드를 포함해, 시간을 1 단위로서 설정합니다.
abstract void	setTimezone (int offset) 타임 존 오프셋(offset)에 분수를 설정합니다.
abstract void	setYear (BigInteger year) XSD dateTime 년 필드의 하위 및 상위 컴퍼넌트를 설정합니다.
abstract void	setYear (int year) XSD dateTime 년 필드의 해를 설정합니다.
abstract GregorianCalendar	toGregorianCalendar () 이 XMLGregorianCalendar를 GregorianCalendar 로 변환합니다.
abstract GregorianCalendar	toGregorianCalendar (TimeZone timezone, Locale aLocale, XMLGregorianCalendar defaults) 제공된 파라미터에 따라, 이 XMLGregorianCalendar를 GregorianCalendar 인스턴스로 변환합니다.
String	toString () 이 XMLGregorianCalendar Object String 표현을 리턴합니다.
abstract String	toXMLFormat () this인스턴스의 자구 표현을 리턴합니다.

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

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

생성자 상세

XMLGregorianCalendar

public XMLGregorianCalendar()

메서드의 상세

clear

public abstract void clear()

모든 필드를 미정도리로 설정 해제합니다.

모든 int 필드를 DatatypeConstants.FIELD_UNDEFINED 에 참조 필드를 null 로 설정합니다.

reset

public abstract void reset()

이 XMLGregorianCalendar를 원의 값에 리셋 합니다.

XMLGregorianCalendar는 DatatypeFactory.newXMLGregorianCalendar(), DatatypeFactory.newXMLGregorianCalendar(String lexicalRepresentation), DatatypeFactory.newXMLGregorianCalendar( BigInteger year, int month, int day, int hour, int minute, int second, BigDecimal fractionalSecond, int timezone), DatatypeFactory.newXMLGregorianCalendar( int year, int month, int day, int hour, int minute, int second, int millisecond, int timezone), DatatypeFactory.newXMLGregorianCalendar(GregorianCalendar cal), DatatypeFactory.newXMLGregorianCalendarDate( int year, int month, int day, int timezone), DatatypeFactory.newXMLGregorianCalendarTime( int hours, int minutes, int seconds, int timezone), DatatypeFactory.newXMLGregorianCalendarTime( int hours, int minutes, int seconds, BigDecimal fractionalSecond, int timezone), 또는 DatatypeFactory.newXMLGregorianCalendarTime( int hours, int minutes, int seconds, int milliseconds, int timezone) 로 작성되었을 경우와 같은 값에 리셋 됩니다.

reset()는 기존의 XMLGregorianCalendar 재사용을 허가하도록 설정되어 있습니다. 이 때문에 새로운 XMLGregorianCalendar 작성에 관련된 자원을 절약할 수 있습니다.

setYear

public abstract void setYear(BigInteger  year)

XSD dateTime 년 필드의 하위 및 상위 컴퍼넌트를 설정합니다.

null 파라미터값로 설정 메서드를 호출해, 이 필드의 설정을 해제합니다.

파라미터:

year - 치의 제약에 대해서는 「일시 필드 대응표의 해필드」에 정리하고 있다

예외:

IllegalArgumentException - year 파라미터가「일시 필드 대응표」로 지정한 필드의 값의 제한의 범위외의 경우

setYear

public abstract void setYear(int year)

XSD dateTime 년 필드의 해를 설정합니다.

DatatypeConstants.FIELD_UNDEFINED 파라미터값로 설정 메서드를 호출해, 이 필드의 설정을 해제합니다.

주 - year 파라미터의 절대값이 10^9 미만의 경우는 이 메서드에 의해 XSD 년 필드의 eon 컴퍼넌트가 null로 설정됩니다.

파라미터:

year - 치의 제약에 대해서는 「일시 필드 대응표의 해필드」에 정리하고 있다. 해가 DatatypeConstants.FIELD_UNDEFINED 인 경우, eon는 null로 설정된다

setMonth

public abstract void setMonth(int month)

달을 설정합니다.

DatatypeConstants.FIELD_UNDEFINED 파라미터값로 설정 메서드를 호출해, 이 필드의 설정을 해제합니다.

파라미터:

month - 치의 제약에 대해서는 「일시 필드 대응표의 달필드」에 정리하고 있다

예외:

IllegalArgumentException - month 파라미터가「일시 필드 대응표」로 지정한 필드의 값의 제한의 범위외의 경우

setDay

public abstract void setDay(int day)

달의 날짜를 설정합니다.

DatatypeConstants.FIELD_UNDEFINED 파라미터값로 설정 메서드를 호출해, 이 필드의 설정을 해제합니다.

파라미터:

day - 치의 제약에 대해서는 「일시 필드 대응표의 날 필드」에 정리하고 있다

예외:

IllegalArgumentException - day 파라미터가「일시 필드 대응표」로 지정한 필드의 값의 제한의 범위외의 경우

setTimezone

public abstract void setTimezone(int offset)

타임 존 오프셋(offset)에 분수를 설정합니다.

DatatypeConstants.FIELD_UNDEFINED 파라미터값로 설정 메서드를 호출해, 이 필드의 설정을 해제합니다.

파라미터:

offset - 치의 제약에 대해서는 「일시 필드 대응표의 타임 존 필드」에 정리하고 있다

예외:

IllegalArgumentException - offset 파라미터가「일시 필드 대응표」로 지정한 필드의 값의 제한의 범위외의 경우

setTime

public void setTime(int hour,
                    int minute,
                    int second)

1 단위로서 시간을 설정합니다.

파라미터:

hour - 치의 제약에 대해서는 「일시 필드 대응표의 시간 필드」에 정리하고 있는

minute - 치의 제약에 대해서는 「일시 필드 대응표의 분 필드」에 정리하고 있는

second - 치의 제약에 대해서는 「일시 필드 대응표의 초필드」에 정리하고 있다

예외:

IllegalArgumentException - 파라미터가「일시 필드 대응표」로 지정한 필드의 값의 제한의 범위외의 경우

관련 항목:

setTime(int, int, int, BigDecimal)

setHour

public abstract void setHour(int hour)

시간을 설정합니다.

DatatypeConstants.FIELD_UNDEFINED 파라미터값로 설정 메서드를 호출해, 이 필드의 설정을 해제합니다.

파라미터:

hour - 치의 제약에 대해서는 「일시 필드 대응표의 시간 필드」에 정리하고 있다

예외:

IllegalArgumentException - hour 파라미터가「일시 필드 대응표」로 지정한 필드의 값의 제한의 범위외의 경우

setMinute

public abstract void setMinute(int minute)

분을 설정합니다.

DatatypeConstants.FIELD_UNDEFINED 파라미터값로 설정 메서드를 호출해, 이 필드의 설정을 해제합니다.

파라미터:

minute - 치의 제약에 대해서는 「일시 필드 대응표의 분 필드」에 정리하고 있다

예외:

IllegalArgumentException - minute 파라미터가「일시 필드 대응표」로 지정한 필드의 값의 제한의 범위외의 경우

setSecond

public abstract void setSecond(int second)

초를 설정합니다.

DatatypeConstants.FIELD_UNDEFINED 파라미터값로 설정 메서드를 호출해, 이 필드의 설정을 해제합니다.

파라미터:

second - 치의 제약에 대해서는 「일시 필드 대응표의 초필드」에 정리하고 있다

예외:

IllegalArgumentException - second 파라미터가「일시 필드 대응표」로 지정한 필드의 값의 제한의 범위외의 경우

setMillisecond

public abstract void setMillisecond(int millisecond)

밀리 세컨드를 설정합니다.

DatatypeConstants.FIELD_UNDEFINED 파라미터값로 설정 메서드를 호출해, 이 필드의 설정을 해제합니다.

파라미터:

millisecond - 치의 제약에 대해서는 「일시 필드 대응표의 밀리 세컨드 필드」에 정리하고 있다

예외:

IllegalArgumentException - millisecond 파라미터가「일시 필드 대응표」로 지정한 필드의 값의 제한의 범위외의 경우

setFractionalSecond

public abstract void setFractionalSecond(BigDecimal  fractional)

소수점 아래의 초를 설정합니다.

null 파라미터값로 설정 메서드를 호출해, 이 필드의 설정을 해제합니다.

파라미터:

fractional - 치의 제약에 대해서는 「일시 필드 대응표의 소수점 이하 필드」에 정리하고 있다

예외:

IllegalArgumentException - fractional 파라미터가「일시 필드 대응표」로 지정한 필드의 값의 제한의 범위외의 경우

setTime

public void setTime(int hour,
                    int minute,
                    int second,
                    BigDecimal  fractional)

옵션의 무한 정밀도의 소수점 아래의 초를 포함한 시간을 1 단위로서 설정합니다.

파라미터:

hour - 치의 제약에 대해서는 「일시 필드 대응표의 시간 필드」에 정리하고 있는

minute - 치의 제약에 대해서는 「일시 필드 대응표의 분 필드」에 정리하고 있는

second - 치의 제약에 대해서는 「일시 필드 대응표의 초필드」에 정리하고 있는

fractional - null값은 이 옵션의 필드가 설정되어 있지 않은 것을 나타낸다

예외:

IllegalArgumentException - 파라미터가「일시 필드 대응표」로 지정한 필드의 값의 제한의 범위외의 경우

setTime

public void setTime(int hour,
                    int minute,
                    int second,
                    int millisecond)

옵션의 밀리 세컨드를 포함해, 시간을 1 단위로서 설정합니다.

파라미터:

hour - 치의 제약에 대해서는 「일시 필드 대응표의 시간 필드」에 정리하고 있는

minute - 치의 제약에 대해서는 「일시 필드 대응표의 분 필드」에 정리하고 있는

second - 치의 제약에 대해서는 「일시 필드 대응표의 초필드」에 정리하고 있는

millisecond - DatatypeConstants.FIELD_UNDEFINED 값은 옵션의 필드가 설정되어 있지 않은 것을 나타낸다

예외:

IllegalArgumentException - 파라미터가「일시 필드 대응표」로 지정한 필드의 값의 제한의 범위외의 경우

getEon

public abstract BigInteger  getEon()

year XML Schema 1.0 dataTime 데이터형 필드의 상위 컴퍼넌트를 리턴합니다. 이 year 필드의 옵션의 부분이 정의되어 있지 않은 경우는 null을 리턴합니다.

이 값의 제약에 대해서는 「일시 필드 대응표의 해필드」에 정리하고 있습니다.

반환값:

이 XMLGregorianCalendar eon. 리턴된 값은 10^9 정수배

관련 항목:

getYear(), getEonAndYear()

getYear

public abstract int getYear()

year XML Schema 1.0 dataTime 데이터형 필드의 하위 컴퍼넌트, 또는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.

이 값의 제약에 대해서는 「일시 필드 대응표의 해필드」에 정리하고 있습니다.

반환값:

이 XMLGregorianCalendar 해

관련 항목:

getEon(), getEonAndYear()

getEonAndYear

public abstract BigInteger  getEonAndYear()

XML Schema 1.0 dateTime 데이터형 필드의 year를 리턴합니다.

이 값의 제약에 대해서는 「일시 필드 대응표의 해필드」에 정리하고 있습니다.

반환값:

eon와 BigInteger.valueOf(year) 양쪽 모두의 필드가 정의되고 있는 경우에 그러한 합계. year 만이 정의되고 있는 경우는 그것이 리턴된다. eon와 year 양쪽 모두 정의되어 있지 않은 경우는 null이 리턴된

관련 항목:

getEon(), getYear()

getMonth

public abstract int getMonth()

월수 또는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.

이 값의 제약에 대해서는 「일시 필드 대응표의 달필드」에 정리하고 있습니다.

반환값:

이 XMLGregorianCalendar 해

getDay

public abstract int getDay()

날 또는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.

이 값의 제약에 대해서는 「일시 필드 대응표의 날 필드」에 정리하고 있습니다.

관련 항목:

setDay(int)

getTimezone

public abstract int getTimezone()

분 단위의 타임 존 오프셋(offset)를 리턴합니다. 옵션의 필드가 정의되어 있지 않은 경우는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.

이 값의 제약에 대해서는 「일시 필드 대응표의 타임 존 필드」에 정리하고 있습니다.

관련 항목:

setTimezone(int)

getHour

public abstract int getHour()

시간 또는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다. 이 필드가 정의되어 있지 않은 경우는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.

이 값의 제약에 대해서는 「일시 필드 대응표의 시간 필드」에 정리하고 있습니다.

관련 항목:

setTime(int, int, int)

getMinute

public abstract int getMinute()

분 또는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.

이 필드가 정의되어 있지 않은 경우는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.

이 값의 제약에 대해서는 「일시 필드 대응표의 분 필드」에 정리하고 있습니다.

관련 항목:

setTime(int, int, int)

getSecond

public abstract int getSecond()

초 또는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.

이 필드가 정의되어 있지 않은 경우는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다. 이 필드가 정의되어 있지 않은 경우, getFractionalSecond() 및 getMillisecond() 로 나타내지는 옵션의 xs:dateTime 소수점 아래의 초필드를 정의할 수 없습니다.

이 값의 제약에 대해서는 「일시 필드 대응표의 초필드」에 정리하고 있습니다.

반환값:

이 XMLGregorianCalendar 초

관련 항목:

getFractionalSecond(), getMillisecond(), setTime(int, int, int)

getMillisecond

public int getMillisecond()

getFractionalSecond() 밀리 세컨드의 정밀도를 리턴합니다.

이 메서드는 getFractionalSecond() 에 의해 리턴된 무한 정밀도의 소수점 아래의 초에의 간이 액세스용 메서드입니다. 리턴된 값은, getFractionalSecond() 밀리 세컨드의 값에 인하할 수 있습니다. getFractionalSecond() 가 null을 돌려주는 경우, 이 메서드는 DatatypeConstants.FIELD_UNDEFINED를 리턴합니다.

이 값의 제약에 대해서는 「일시 필드 대응표의 초필드」에 정리하고 있습니다.

반환값:

이 XMLGregorianCalendar 밀리 세컨드

관련 항목:

getFractionalSecond(), setTime(int, int, int)

getFractionalSecond

public abstract BigDecimal  getFractionalSecond()

소수점 아래의 초를 리턴합니다.

이 옵션필드가 정의되어 있지 않은 경우는 null을 리턴합니다.

값의 제약에 대해서는 「일시 필드 대응표의 초필드」에 자세하게 설명하고 있습니다.

이 옵션의 필드는 getSecond() 에 의해 나타내지는 xs:dateTime 분 필드가 DatatypeConstants.FIELD_UNDEFINED를 돌려주지 않는 경우에게만, 정의된 값을 가질 수가 있습니다.

반환값:

이 XMLGregorianCalendar 소수점 아래의 초

관련 항목:

getSecond(), setTime(int, int, int, BigDecimal)

compare

public abstract int compare(XMLGregorianCalendar  xmlGregorianCalendar)

[W3C XML Schema 1.0 Part 2」의 섹션 3.2. 7.3 「Order relation on dateTime」에 정의된 부분 순서 릴레이션에 따라, W3C XML Schema 1.0 일시 데이터형의 2개의 인스턴스를 비교합니다.

이 클래스의 액세스용 메서드에 대응하는 xsd:dateTime 데이터형에 대해서는「일시 필드 대응표」에 정의하고 있습니다.

파라미터:

xmlGregorianCalendar - 비교하는 XMLGregorianCalendar 인스턴스

반환값:

this XMLGregorianCalendar와 DatatypeConstants.LESSER, DatatypeConstants.EQUAL, DatatypeConstants.GREATER, 또는 DatatypeConstants.INDETERMINATE 로서 지정된 xmlGregorianCalendar와 의 관계

예외:

NullPointerException - xmlGregorianCalendar가 null인 경우

normalize

public abstract XMLGregorianCalendar  normalize()

이 인스턴스를 UTC에 정규화합니다.

2000-03-04T23:00:00+03:00는 2000-03-04T20:00:00Z에 정규화됩니다.

「W3C XML Schema 1.0 Part 2의 섹션 3.2. 7.3 (A)」를 구현합니다.

반환값:

UTC에 정규화된 this XMLGregorianCalendar

equals

public boolean equals(Object  obj)

파라미터 obj가 이 객체와 「동일하다」화도인지를 나타냅니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 비교하는 객체

반환값:

obj가 XMLGregorianCalendar 인스턴스이며, compare(XMLGregorianCalendar obj) 가 DatatypeConstants.EQUAL를 돌려주는 경우는 true, 그렇지 않은 경우는 false

예외:

NullPointerException - obj가 null인 경우

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

equals 메서드의 정의에 일치하는 해시 코드를 리턴합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 객체의 해시 코드

관련 항목:

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

toXMLFormat

public abstract String  toXMLFormat()

this인스턴스의 자구 표현을 리턴합니다. 이 형식은「XML Schema 1.0 Part 2」의 섹션 3.2. [7-14]「1 Lexical Representation」로 지정되고 있습니다.

특정의 목적의 자구 표현 형식은 getXMLSchemaType() 에 의해 판단합니다.

반환값:

이 XMLGregorianCalendar String 표현으로서의 XML

예외:

IllegalStateException - 설정 필드의 편성이, 정의된 8개의 XML Schema 일시 데이터형의 어느 쪽인가에 일치하지 않는 경우

getXMLSchemaType

public abstract QName  getXMLSchemaType()

이 인스턴스가 대응하는 XML Schema 일시형의 이름을 리턴합니다. 형태는 설정되는 필드에 근거해 계산됩니다.

XML Schema 1.0 일시 데이터형의 필수 필드 (모든 일시 데이터형으로 타임 존은 옵션)
데이터형	year	month	day	hour	minute	second
DatatypeConstants.DATETIME	X	X	X	X	X	X
DatatypeConstants.DATE	X	X	X
DatatypeConstants.TIME				X	X	X
DatatypeConstants.GYEARMONTH	X	X
DatatypeConstants.GMONTHDAY		X	X
DatatypeConstants.GYEAR	X
DatatypeConstants.GMONTH		X
DatatypeConstants.GDAY			X

반환값:

DatatypeConstants.DATETIME, DatatypeConstants.TIME, DatatypeConstants.DATE, DatatypeConstants.GYEARMONTH, DatatypeConstants.GMONTHDAY, DatatypeConstants.GYEAR, DatatypeConstants.GMONTH, 또는 DatatypeConstants.GDAY 가운데, 어느쪽이든 1개의 정수

예외:

IllegalStateException - 설정 필드의 편성이, 정의된 8개의 XML Schema 일시 데이터형의 어느 쪽인가에 일치하지 않는 경우

toString

public String  toString()

이 XMLGregorianCalendar Object String 표현을 리턴합니다.

이 결과는 toXMLFormat() 에 의해 생성된 자구 표현입니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 XMLGregorianCalendar null 이외의 유효한 String 표현

예외:

IllegalStateException - 설정 필드의 편성이, 정의된 8개의 XML Schema 일시 데이터형의 어느 쪽인가에 일치하지 않는 경우

관련 항목:

toXMLFormat()

isValid

public abstract boolean isValid()

getXMLSchemaType() 정수에의해 인스턴스를 검증합니다.

반환값:

데이터가 유효한 경우는 true

add

public abstract void add(Duration  duration)

이 인스턴스에 duration을 추가합니다.

이 계산은「XML Schema 1.0 Part 2」의 부록 E 「Adding durations to dateTimes」 로 지정되고 있습니다. 「일시 대응표」에 XML Schema 1.0 dateTime 필드와 이 클래스의 그러한 필드의 표현의 대응을 정의하고 있습니다.

파라미터:

duration - 이 XMLGregorianCalendar에 추가하는 듀레이션

예외:

NullPointerException - duration 파라미터가 null인 경우

toGregorianCalendar

public abstract GregorianCalendar  toGregorianCalendar()

이 XMLGregorianCalendar를 GregorianCalendar 로 변환합니다.

this인스턴스에 미정도리 필드가 있는 경우, 이 변환은 java.util.GregorianCalendar 그 대응하는 필드의 디폴트에 의존합니다. XML Schema 1.0 일시 데이터형과 java.util.GregorianCalendar 주된 차이는 Timezone 값이 일시 데이터형에서는 옵션으로java.util.GregorianCalendar에 서는 필수인 것입니다. 디폴트가 결정되는 구조에 대해서는 java.util.TimeZone.getDefault() Javadoc를 참조하십시오. TimeZone인스턴스를 명시적으로 지정하려면, toGregorianCalendar(TimeZone, Locale, XMLGregorianCalendar)를 참조하십시오.

이 클래스로부터 java.util.GregorianCalendar에 의 필드마다의 변환
java.util.GregorianCalendar 필드	javax.xml.datatype.XMLGregorianCalendar 필드
ERA	getEonAndYear() . signum() < 0 ? GregorianCalendar.BC : GregorianCalendar.AD
YEAR	getEonAndYear() . abs(). intValue()*
MONTH	getMonth() - DatatypeConstants.JANUARY + Calendar.JANUARY
DAY_OF_MONTH	getDay()
HOUR_OF_DAY	getHour()
MINUTE	getMinute()
SECOND	getSecond()
MILLISECOND	getFractionalSecond() 로부터 밀리 세컨드를 취득*
GregorianCalendar.setTimeZone(TimeZone)	커스텀 타임 존 ID에 포맷된 getTimezone()

* 변환원의 데이터형의 정밀도는 변환처의 데이터형의 정밀도보다 높기 때문에 변환시에 정밀도가 저하할 가능성이 있는 것을 나타낸다

변환의 구현의 일관성을 확보하기 위해, 새로운 GregorianCalendar는 다음과 같이 인스턴스화 될 필요가 있습니다.

• 상기와 같이 timeZone값을 사용해, 새로운 java.util.GregorianCalendar(timeZone, Locale.getDefault())를 작성한다
• {(@link GegorianCalendar#clear()}를 호출해, 모든 GregorianCalendar 필드를 초기화한다
• GregorianCalendar.setGregorianChange( new Date(Long.MIN_VALUE))를 호출해, 순수한 그레고리오력을 취득한다
• 메서드 Calendar.set(int, int)를 사용해, 필드 ERA, YEAR, MONTH, DAY_OF_MONTH, HOUR_OF_DAY, MINUTE, SECOND 및 MILLISECOND를 설정한다

관련 항목:

toGregorianCalendar(java.util.TimeZone, java.util.Locale, XMLGregorianCalendar)

toGregorianCalendar

public abstract GregorianCalendar  toGregorianCalendar(TimeZone  timezone,
                                                      Locale  aLocale,
                                                      XMLGregorianCalendar  defaults)

제공된 파라미터에 따라, 이 XMLGregorianCalendar를 GregorianCalendar 인스턴스로 변환합니다.

XML Schema 1.0 일시 데이터형에는 타임 존 ID 나 서머타임 타임 존 ID 개념이 없기 때문에 이 변환 처리에의해 사용자는 timezone 파라미터로 명시적으로 그것들을 지정할 수 있습니다.

반환값의 TimeZone 필드는 다음과 같이 계산됩니다.

• 파라미터 timeZone가 null이 아닌 경우, 타임 존 필드이다
• 또는 this.getTimezone() ! = FIELD_UNDEFINED인 경우, this.getTimezone()를 사용해, 커스텀 타임 존 ID 로 java.util.TimeZone를 작성한다
• 또는 defaults.getTimezone() ! = FIELD_UNDEFINED인 경우, defaults.getTimezone()를 사용해, 커스텀 타임 존 ID 로 java.util.TimeZone를 작성한다
• 또는 java.util.TimeZone.getDefault()에 의해 지정되고 있도록, 호스트가 정의되고 있는 경우에 GregorianCalendar 디폴트 타임 존치를 사용한다

변환의 구현의 일관성을 확보하기 위해, 새로운 GregorianCalendar는 다음과 같이 인스턴스화 될 필요가 있습니다.

• 상기로 지정된 TimeZone 세트 및 Locale 파라미터로 새로운 java.util.GregorianCalendar(TimeZone, Locale)를 작성한다
• Calendar.clear()를 호출해, 모든 GregorianCalenda 필드를 초기화한다
• GregorianCalendar.setGregorianChange( new Date(Long.MIN_VALUE))를 호출해, 순수한 그레고리오력을 취득한다
• 메서드 Calendar.set(int, int)를 사용해, 필드 ERA, YEAR, MONTH, DAY_OF_MONTH, HOUR_OF_DAY, MINUTE, SECOND 및 MILLISECOND를 설정한다

파라미터:

timezone - 타임 존을 제공한다. null은 유효한 값

aLocale - 명시적인 로케일을 제공한다. 값이 null인 경우는 디폴트의 GregorianCalendar 로케일을 사용하는

defaults - 이 인스턴스의 대응하는 필드가 FIELD_UNDEFINED 또는 null인 경우에 사용하는 디폴트의 필드값을 제공한다. defaults가 null 또는 지정된 defaults가 정의되어 있지 않은 경우, java.util.GregorianCalendar 디폴트를 사용한다

반환값:

이 인스턴스의 java.util.GregorianCalendar 변환

getTimeZone

public abstract TimeZone  getTimeZone(int defaultZoneoffset)

이 클래스의 java.util.TimeZone를 리턴합니다.

이 인스턴스의 타임 존 필드가 정의되고 있는 경우는 존 오프셋(offset)의 커스텀 타임 존 ID 로 초기화된 TimeZone를 리턴합니다. 타임 존 필드가 정의되어 있지 않은 경우는 건네받은 defaultZoneoffset를 시도합니다. defaultZoneoffset가 FIELD_UNDEFINED인 경우는 이 호스트의 디폴트의 타임 존을 리턴합니다. 이것은 java.util.GregorianCalendar 디폴트와 같습니다.

파라미터:

defaultZoneoffset - 이 존 오프셋(offset)가 DatatypeConstants.FIELD_UNDEFINED 인 경우는 디폴트의 존 오프셋(offset)

반환값:

이 TimeZone

clone

public abstract Object  clone()

이 객체의 복사본을 작성해, 리턴합니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 Object 카피

관련 항목:

Cloneable