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 が存在する場合は、そのプロパティ値の名前を持つクラスがインスタンス化されます。インスタンス化のプロセス中にスローされた例外は、DatatypeConfigurationException としてラップされます。
2. ファイル ${JAVA_HOME}/lib/jaxp.properties が存在する場合は、Properties Object にロードされます。その後、Properties Object が前のステップでドキュメント化され、前のステップでドキュメント化されたものとして処理されたプロパティに照会されます。
3. META-INF/services/java.xml.datatype.DatatypeFactory などのサービス解決機構が使用されます。インスタンス化のプロセス中にスローされた例外は、DatatypeConfigurationException としてラップされます。
4. ファイナル機構が DATATYPEFACTORY_IMPLEMENTATION_CLASS によって指定された Class 、javax.xml.datatype.DatatypeFactoryImpl のインスタンス化を試みます。インスタンス化のプロセス中にスローされた例外は、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 スキーマ仕様では、任意のサイズの値をとることができます。実装は、大きい値または小さい値、あるいはこの両方を任意にサポートしないか、あるいはサポート不可とするかを選ぶことができます。実装容量の限界を超えている場合は、実装限界を示すメッセージとともに 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 スキーマ仕様では、任意のサイズの値をとることができます。実装は、大きい値または小さい値、あるいはこの両方を任意にサポートしないか、あるいはサポート不可とするかを選ぶことができます。実装容量の限界を超えている場合は、実装限界を示すメッセージとともに 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 スキーマ仕様では、任意のサイズの値をとることができます。実装は、大きい値または小さい値、あるいはこの両方を任意にサポートしないか、あるいはサポート不可とするかを選ぶことができます。実装容量の限界を超えている場合は、実装限界を示すメッセージとともに 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 スキーマ仕様では、任意のサイズの値をとることができます。実装は、大きい値または小さい値、あるいはこの両方を任意にサポートしないか、あるいはサポート不可とするかを選ぶことができます。実装容量の限界を超えている場合は、実装限界を示すメッセージとともに 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 スキーマ仕様では、任意のサイズの値をとることができます。実装は、大きい値または小さい値、あるいはこの両方を任意にサポートしないか、あるいはサポート不可とするかを選ぶことができます。実装容量の限界を超えている場合は、実装限界を示すメッセージとともに 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 スキーマ仕様では、任意のサイズの値をとることができます。実装は、大きい値または小さい値、あるいはこの両方を任意にサポートしないか、あるいはサポート不可とするかを選ぶことができます。実装容量の限界を超えている場合は、実装限界を示すメッセージとともに 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 - 分単位のオフセット。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 - 分単位のオフセット。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 - 分単位のオフセット。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 - 分単位のオフセット。DatatypeConstants.FIELD_UNDEFINED はオプションのフィールドが設定されていないことを示す

戻り値:

パラメータ値から作成された XMLGregorianCalendar

例外:

IllegalArgumentException - 個々のパラメータの値が、XMLGregorianCalendar の「日時データ対応表」で決定されるようなフィールドの最大値制限外の場合、あるいは複合値によって XMLGregorianCalendar.isValid() で判定される無効な XMLGregorianCalendar が構成される場合

関連項目:

DatatypeConstants.FIELD_UNDEFINED