javax.xml.datatype
클래스 DatatypeFactory

java.lang.Object 
  javax.xml.datatype.DatatypeFactory

public abstract class DatatypeFactory
extends Object 

XML를 Java Object에 혹은 Java Object로 부터 맵 하는 새로운 javax.xml.datatype Object를 작성하는 팩토리입니다.

newInstance() 을 사용해 새로운 DatatypeFactory가 작성됩니다. 다음의 구현 해결 도구가 다음의 순서로 사용됩니다.

1. DATATYPEFACTORY_PROPERTY 에 의해 지정된 시스템 프로퍼티, javax.xml.datatype.DatatypeFactory가 존재하는 경우는 그 프로퍼티치의 이름을 가지는 클래스가 인스턴스화 됩니다. 인스턴스화의 프로세스중에 Throw 된 예외는 DatatypeConfigurationException 로서 랩 됩니다.
2. 파일 ${JAVA_HOME}/lib/jaxp.properties가 존재하는 경우는 Properties Object에 로드 됩니다. 그 후, Properties Object이 전의 스텝에서 문서화 되어 전의 스텝에서 문서화 된 것으로서 처리된 프로퍼티에 조회됩니다.
3. META-INF/services/java.xml.datatype.DatatypeFactory 등의 서비스 해결 도구가 사용됩니다. 인스턴스화의 프로세스중에 Throw 된 예외는 DatatypeConfigurationException 로서 랩 됩니다.
4. 파이널 도구가 DATATYPEFACTORY_IMPLEMENTATION_CLASS 에 의해 지정된 Class , javax.xml.datatype.DatatypeFactoryImpl 인스턴스화를 시도합니다. 인스턴스화의 프로세스중에 Throw 된 예외는 DatatypeConfigurationException 로서 랩 됩니다.

도입된 버전 :

1.5

필드 개요

static String	DATATYPEFACTORY_IMPLEMENTATION_CLASS JSR 206: Java(TM) API for XML Processing (JAXP) 1.3 으로 정의되고 있는 디폴트의 구현 클래스명입니다.
static String	DATATYPEFACTORY_PROPERTY JSR 206: Java(TM) API for XML Processing (JAXP) 1.3 으로 정의되고 있는 디폴트의 프로퍼티명입니다.

생성자 개요

protected

DatatypeFactory () 패키지 외부의 인스턴스화를 막는 protected 생성자 입니다.

메서드 개요

abstract Duration	newDuration (boolean isPositive, BigInteger years, BigInteger months, BigInteger days, BigInteger hours, BigInteger minutes, BigDecimal seconds) Duration을 isPositive, 년, 월, 일, 시간, 분, 초에 지정하는 Duration 새로운 인스턴스를 취득합니다.
Duration	newDuration (boolean isPositive, int years, int months, int days, int hours, int minutes, int seconds) Duration을 isPositive, 년, 월, 일, 시간, 분, 초에 지정하는 Duration 새로운 인스턴스를 취득합니다.
abstract Duration	newDuration (long durationInMilliSeconds) Duration을 밀리 세컨드로 지정하는 Duration 새로운 인스턴스를 취득합니다.
abstract Duration	newDuration (String lexicalRepresentation) Duration 새로운 인스턴스를 취득해, XML Schema 1.0 section 3.2. 6.1에 정의되고 있도록 캐릭터 라인 표현 「PnYnMnDTnHnMnS」를 해석해, Duration 를 지정합니다.
Duration	newDurationDayTime (boolean isPositive, BigInteger day, BigInteger hour, BigInteger minute, BigInteger second) 「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」로 정의된 지정의 day, hour, minute 및 second를 사용해, xdt:dayTimeDuration 형의 Duration을 작성합니다.
Duration	newDurationDayTime (boolean isPositive, int day, int hour, int minute, int second) 「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」로 정의된 지정의 day, hour, minute 및 second를 사용해, xdt:dayTimeDuration 형의 Duration을 작성합니다.
Duration	newDurationDayTime (long durationInMilliseconds) 「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」 로 정의된 지정 밀리 세컨드를 사용해, xdt:dayTimeDuration 형의 Duration을 작성합니다.
Duration	newDurationDayTime (String lexicalRepresentation) String 표현, 「PnDTnHnMnS」, 「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」 를 구문 분석 하는 것에의해 xdt:dayTimeDuration 형의 Duration을 작성합니다.
Duration	newDurationYearMonth (boolean isPositive, BigInteger year, BigInteger month) 「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」로 정의된 지정의 year 및 month를 사용해, xdt:yearMonthDuration 형의 Duration을 작성합니다.
Duration	newDurationYearMonth (boolean isPositive, int year, int month) 「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」로 정의된 지정의 year 및 month를 사용해, xdt:yearMonthDuration 형의 Duration을 작성합니다.
Duration	newDurationYearMonth (long durationInMilliseconds) 「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」로 정의된 지정 밀리 세컨드를 사용해, xdt:yearMonthDuration 형의 Duration을 작성합니다.
Duration	newDurationYearMonth (String lexicalRepresentation) String 표현, 「PnYnM」, 「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」를 구문 분석 하는 것에의해 xdt:yearMonthDuration 형의 Duration을 작성합니다.
static DatatypeFactory	newInstance () DatatypeFactory 새로운 인스턴스를 취득합니다.
abstract XMLGregorianCalendar	newXMLGregorianCalendar () XMLGregorianCalendar 새로운 인스턴스를 작성합니다.
abstract XMLGregorianCalendar	newXMLGregorianCalendar (BigInteger year, int month, int day, int hour, int minute, int second, BigDecimal fractionalSecond, int timezone) W3C XML Schema 1.0 recommendation 로 xsd:dateTime 및 관련된 빌트인 데이터형에 허가되고 있는 완전한 값공간을 가능하게 하는 생성자 입니다.
abstract XMLGregorianCalendar	newXMLGregorianCalendar (GregorianCalendar cal) GregorianCalendar 로부터 XMLGregorianCalendar를 작성합니다.
XMLGregorianCalendar	newXMLGregorianCalendar (int year, int month, int day, int hour, int minute, int second, int millisecond, int timezone) java.util.GregorianCalendar인스턴스를 XMLGregorianCalendar인스턴스로 변환할 필요가 있는 값영역의 생성자 입니다.
abstract XMLGregorianCalendar	newXMLGregorianCalendar (String lexicalRepresentation) 자구 표현으로서 캐릭터 라인을 구문 분석 하는 것에의해 새로운 XMLGregorianCalendar를 작성합니다.
XMLGregorianCalendar	newXMLGregorianCalendarDate (int year, int month, int day, int timezone) XML Schema 빌트인 데이터형 date 또는 g* Java 표현을 작성합니다.
XMLGregorianCalendar	newXMLGregorianCalendarTime (int hours, int minutes, int seconds, BigDecimal fractionalSecond, int timezone) XML Schema 빌트인 데이터형 time Java 인스턴스를 작성합니다.
XMLGregorianCalendar	newXMLGregorianCalendarTime (int hours, int minutes, int seconds, int timezone) XML Schema 빌트인 데이터형 time Java 인스턴스를 작성합니다.
XMLGregorianCalendar	newXMLGregorianCalendarTime (int hours, int minutes, int seconds, int milliseconds, int timezone) XML Schema 빌트인 데이터형 time Java 인스턴스를 작성합니다.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

DATATYPEFACTORY_PROPERTY

public static final String  DATATYPEFACTORY_PROPERTY

JSR 206: Java(TM) API for XML Processing (JAXP) 1.3 으로 정의되고 있는 디폴트의 프로퍼티명입니다.

기정치는 javax.xml.datatype.DatatypeFactory 입니다.

관련 항목:

정수 필드값

DATATYPEFACTORY_IMPLEMENTATION_CLASS

public static final String  DATATYPEFACTORY_IMPLEMENTATION_CLASS

JSR 206: Java(TM) API for XML Processing (JAXP) 1.3 으로 정의되고 있는 디폴트의 구현 클래스명입니다.

기정치는 com.sun.org.apache.xerces.internal.jaxp.datatype.DatatypeFactoryImpl 입니다.

관련 항목:

정수 필드값

생성자 상세

DatatypeFactory

protected DatatypeFactory()

패키지 외부의 인스턴스화를 막는 protected 생성자 입니다.

newInstance() 을 사용해 DatatypeFactory를 작성합니다.

메서드의 상세

newInstance

public static DatatypeFactory  newInstance()
                                   throws DatatypeConfigurationException 

DatatypeFactory 새로운 인스턴스를 취득합니다.

구현 해결 도구는 이 Class 문서로정의되고 있습니다.

반환값:

DocumentBuilderFactory 새로운 인스턴스

예외:

DatatypeConfigurationException - 구현을 사용할 수 없는가 인스턴스화할 수 없는 경우

newDuration

public abstract Duration  newDuration(String  lexicalRepresentation)

Duration 새로운 인스턴스를 취득해, XML Schema 1.0 section 3.2. 6.1에 정의되고 있도록 캐릭터 라인 표현 「PnYnMnDTnHnMnS」를 해석해, Duration 를 지정합니다.

XML Schema Part 2: Datatypes, 3.2. 6 duration는 다음과 같이 duration을 정의합니다.

시간의 길이를 나타내는 듀레이션입니다. 듀레이션의 값의 공간은 6 차원이며, 여기에서는 좌표에의해 각각 [ISO 86001] 섹션 5.5. 3.2 로 정의되고 있는 태양력의 년, 월, 일, 시간, 분 및 초의 컴퍼넌트가 지정됩니다. 이러한 컴퍼넌트는 단위의 크기순서, 즉 년, 월, 일, 시간, 분 및 초의 순서로 늘어놓을 수 있습니다.

6개의 값은 모두 설정되어 있어 작성된 Duration 로부터 사용할 수 있습니다.

XML schema 사양에서는 임의의 사이즈의 값을 받을 수가 있습니다. 구현은 큰 값 또는 작은 값, 혹은 이 양쪽 모두를 임의에 지원 하지 않는지, 혹은 지원 불가로 할까를 선택할 수 있습니다 . 구현 용량의 한계를 넘고 있는 경우는 구현 한계를 나타내는 메세지와 함께 UnsupportedOperationException을 발생시킵니다.

파라미터:

lexicalRepresentation - Duration String 표현

반환값:

lexicalRepresentation 구문 분석으로부터 작성된 새로운 Duration

예외:

IllegalArgumentException - lexicalRepresentation가 Duration 표현으로서 무효인 경우

UnsupportedOperationException - 구현이 요구된 값을 지원 할 수 없는 경우

NullPointerException - lexicalRepresentation가 null인 경우

newDuration

public abstract Duration  newDuration(long durationInMilliSeconds)

Duration을 밀리 세컨드로 지정하는 Duration 새로운 인스턴스를 취득합니다.

XML Schema Part 2: Datatypes, 3.2. 6 duration는 다음과 같이 duration을 정의합니다.

시간의 길이를 나타내는 듀레이션입니다. 듀레이션의 값의 공간은 6 차원이며, 여기에서는 좌표에의해 각각 [ISO 86001] 섹션 5.5. 3.2 로 정의되고 있는 태양력의 년, 월, 일, 시간, 분 및 초의 컴퍼넌트가 지정됩니다. 이러한 컴퍼넌트는 단위의 크기순서, 즉 년, 월, 일, 시간, 분 및 초의 순서로 늘어놓을 수 있습니다.

6개의 값은 모두 지정된 밀리 세컨드로부터 각각의 값을 계산하는 것에 의해 설정되어 작성된 Duration get 메서드를 사용해 사용 가능해집니다. 값은 아래의 항목에 준거해, 이것들에 의해 정의되고 있습니다.

• ISO 8601:2000(E) Section 5.5. 3.2 Alternative format
• 「W3C XML Schema 1.0 Part 2」의 부록 D 「ISO 8601 Date and Time Formats」
• XMLGregorianCalendar XML Schema 1.0 으로 Java 표현의 일시 데이터형의 대응 짓고

디폴트의 개시 인스턴스는 GregorianCalendar 에 한 그 기간의 개시, 즉, Calendar.YEAR = 1970, Calendar.MONTH = Calendar.JANUARY, Calendar.DATE = 1 등에 의해 정의됩니다. 태양력에는 변동이 있으므로 이것이 중요해집니다. 예를 들면, 윤년으로는 month = Calendar.FEBRUARY 날짜가 바뀌기 때문에 Duration.getMonths() 나 Duration.getDays() 결과에 영향이 나오는 일이 있습니다.

파라미터:

durationInMilliSeconds - 밀리 세컨드로 작성하는 듀레이션

반환값:

durationInMilliSeconds를 나타내는 새로운 Duration

newDuration

public abstract Duration  newDuration(boolean isPositive,
                                     BigInteger  years,
                                     BigInteger  months,
                                     BigInteger  days,
                                     BigInteger  hours,
                                     BigInteger  minutes,
                                     BigDecimal  seconds)

Duration을 isPositive, 년, 월, 일, 시간, 분, 초에 지정하는 Duration 새로운 인스턴스를 취득합니다.

XML schema 사양에서는 임의의 사이즈의 값을 받을 수가 있습니다. 구현은 큰 값 또는 작은 값, 혹은 이 양쪽 모두를 임의에 지원 하지 않는지, 혹은 지원 불가로 할까를 선택할 수 있습니다 . 구현 용량의 한계를 넘고 있는 경우는 구현 한계를 나타내는 메세지와 함께 UnsupportedOperationException을 발생시킵니다.

null값은 필드가 설정되어 있지 않은 것을 나타냅니다.

파라미터:

isPositive - false로 설정하면, 부의 듀레이션이 작성된다. 듀레이션의 길이가 0인 경우, 이 파라미터는 무시되는

years - 이 Duration 해

months - 이 Duration 달

days - 이 Duration 날

hours - 이 Duration 시간

minutes - 이 Duration 분

seconds - 이 Duration 초

반환값:

지정된 값으로부터 작성된 새로운 Duration

예외:

IllegalArgumentException - 값이 Duration 표현으로서 무효인 경우

UnsupportedOperationException - 구현이 요구된 값을 지원 할 수 없는 경우

newDuration

public Duration  newDuration(boolean isPositive,
                            int years,
                            int months,
                            int days,
                            int hours,
                            int minutes,
                            int seconds)

Duration을 isPositive, 년, 월, 일, 시간, 분, 초에 지정하는 Duration 새로운 인스턴스를 취득합니다.

DatatypeConstants.FIELD_UNDEFINED 값은 필드가 설정되어 있지 않은 것을 나타냅니다.

파라미터:

isPositive - false로 설정하면, 부의 듀레이션이 작성된다. 듀레이션의 길이가 0인 경우, 이 파라미터는 무시되는

years - 이 Duration 해

months - 이 Duration 달

days - 이 Duration 날

hours - 이 Duration 시간

minutes - 이 Duration 분

seconds - 이 Duration 초

반환값:

지정된 값으로부터 작성된 새로운 Duration

예외:

IllegalArgumentException - 값이 Duration 표현으로서 무효인 경우

관련 항목:

newDuration( boolean isPositive, BigInteger years, BigInteger months, BigInteger days, BigInteger hours, BigInteger minutes, BigDecimal seconds)

newDurationDayTime

public Duration  newDurationDayTime(String  lexicalRepresentation)

String 표현, 「PnDTnHnMnS」, 「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」 를 구문 분석 하는 것에의해 xdt:dayTimeDuration 형의 Duration을 작성합니다.

데이터형 xdt:dayTimeDuration는 자구 표현에 날, 시간, 분 및 초컴퍼넌트만이 포함되는 xs:duration 아류형입니다. 이 데이터형은 이름 공간 http://www.w3.org/2003/11/xpath-datatypes에 있습니다.

4개의 값은 모두 설정되어 있어 작성된 Duration 로부터 사용할 수 있습니다.

XML schema 사양에서는 임의의 사이즈의 값을 받을 수가 있습니다. 구현은 큰 값 또는 작은 값, 혹은 이 양쪽 모두를 임의에 지원 하지 않는지, 혹은 지원 불가로 할까를 선택할 수 있습니다 . 구현 용량의 한계를 넘고 있는 경우는 구현 한계를 나타내는 메세지와 함께 UnsupportedOperationException을 발생시킵니다.

파라미터:

lexicalRepresentation - 듀레이션의 자구 표현

반환값:

지정된 lexicalRepresentation을 사용해 작성된 새로운 Duration

예외:

IllegalArgumentException - 지정된 캐릭터 라인이 전술의 사양에 준거하지 않는 경우

UnsupportedOperationException - 구현이 요구된 값을 지원 할 수 없는 경우

NullPointerException - lexicalRepresentation가 null인 경우

newDurationDayTime

public Duration  newDurationDayTime(long durationInMilliseconds)

「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」 로 정의된 지정 밀리 세컨드를 사용해, xdt:dayTimeDuration 형의 Duration을 작성합니다.

데이터형 xdt:dayTimeDuration는 자구 표현에 날, 시간, 분 및 초컴퍼넌트만이 포함되는 xs:duration 아류형입니다. 이 데이터형은 이름 공간 http://www.w3.org/2003/11/xpath-datatypes에 있습니다.

4개의 값은 모두 지정된 밀리 세컨드로부터 각각의 값을 계산하는 것에 의해 설정되어 작성된 Duration get 메서드를 사용해 사용 가능해집니다. 값은 아래의 항목에 준거해, 이것들에 의해 정의되고 있습니다.

• ISO 8601:2000(E) Section 5.5. 3.2 Alternative format
• 「W3C XML Schema 1.0 Part 2」의 부록 D 「ISO 8601 Date and Time Formats」
• XMLGregorianCalendar XML Schema 1.0 으로 Java 표현의 일시 데이터형의 대응 짓고

디폴트의 개시 인스턴스는 GregorianCalendar 가 그 기간의 개시를 사용하는 것에 의해 정의됩니다. 예로서Calendar.YEAR = 1970, Calendar.MONTH = Calendar.JANUARY, Calendar.DATE = 1 등을 들 수 있습니다. 태양력에는 변동이 있으므로 이것이 중요해집니다. 예를 들면, 윤년으로는 month = Calendar.FEBRUARY 날짜가 바뀌기 때문에 Duration.getDays() 결과에 영향이 나올 가능성이 있습니다.

날, 시간, 분 및 초를 결정한 뒤에 남는 밀리 세컨드는 파기됩니다.

파라미터:

durationInMilliseconds - 작성하는 Duration 밀리 세컨드

반환값:

지정된 durationInMilliseconds를 사용해 작성된 새로운 Duration

관련 항목:

「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」

newDurationDayTime

public Duration  newDurationDayTime(boolean isPositive,
                                   BigInteger  day,
                                   BigInteger  hour,
                                   BigInteger  minute,
                                   BigInteger  second)

「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」로 정의된 지정의 day, hour, minute 및 second를 사용해, xdt:dayTimeDuration 형의 Duration을 작성합니다.

데이터형 xdt:dayTimeDuration는 자구 표현에 날, 시간, 분 및 초컴퍼넌트만이 포함되는 xs:duration 아류형입니다. 이 데이터형은 이름 공간 http://www.w3.org/2003/11/xpath-datatypes에 있습니다.

XML schema 사양에서는 임의의 사이즈의 값을 받을 수가 있습니다. 구현은 큰 값 또는 작은 값, 혹은 이 양쪽 모두를 임의에 지원 하지 않는지, 혹은 지원 불가로 할까를 선택할 수 있습니다 . 구현 용량의 한계를 넘고 있는 경우는 구현 한계를 나타내는 메세지와 함께 UnsupportedOperationException을 발생시킵니다.

null값은 필드가 설정되어 있지 않은 것을 나타냅니다.

파라미터:

isPositive - false로 설정하면, 부의 듀레이션이 작성된다. 듀레이션의 길이가 0인 경우, 이 파라미터는 무시되는

day - Duration 날

hour - Duration 시간

minute - Duration 분

second - Duration 초

반환값:

지정된 day , hour, minute 및 second로 작성된 새로운 Duration

예외:

IllegalArgumentException - 값이 무효인 Duration을 작성했을 경우

UnsupportedOperationException - 구현이 요구된 값을 지원 할 수 없는 경우

newDurationDayTime

public Duration  newDurationDayTime(boolean isPositive,
                                   int day,
                                   int hour,
                                   int minute,
                                   int second)

「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」로 정의된 지정의 day, hour, minute 및 second를 사용해, xdt:dayTimeDuration 형의 Duration을 작성합니다.

데이터형 xdt:dayTimeDuration는 자구 표현에 날, 시간, 분 및 초컴퍼넌트만이 포함되는 xs:duration 아류형입니다. 이 데이터형은 이름 공간 http://www.w3.org/2003/11/xpath-datatypes에 있습니다.

DatatypeConstants.FIELD_UNDEFINED 값은 필드가 설정되어 있지 않은 것을 나타냅니다.

파라미터:

isPositive - false로 설정하면, 부의 듀레이션이 작성된다. 듀레이션의 길이가 0인 경우, 이 파라미터는 무시되는

day - Duration 날

hour - Duration 시간

minute - Duration 분

second - Duration 초

반환값:

지정된 day , hour, minute 및 second로 작성된 새로운 Duration

예외:

IllegalArgumentException - 값이 무효인 Duration을 작성했을 경우

newDurationYearMonth

public Duration  newDurationYearMonth(String  lexicalRepresentation)

String 표현, 「PnYnM」, 「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」를 구문 분석 하는 것에의해 xdt:yearMonthDuration 형의 Duration을 작성합니다.

데이터형 xdt:yearMonthDuration는 자구 표현에 의해 및 달컴퍼넌트만이 포함되는 xs:duration 아류형입니다. 이 데이터형은 이름 공간 XMLConstants.W3C_XPATH_DATATYPE_NS_URI에 있습니다.

양쪽 모두의 값은 모두 설정되어 있어 작성된 Duration 로부터 사용할 수 있습니다.

XML schema 사양에서는 임의의 사이즈의 값을 받을 수가 있습니다. 구현은 큰 값 또는 작은 값, 혹은 이 양쪽 모두를 임의에 지원 하지 않는지, 혹은 지원 불가로 할까를 선택할 수 있습니다 . 구현 용량의 한계를 넘고 있는 경우는 구현 한계를 나타내는 메세지와 함께 UnsupportedOperationException을 발생시킵니다.

파라미터:

lexicalRepresentation - 듀레이션의 자구 표현

반환값:

지정된 lexicalRepresentation을 사용해 작성된 새로운 Duration

예외:

IllegalArgumentException - lexicalRepresentation가 사양에 준거하지 않는 경우

UnsupportedOperationException - 구현이 요구된 값을 지원 할 수 없는 경우

NullPointerException - lexicalRepresentation가 null인 경우

newDurationYearMonth

public Duration  newDurationYearMonth(long durationInMilliseconds)

「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」로 정의된 지정 밀리 세컨드를 사용해, xdt:yearMonthDuration 형의 Duration을 작성합니다.

데이터형 xdt:yearMonthDuration는 자구 표현에 의해 및 달컴퍼넌트만이 포함되는 xs:duration 아류형입니다. 이 데이터형은 이름 공간 XMLConstants.W3C_XPATH_DATATYPE_NS_URI에 있습니다.

양쪽 모두의 값은 모두 지정된 밀리 세컨드로부터 각각의 값을 계산하는 것에 의해 설정되어 작성된 Duration get 메서드를 사용해 사용 가능해집니다. 값은 아래의 항목에 준거해, 그것들에 의해 정의되고 있습니다.

• ISO 8601:2000(E) Section 5.5. 3.2 Alternative format
• 「W3C XML Schema 1.0 Part 2」의 부록 D 「ISO 8601 Date and Time Formats」
• XMLGregorianCalendar XML Schema 1.0 으로 Java 표현의 일시 데이터형의 대응 짓고

디폴트의 개시 인스턴스는 GregorianCalendar 에 한 기간의 개시의 사용, 즉, Calendar.YEAR = 1970, Calendar.MONTH = Calendar.JANUARY, Calendar.DATE = 1 등에 의해 정의됩니다. 태양력에는 변동이 있으므로 이것이 중요해집니다. 예를 들면, 윤년으로는 month = Calendar.FEBRUARY 날짜가 바뀌기 때문에 Duration.getMonths() 결과에 영향이 나올 가능성이 있습니다.

해 및 달을 결정한 뒤에 남는 밀리 세컨드는 파기됩니다.

파라미터:

durationInMilliseconds - 작성하는 Duration 밀리 세컨드

반환값:

지정된 durationInMilliseconds를 사용해 작성된 새로운 Duration

newDurationYearMonth

public Duration  newDurationYearMonth(boolean isPositive,
                                     BigInteger  year,
                                     BigInteger  month)

「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」로 정의된 지정의 year 및 month를 사용해, xdt:yearMonthDuration 형의 Duration을 작성합니다.

XML schema 사양에서는 임의의 사이즈의 값을 받을 수가 있습니다. 구현은 큰 값 또는 작은 값, 혹은 이 양쪽 모두를 임의에 지원 하지 않는지, 혹은 지원 불가로 할까를 선택할 수 있습니다 . 구현 용량의 한계를 넘고 있는 경우는 구현 한계를 나타내는 메세지와 함께 UnsupportedOperationException을 발생시킵니다.

null값은 필드가 설정되어 있지 않은 것을 나타냅니다.

파라미터:

isPositive - false로 설정하면, 부의 듀레이션이 작성된다. 듀레이션의 길이가 0인 경우, 이 파라미터는 무시되는

year - Duration 해

month - Duration 달

반환값:

지정된 year 및 month를 사용해 작성된 새로운 Duration

예외:

IllegalArgumentException - 값이 무효인 Duration을 작성했을 경우

UnsupportedOperationException - 구현이 요구된 값을 지원 할 수 없는 경우

newDurationYearMonth

public Duration  newDurationYearMonth(boolean isPositive,
                                     int year,
                                     int month)

「XQuery 1.0 and XPath 2.0 Data Model」의 「xdt:dayTimeDuration」로 정의된 지정의 year 및 month를 사용해, xdt:yearMonthDuration 형의 Duration을 작성합니다.

DatatypeConstants.FIELD_UNDEFINED 값은 필드가 설정되어 있지 않은 것을 나타냅니다.

파라미터:

isPositive - false로 설정하면, 부의 듀레이션이 작성된다. 듀레이션의 길이가 0인 경우, 이 파라미터는 무시되는

year - Duration 해

month - Duration 달

반환값:

지정된 year 및 month를 사용해 작성된 새로운 Duration

예외:

IllegalArgumentException - 값이 무효인 Duration을 작성했을 경우

newXMLGregorianCalendar

public abstract XMLGregorianCalendar  newXMLGregorianCalendar()

XMLGregorianCalendar 새로운 인스턴스를 작성합니다.

모든 일시 데이터형 필드는 DatatypeConstants.FIELD_UNDEFINED 또는 null 로 설정됩니다.

반환값:

DatatypeConstants.FIELD_UNDEFINED 또는 null 로 설정된 모든 일시 데이터형 필드를 가지는 새로운 XMLGregorianCalendar

newXMLGregorianCalendar

public abstract XMLGregorianCalendar  newXMLGregorianCalendar(String  lexicalRepresentation)

자구 표현으로서 캐릭터 라인을 구문 분석 하는 것에의해 새로운 XMLGregorianCalendar를 작성합니다.

자구 캐릭터 라인 표현의 해석은, 「XML Schema 1.0 Part 2 섹션 3.2. [7-14]. 1 Lexical Representation」에 정의되고 있습니다.

캐릭터 라인 표현의 선두와 말미에 공백을 붙일 수 없습니다.

이 해석은 필드 마다 실행되기 때문에 다음에서는 자구 카미쇼 주위 임의의 캐릭터 라인 x를 보관 유지합니다.

 newXMLGregorianCalendar(x). toXMLFormat(). equals(x)
 

「XML Schema 1.0 errata 섹션 3.2. 7.2」에 기재된 자구 / 정규 표현의 현저한 불일치를 제외합니다.

파라미터:

lexicalRepresentation - 8개의 XML Schema 일시 데이터형의 자구 표현의 어느쪽이든 1개

반환값:

lexicalRepresentation로 부터 작성된 XMLGregorianCalendar

예외:

IllegalArgumentException - lexicalRepresentation가 유효한 XMLGregorianCalendar가 아닌 경우

NullPointerException - lexicalRepresentation가 null인 경우

newXMLGregorianCalendar

public abstract XMLGregorianCalendar  newXMLGregorianCalendar(GregorianCalendar  cal)

GregorianCalendar 로부터 XMLGregorianCalendar를 작성합니다.

GregorianCalendar 로부터 XMLGregorianCalendar 에의 필드 변환 대응표
java.util.GregorianCalendar 필드	javax.xml.datatype.XMLGregorianCalendar 필드
ERA == GregorianCalendar.BC ? -YEAR : YEAR	XMLGregorianCalendar.setYear(int year)
MONTH + 1	XMLGregorianCalendar.setMonth(int month)
DAY_OF_MONTH	XMLGregorianCalendar.setDay(int day)
HOUR_OF_DAY, MINUTE, SECOND, MILLISECOND	XMLGregorianCalendar.setTime(int hour, int minute, int second, BigDecimal fractional)
(ZONE_OFFSET + DST_OFFSET) / (60*1000) (분 단위)	XMLGregorianCalendar.setTimezone(int offset) *

* 정보의 변환 로스. XML Schema 1.0 일시 데이터형 표현으로java.util.GregorianCalendar 서머타임 타임 존 ID는 표현할 수 없다

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

• this.getTimezone() ! = FIELD_UNDEFINED인 경우, this.getTimezone()를 사용해, 커스텀 타임 존 ID 로 java.util.TimeZone을 작성한다
• 또는 java.util.TimeZone.getDefault()에 의해 지정되고 있도록, 호스트가 정의되고 있는 경우에 GregorianCalendar 디폴트 타임 존치를 사용한다

파라미터:

cal - XMLGregorianCalendar 작성에 사용되는 java.util.GregorianCalendar

반환값:

java.util.GregorianCalendar로 부터 작성되는 XMLGregorianCalendar

예외:

NullPointerException - cal가 null인 경우

newXMLGregorianCalendar

public abstract XMLGregorianCalendar  newXMLGregorianCalendar(BigInteger  year,
                                                             int month,
                                                             int day,
                                                             int hour,
                                                             int minute,
                                                             int second,
                                                             BigDecimal  fractionalSecond,
                                                             int timezone)

W3C XML Schema 1.0 recommendation 로 xsd:dateTime 및 관련된 빌트인 데이터형에 허가되고 있는 완전한 값공간을 가능하게 하는 생성자 입니다. year 파라미터는 큰 수를 임의로 지원 하고 있어, fractionalSecond에는 무한의 정밀도가 있는 것에 주의해 주세요.

null값은 필드가 설정되어 있지 않은 것을 나타냅니다.

파라미터:

year - 작성하는 XMLGregorianCalendar 해

month - 작성하는 XMLGregorianCalendar 달

day - 작성하는 XMLGregorianCalendar 날

hour - 작성하는 XMLGregorianCalendar 시간

minute - 작성하는 XMLGregorianCalendar 분

second - 작성하는 XMLGregorianCalendar 초

fractionalSecond - 작성하는 XMLGregorianCalendar fractionalSecond

timezone - 작성하는 XMLGregorianCalendar 타임 존

반환값:

지정치로부터 작성된 XMLGregorianCalendar

예외:

IllegalArgumentException - 개개의 파라미터의 값이, XMLGregorianCalendar 「일시 데이터 대응표」로 결정되는 것 같은 필드의 최대값 제한외의 경우, 혹은 복합치에 의해 XMLGregorianCalendar.isValid() 로 판정되는 무효인 XMLGregorianCalendar가 구성되는 경우

newXMLGregorianCalendar

public XMLGregorianCalendar  newXMLGregorianCalendar(int year,
                                                    int month,
                                                    int day,
                                                    int hour,
                                                    int minute,
                                                    int second,
                                                    int millisecond,
                                                    int timezone)

java.util.GregorianCalendar인스턴스를 XMLGregorianCalendar인스턴스로 변환할 필요가 있는 값영역의 생성자 입니다.

XMLGregorianCalendar eon 및 fractionalSecond는 null로 설정되어 있습니다.

DatatypeConstants.FIELD_UNDEFINED 값은 필드가 설정되어 있지 않은 것을 나타냅니다.

파라미터:

year - 작성하는 XMLGregorianCalendar 해

month - 작성하는 XMLGregorianCalendar 달

day - 작성하는 XMLGregorianCalendar 날

hour - 작성하는 XMLGregorianCalendar 시간

minute - 작성하는 XMLGregorianCalendar 분

second - 작성하는 XMLGregorianCalendar 초

millisecond - 작성하는 XMLGregorianCalendar 밀리 세컨드

timezone - 작성하는 XMLGregorianCalendar 타임 존

반환값:

지정치로부터 작성된 XMLGregorianCalendar

예외:

IllegalArgumentException - 개개의 파라미터의 값이, XMLGregorianCalendar 「일시 데이터 대응표」로 결정되는 것 같은 필드의 최대값 제한외의 경우, 혹은 복합치에 의해 XMLGregorianCalendar.isValid() 으로 판정되는 무효인 XMLGregorianCalendar가 구성되는 경우

newXMLGregorianCalendarDate

public XMLGregorianCalendar  newXMLGregorianCalendarDate(int year,
                                                        int month,
                                                        int day,
                                                        int timezone)

XML Schema 빌트인 데이터형 date 또는 g* Java 표현을 작성합니다.

예를 들어, gYear 인스턴스는 month 및 day 파라미터에 DatatypeConstants.FIELD_UNDEFINED를 설정해, 이 팩토리를 호출하면 작성할 수 있습니다.

DatatypeConstants.FIELD_UNDEFINED 값은 필드가 설정되어 있지 않은 것을 나타냅니다.

파라미터:

year - 작성하는 XMLGregorianCalendar 해

month - 작성하는 XMLGregorianCalendar 달

day - 작성하는 XMLGregorianCalendar 날

timezone - 분 단위의 오프셋(offset). DatatypeConstants.FIELD_UNDEFINED 는 옵션의 필드가 설정되어 있지 않은 것을 나타낸다

반환값:

파라미터값로부터 작성된 XMLGregorianCalendar

예외:

IllegalArgumentException - 개개의 파라미터의 값이, XMLGregorianCalendar 「일시 데이터 대응표」로 결정되는 것 같은 필드의 최대값 제한외의 경우, 혹은 복합치에 의해 XMLGregorianCalendar.isValid() 로 판정되는 무효인 XMLGregorianCalendar가 구성되는 경우

관련 항목:

DatatypeConstants.FIELD_UNDEFINED

newXMLGregorianCalendarTime

public XMLGregorianCalendar  newXMLGregorianCalendarTime(int hours,
                                                        int minutes,
                                                        int seconds,
                                                        int timezone)

XML Schema 빌트인 데이터형 time Java 인스턴스를 작성합니다.

DatatypeConstants.FIELD_UNDEFINED 값은 필드가 설정되어 있지 않은 것을 나타냅니다.

파라미터:

hours - 시간수

minutes - 분수

seconds - 초수

timezone - 분 단위의 오프셋(offset). DatatypeConstants.FIELD_UNDEFINED 는 옵션의 필드가 설정되어 있지 않은 것을 나타낸다

반환값:

파라미터값로부터 작성된 XMLGregorianCalendar

예외:

IllegalArgumentException - 개개의 파라미터의 값이, XMLGregorianCalendar 「일시 데이터 대응표」로 결정되는 것 같은 필드의 최대값 제한외의 경우, 혹은 복합치에 의해 XMLGregorianCalendar.isValid() 로 판정되는 무효인 XMLGregorianCalendar가 구성되는 경우

관련 항목:

DatatypeConstants.FIELD_UNDEFINED

newXMLGregorianCalendarTime

public XMLGregorianCalendar  newXMLGregorianCalendarTime(int hours,
                                                        int minutes,
                                                        int seconds,
                                                        BigDecimal  fractionalSecond,
                                                        int timezone)

XML Schema 빌트인 데이터형 time Java 인스턴스를 작성합니다.

null값은 필드가 설정되어 있지 않은 것을 나타냅니다.

DatatypeConstants.FIELD_UNDEFINED 값은 필드가 설정되어 있지 않은 것을 나타냅니다.

파라미터:

hours - 시간수

minutes - 분수

seconds - 초수

fractionalSecond - null값은 이 옵션의 필드가 설정되어 있지 않은 것을 나타내는

timezone - 분 단위의 오프셋(offset). DatatypeConstants.FIELD_UNDEFINED 는 옵션의 필드가 설정되어 있지 않은 것을 나타낸다

반환값:

파라미터값로부터 작성된 XMLGregorianCalendar

예외:

IllegalArgumentException - 개개의 파라미터의 값이, XMLGregorianCalendar 「일시 데이터 대응표」로 결정되는 것 같은 필드의 최대값 제한외의 경우, 혹은 복합치에 의해 XMLGregorianCalendar.isValid() 로 판정되는 무효인 XMLGregorianCalendar가 구성되는 경우

관련 항목:

DatatypeConstants.FIELD_UNDEFINED

newXMLGregorianCalendarTime

public XMLGregorianCalendar  newXMLGregorianCalendarTime(int hours,
                                                        int minutes,
                                                        int seconds,
                                                        int milliseconds,
                                                        int timezone)

XML Schema 빌트인 데이터형 time Java 인스턴스를 작성합니다.

DatatypeConstants.FIELD_UNDEFINED 값은 필드가 설정되어 있지 않은 것을 나타냅니다.

파라미터:

hours - 시간수

minutes - 분수

seconds - 초수

milliseconds - 밀리 세컨드수

timezone - 분 단위의 오프셋(offset). DatatypeConstants.FIELD_UNDEFINED 는 옵션의 필드가 설정되어 있지 않은 것을 나타낸다

반환값:

파라미터값로부터 작성된 XMLGregorianCalendar

예외:

IllegalArgumentException - 개개의 파라미터의 값이, XMLGregorianCalendar 「일시 데이터 대응표」로 결정되는 것 같은 필드의 최대값 제한외의 경우, 혹은 복합치에 의해 XMLGregorianCalendar.isValid() 로 판정되는 무효인 XMLGregorianCalendar가 구성되는 경우

관련 항목:

DatatypeConstants.FIELD_UNDEFINED