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" 에 정의되고 있는 DatatypeConstants.DATETIME ,DatatypeConstants.TIME ,DatatypeConstants.DATE ,DatatypeConstants.GYEARMONTH ,DatatypeConstants.GMONTHDAY ,DatatypeConstants.GYEAR ,DatatypeConstants.GMONTH , 또는 DatatypeConstants.GDAY 가운데, 어느쪽이든 1 개의 정수입니다. 이러한 데이터형은 표준으로서 「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 . (Note: 60 only allowable for leap second. ) getFractionalSecond() allows for infinite precision over the range from 0.0 to 1.0 when the getSecond() is defined. FractionalSecond 는 임의로, 정의되어 있지 않은 경우는 null 의 값이 된다. getMillisecond() 는 getFractionalSecond() 의 값의 편의상의 밀리 세컨드의 정밀도
timezone	getTimezone()	분수 또는 DatatypeConstants.FIELD_UNDEFINED . -14 시간 ( -14 * 60 분 )부터 14 시간 (14 * 60 분 )의 범위의 값

　

전술의 겉(표)의 필드에 나타난 모든 최대치 영역 제한은, 이 클래스의 팩토리 메소드,@{link DatatypeFactory}, 설정 메소드, 및 해석 메소드에 의해 체크됩니다. 파라미터의 값이 필드의 값제한외의 경우, 혹은 복합치에 의해 무효인 XMLGregorianCalendar 인스턴스가 구성되는 경우는, IllegalArgumentException 가 throw 됩니다. 예를 들어, 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) 이 달력이 지정된 객체와 비교합니다.
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 () 옵션의 필드가 정의되어 있지 않은 경우는 DatatypeConstants.FIELD_UNDEFINED 를 돌려줍니다.
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()

디폴트의 인수 없음의 생성자 입니다. 　

주:XMLGregorianCalendar 의 인스턴스를 구축하려면 , 항상 DatatypeFactory 를 사용합니다. 이 클래스상의 생성자 은, 일관한 상태의 객체를 생성한다고는 보증되지 않고, 장래 삭제될 가능성이 있습니다.

메소드의 상세

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 의 파라미터치로 설정 메소드를 호출해, 이 필드의 설정을 해제합니다.

　

주: if the absolute value of the year parameter is less than 10^9, the eon component of the XSD year field is set to null by this method.

파라미터:

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. The value returned is an integer multiple of 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 를 돌려줍니다.

　

이 값의 제약에 대해서는,「일시 필드 대응표의 날 필드」에 정리하고 있습니다. 분 단위의 타임 존 오프셋(offset)를 돌려줍니다.

관련 항목:

setDay(int)

getTimezone

public abstract int getTimezone()

옵션의 필드가 정의되어 있지 않은 경우는 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)

이 달력이 지정된 객체와 비교합니다. 인수가 null 가 아니고, 이 객체와 같은 시점을 나타내는 XMLGregorianCalendar 객체인 경우에만, 결과는 true 가 됩니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 비교하는 객체

반환값:

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

관련 항목:

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

예외:

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()) 를 작성한다
• Initialize all GregorianCalendar fields by calling Calendar.clear() .
• 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