DatatypeFactory (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세 : 필드 | 생성자 | 메소드

javax.xml.datatype
클래스 DatatypeFactory

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

public abstract class DatatypeFactory
extends Object
extends Object

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

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

DATATYPEFACTORY_PROPERTY 에 의해 지정된 시스템 프로퍼티,javax.xml.datatype.DatatypeFactory 가 존재하는 경우는, 그 프로퍼티치의 이름을 가지는 클래스가 인스턴스화 됩니다. 인스턴스화의 프로세스중에 throw 된 예외는,DatatypeConfigurationException 로서 랩 됩니다.
파일 ${JAVA_HOME}/lib/jaxp.properties 이 존재하는 경우는,Properties Object 에 로드 됩니다. 그 후,Properties Object 가 전의 스텝에서 문서화 되어 전의 스텝에서 문서화 된 것으로서 처리된 프로퍼티에 조회됩니다.
META-INF/services/java.xml.datatype.DatatypeFactory 등의 서비스 해결 기구가 사용됩니다. 인스턴스화의 프로세스중에 throw 된 예외는,DatatypeConfigurationException 로서 랩 됩니다.
The final mechanism is to attempt to instantiate the Class specified by DATATYPEFACTORY_IMPLEMENTATION_CLASS . 인스턴스화의 프로세스중에 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` 의 새로운 인스턴스를 가져옵니다.
`static DatatypeFactory`	`newInstance (String factoryClassName, ClassLoader classLoader)` `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 으로 정의되고 있는 디폴트의 구현 클래스명입니다.

그 외의 구현 해결 기구가 성공하지 않는 경우, 구현은 인스턴스화 되는 적절한 클래스의 이름을 지정할 필요가 있습니다.

사용자는 이 필드를 참조해야 하지는 않습니다. 팩토리 구현의 상세를 문서화하는 것만을 목적으로 하고 있습니다.

생성자 의 상세

DatatypeFactory

protected DatatypeFactory()

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

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

메소드의 상세

newInstance

public static DatatypeFactory  newInstance()
                                   throws DatatypeConfigurationException

DatatypeFactory 의 새로운 인스턴스를 가져옵니다.

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

반환값:: DatatypeFactory 의 새로운 인스턴스
예외:: DatatypeConfigurationException - 구현을 사용할 수 없는가 인스턴스화할 수 없는 경우
관련 항목:: newInstance(String factoryClassName, ClassLoader classLoader)

newInstance

public static DatatypeFactory  newInstance(String  factoryClassName,
                                          ClassLoader  classLoader)
                                   throws DatatypeConfigurationException

DatatypeFactory 의 새로운 인스턴스를 클래스명으로부터 가져옵니다. 이 함수는, 클래스 패스에 복수의 프로바이더가 있는 경우에 편리합니다. 어느 프로바이더가 로드 되는지를 지정할 수 있기 (위해)때문에, 어플리케이션을 한층 더 제어할 수 있습니다.

어플리케이션이 DatatypeFactory 에의 참조를 취득하면(자), 팩토리를 사용해 데이터형의 인스턴스를 설정 및 취득할 수가 있습니다.

트러블 슈팅의 힌트

jaxp.debug 시스템 프로퍼티을 설정하면(자), 이 메소드는 실행중의 처리나 검색하고 있는 장소에 관한 대량의 디버그 메세지를 System.err 에 출력합니다.

문제가 있는 경우, 다음과 같이 합니다.

 java -Djaxp.debug=1 YourProgram ....

파라미터:: factoryClassName - javax.xml.datatype.DatatypeFactory 의 구현을 제공하는, 완전 수식의 팩토리 클래스명입니다.; classLoader - 팩토리 클래스의 로드에 사용되는 ClassLoader. null 의 경우는 현재의 Thread 의 문맥 classLoader 가, 팩토리 클래스의 로드에 사용됩니다.
반환값:: DatatypeFactory 의 새로운 인스턴스
예외:: DatatypeConfigurationException - factoryClassName 가 null, 또는, 팩토리 클래스가 로드, 인스턴스화할 수 없는 경우.
도입된 버젼:: 1.6
관련 항목:: newInstance()

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 가 throw 됩니다.

파라미터:: 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 의 새로운 인스턴스를 가져옵니다.

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

파라미터:: isPositive - false 로 설정하면(자), 부의 듀레이션이 작성된다. 듀레이션의 길이가 0 의 경우, 이 파라미터는 무시되는; years - 이 Duration 의 초; months - 이 Duration 의 초; days - 이 Duration 의 초; hours - 이 Duration 의 초; minutes - 이 Duration 의 초; seconds - 이 Duration 의 초
반환값:: 지정된 값으로부터 작성된 새로운 Duration
예외:: IllegalArgumentException - 치가 Duration 의 표현으로서 무효인 경우. 모든 필드 (years, months, ...)(이)가 null 또는 몇개의 필드가 부의 경우; 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( 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 의 subtype입니다. 이 데이터형은, 이름 공간 http://www.w3.org/2003/11/xpath-datatypes 에 있습니다.

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

파라미터:: lexicalRepresentation - 듀레이션의 자구 표현
반환값:: 지정된 lexicalRepresentation 를 사용해 작성된 새로운 Duration
예외:: IllegalArgumentException - lexicalRepresentation 이 날 및 때에서만으로 나타내지고 있는 Duration 의 표현으로서 무효인 경우; UnsupportedOperationException - 구현이 요구된 값을 지원할 수 없는 경우; NullPointerException - lexicalRepresentation 가 null 의 경우

newDurationDayTime

public Duration  newDurationDayTime(long durationInMilliseconds)

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

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 를 작성합니다.

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

파라미터:: isPositive - false 로 설정하면(자), 부의 듀레이션이 작성된다. 듀레이션의 길이가 0 의 경우, 이 파라미터는 무시되는; day - Duration 의 날; hour - Duration 의 시간; minute - Duration 의 분; second - Duration 의 초
반환값:: 지정된 day ,hour,minute, 및 second 로 작성된 새롭다 Duration
예외:: IllegalArgumentException - 치가 Duration 의 표현으로서 무효인 경우. 모든 필드 (day, hour, ...)(이)가 null 또는 몇개의 필드가 부의 경우; UnsupportedOperationException - 구현이 요구된 값을 지원할 수 없는 경우

newDurationDayTime

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

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

파라미터:: isPositive - false 로 설정하면(자), 부의 듀레이션이 작성된다. 듀레이션의 길이가 0 의 경우, 이 파라미터는 무시되는; day - Duration 의 날; hour - Duration 의 시간; minute - Duration 의 분; second - Duration 의 초
반환값:: 지정된 day ,hour,minute, 및 second 로 작성된 새롭다 Duration
예외:: IllegalArgumentException - 치가 Duration 의 표현으로서 무효인 경우. 몇개의 필드가 (day, hour, ...)(이)가 부의 경우

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 의 subtype입니다. 이 데이터형은, 이름 공간 XMLConstants.W3C_XPATH_DATATYPE_NS_URI 에 있습니다.

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

파라미터:: lexicalRepresentation - 듀레이션의 자구 표현
반환값:: 지정된 lexicalRepresentation 를 사용해 작성된 새로운 Duration
예외:: IllegalArgumentException - lexicalRepresentation 가 해 및 달에서만으로 나타내지고 있는 Duration 의 표현으로서 유효하지 않은 경우; UnsupportedOperationException - 구현이 요구된 값을 지원할 수 없는 경우; NullPointerException - lexicalRepresentation 가 null 의 경우

newDurationYearMonth

public Duration  newDurationYearMonth(long durationInMilliseconds)

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

양쪽 모두의 값은 모두 지정된 밀리 세컨드로부터 각각의 값을 계산하는 것에 의해 설정되어 작성된 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 를 작성합니다.

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

파라미터:: isPositive - false 로 설정하면(자), 부의 듀레이션이 작성된다. 듀레이션의 길이가 0 의 경우, 이 파라미터는 무시되는; year - Duration 의 해; month - Duration 의 달
반환값:: 지정된 year 및 month 를 사용해 작성된 새로운 Duration
예외:: IllegalArgumentException - 치가 Duration 의 표현으로서 무효인 경우. 모든 필드 (year, month, ...)(이)가 null 또는 몇개의 필드가 부의 경우; 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 의 표현으로서 무효인 경우. 몇개의 필드 (year, month)가 부의 경우

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 의 날; 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

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세 : 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

javax.xml.datatype 클래스 DatatypeFactory

DATATYPEFACTORY_PROPERTY

DATATYPEFACTORY_IMPLEMENTATION_CLASS

DatatypeFactory

newInstance

newInstance

트러블 슈팅의 힌트

newDuration

newDuration

newDuration

newDuration

newDurationDayTime

newDurationDayTime

newDurationDayTime

newDurationDayTime

newDurationYearMonth

newDurationYearMonth

newDurationYearMonth

newDurationYearMonth

newXMLGregorianCalendar

newXMLGregorianCalendar

newXMLGregorianCalendar

newXMLGregorianCalendar

newXMLGregorianCalendar

newXMLGregorianCalendarDate

newXMLGregorianCalendarTime

newXMLGregorianCalendarTime

newXMLGregorianCalendarTime

javax.xml.datatype
클래스 DatatypeFactory