|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
java.lang.Objectjavax.xml.datatype.DatatypeFactory
public abstract class DatatypeFactory
XML を Java Object へ、あるいは Java Object からマップする新しい javax.xml.datatype Object を作成するファクトリです。
newInstance() を使用して新しい DatatypeFactory が作成されます。次の実装解決機構が、次の順序で使用されます。
DATATYPEFACTORY_PROPERTY によって指定されたシステムプロパティ、javax.xml.datatype.DatatypeFactory が存在する場合は、そのプロパティ値の名前を持つクラスがインスタンス化されます。インスタンス化のプロセス中にスローされた例外は、DatatypeConfigurationException としてラップされます。Properties Object にロードされます。その後、Properties Object が前のステップでドキュメント化され、前のステップでドキュメント化されたものとして処理されたプロパティに照会されます。META-INF/services/java.xml.datatype.DatatypeFactory などのサービス解決機構が使用されます。インスタンス化のプロセス中にスローされた例外は、DatatypeConfigurationException としてラップされます。DATATYPEFACTORY_IMPLEMENTATION_CLASS によって指定された Class 、javax.xml.datatype.DatatypeFactoryImpl のインスタンス化を試みます。インスタンス化のプロセス中にスローされた例外は、DatatypeConfigurationException としてラップされます。
| フィールドの概要 | |
|---|---|
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 |
| フィールドの詳細 |
|---|
public static final String DATATYPEFACTORY_PROPERTY
JSR 206: Java(TM) API for XML Processing (JAXP) 1.3 で定義されているデフォルトのプロパティ名です。
既定値は、javax.xml.datatype.DatatypeFactory です。
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 です。
| コンストラクタの詳細 |
|---|
protected DatatypeFactory()
パッケージ外部のインスタンス化を防ぐ protected コンストラクタです。
newInstance() を使用して DatatypeFactory を作成します。
| メソッドの詳細 |
|---|
public static DatatypeFactory newInstance()
throws DatatypeConfigurationException
DatatypeFactory の新しいインスタンスを取得します。
実装解決機構は、この Class のドキュメントで定義されています。
DocumentBuilderFactory の新しいインスタンス
DatatypeConfigurationException - 実装が使用できないかインスタンス化できない場合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 の場合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 メソッドを使って使用可能となります。値は、以下の項目に準拠し、これらによって定義されています。
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
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 - 実装が要求された値をサポートできない場合
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)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 の場合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 メソッドを使って使用可能となります。値は、以下の項目に準拠し、これらによって定義されています。
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
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 - 実装が要求された値をサポートできない場合
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 を作成した場合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 の場合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 メソッドを使って使用可能となります。値は、以下の項目に準拠し、それらによって定義されています。
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
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 - 実装が要求された値をサポートできない場合
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 を作成した場合public abstract XMLGregorianCalendar newXMLGregorianCalendar()
XMLGregorianCalendar の新しいインスタンスを作成します。
すべての日時データ型フィールドは、DatatypeConstants.FIELD_UNDEFINED または null に設定されます。
DatatypeConstants.FIELD_UNDEFINED または null に設定されたすべての日時データ型フィールドを持つ新しい XMLGregorianCalendarpublic 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 の場合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 の場合
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 のfractionalSecondtimezone - 作成する XMLGregorianCalendar のタイムゾーン
XMLGregorianCalendar
IllegalArgumentException - 個々のパラメータの値が、XMLGregorianCalendar の「日時データ対応表」で決定されるようなフィールドの最大値制限外の場合、あるいは複合値によって XMLGregorianCalendar.isValid() で判定される無効な XMLGregorianCalendar が構成される場合
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 が構成される場合
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
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
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
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
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。