|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object javax.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 に設定されたすべての日時データ型フィールドを持つ新しい XMLGregorianCalendar
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
の場合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 も参照してください。