クラスXMLGregorianCalendar

java.lang.Object
javax.xml.datatype.XMLGregorianCalendar
すべての実装されたインタフェース:
Cloneable
public abstract class XMLGregorianCalendar extends Object implements Cloneable

W3C XML Schema 1.0日時データ型の表現です。 特にこれらの日時データ型は、XML名前空間"http://www.w3.org/2001/XMLSchema"に定義されているDatatypeConstants.DATETIME、DatatypeConstants.TIME、DatatypeConstants.DATE、DatatypeConstants.GYEARMONTH、DatatypeConstants.GMONTHDAY、DatatypeConstants.GYEAR、DatatypeConstants.GMONTH、およびDatatypeConstants.GDAYです。 これらのデータ型は標準として「W3C XML Schema 1.0 Part 2」のセクション3.2.7 - 3.2.14に定義されています。

下の表に、XML Schema 1.0の日時データ型フィールドとこのクラスのフィールドの対応づけを定義します。 さらに、「W3C XML Schema 1.0 Part 2」の付録D「ISO 8601 Date and Time Formats」に定義されている日時フィールドの値の制約についてもまとめています。

XML Schema 1.0とJava表現の日時データ型の対応づけ
XML Schema 1.0
データ型
フィールド		 Related
XMLGregorianCalendar
Accessor(s)		 値の範囲
year getYear() + getEon()または
getEonAndYear() 		getYear()は、-(10^9-1)から(10^9)-1の値またはDatatypeConstants.FIELD_UNDEFINED。
getEon()は、数十億年単位の大きい桁の年の値。
getEon()は、(10^9)以上または -(10^9)以下の値を格納する。 nullの値はフィールドが定義されていないことを示す。
「XMLスキーマ1.0エラッタ」で、XMLスキーマの将来のバージョンで年0が有効な字句値であると指定されている場合、このクラスでは年フィールドをゼロに設定できます。 そうでない場合は、yearフィールドの値は正誤表および「SO-8601-1988」に記載されているとおりに処理される。 W3C XML Schema 1.0検証は、yearフィールドの値がゼロになることを許可しない。
month getMonth() 1 - 12またはDatatypeConstants.FIELD_UNDEFINED
day getDay() 月と関係なく、最大の範囲は1から31、またはDatatypeConstants.FIELD_UNDEFINED。
月フィールドの値に対する基準値制約は、「W3C XML Schema 1.0 Part 2、付録D 」にあります。
hour getHour() 0 - 23またはDatatypeConstants.FIELD_UNDEFINED。 minuteフィールド値とsecondフィールド値がゼロの場合、字句領域でhour値24を設定できる。 ただし、hour値24は値領域では許可されず、「XML Schema Part 2: Datatypes Second Edition」のプリミティブ・データ型に関する3.2に従って次の日の最初のインスタンスの値を表すよう変換される。
minute getMinute() 0 - 59またはDatatypeConstants.FIELD_UNDEFINED
second getSecond() + getMillisecond()/1000または
getSecond() + getFractionalSecond() 		0 - 60のgetSecond()またはDatatypeConstants.FIELD_UNDEFINED。
(Note: 60 only allowable for leap second.)
getFractionalSecond()は、getSecond()が定義されている場合に、0.0から1.0までの範囲で無限の精度を可能にします。
FractionalSecondはオプションであり、未定義の場合はnullの値を持ちます。
getMillisecond()は、getFractionalSecond()の値のミリ秒単位の精度です。
timezone getTimezone() 分数またはDatatypeConstants.FIELD_UNDEFINED。 -14時間(-14 * 60分)から14時間(14 * 60分)の範囲の値。

前述の表内のフィールドにリストされているすべての最大値領域制約は、このクラスのファクトリ・メソッド、DatatypeFactory、setterメソッドおよび解析メソッドによってチェックされます。 パラメータの値がフィールドの値制限外の場合、あるいは複合値によって無効なXMLGregorianCalendarインスタンスが構成される場合は、IllegalArgumentExceptionがスローされます(たとえば、6月31日が指定された場合などです)。

このクラスでは、次の処理が定義されます。

導入されたバージョン:
1.5
関連項目:

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    XMLGregorianCalendar()
    デフォルトの引数なしのコンストラクタです。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    abstract void
    add(Duration duration)
    このインスタンスにdurationを追加します。
    abstract void
    clear()
    すべてのフィールドを未定義に設定解除します。
    abstract Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    abstract int
    compare(XMLGregorianCalendar xmlGregorianCalendar)
    「W3C XML Schema 1.0 Part 2」のセクション3.2.7.3「Order relation on dateTime」に定義された部分順序リレーションに従って、W3C XML Schema 1.0日時データ型の2つのインスタンスを比較します。
    boolean
    equals(Object obj)
    このカレンダを指定されたオブジェクトと比較します。
    abstract int
    getDay()
    月の日またはDatatypeConstants.FIELD_UNDEFINEDを返します。
    abstract BigInteger
    getEon()
    yearのXML Schema 1.0 dateTimeデータ型フィールドの高順序コンポーネントを返します。
    abstract BigInteger
    getEonAndYear()
    yearのXMLスキーマの1.0 dateTimeデータ型フィールドを返します。
    abstract BigDecimal
    getFractionalSecond()
    小数秒を返します。
    abstract int
    getHour()
    時刻を返します。このフィールドが定義されていない場合はDatatypeConstants.FIELD_UNDEFINEDを返します。
    int
    getMillisecond()
    getFractionalSecond()のミリ秒の精度を返します。
    abstract int
    getMinute()
    時間の分を返します。このフィールドが定義されていない場合はDatatypeConstants.FIELD_UNDEFINEDを返します。
    abstract int
    getMonth()
    このカレンダの月またはDatatypeConstants.FIELD_UNDEFINEDを返します。
    abstract int
    getSecond()
    分単位の秒を返します。このフィールドが定義されていない場合はDatatypeConstants.FIELD_UNDEFINEDを返します。
    abstract int
    getTimezone()
    タイムゾーンのオフセットを分単位で返します。このオプション・フィールドが定義されていない場合は、DatatypeConstants.FIELD_UNDEFINEDを返します。
    abstract TimeZone
    getTimeZone(int defaultZoneoffset)
    このクラスのjava.util.TimeZoneを返します。
    abstract QName
    getXMLSchemaType()
    このインスタンスが対応するXML Schema日時型の名前を返します。
    abstract int
    getYear()
    yearまたはDatatypeConstants.FIELD_UNDEFINEDのXML Schema 1.0 dateTimeデータ型フィールドの下位コンポーネントを返します。
    int
    hashCode()
    equalsメソッドの定義に一致するハッシュ・コードを返します。
    abstract boolean
    isValid()
    getXMLSchemaType()定数によって、インスタンスを検証します。
    abstract XMLGregorianCalendar
    normalize()
    このインスタンスをUTCに正規化します。
    abstract void
    reset()
    このXMLGregorianCalendarを元の値にリセットします。
    abstract void
    setDay(int day)
    月の日数を設定します。
    abstract void
    setFractionalSecond(BigDecimal fractional)
    小数点以下の秒を設定します。
    abstract void
    setHour(int hour)
    時間を設定します。
    abstract void
    setMillisecond(int millisecond)
    ミリ秒を設定します。
    abstract void
    setMinute(int minute)
    分を設定します。
    abstract void
    setMonth(int month)
    月を設定します。
    abstract void
    setSecond(int second)
    秒を設定します。
    void
    setTime(int hour, int minute, int second)
    1単位として時間を設定します。
    void
    setTime(int hour, int minute, int second, int millisecond)
    オプションのミリ秒を含めて、時間を1単位として設定します。
    void
    setTime(int hour, int minute, int second, BigDecimal fractional)
    オプションの無限精度の小数点以下の秒を含む時間を1単位として設定します。
    abstract void
    setTimezone(int offset)
    タイムゾーン・オフセットに分数を設定します。
    abstract void
    setYear(int year)
    XSD dateTime年フィールドの年を設定します。
    abstract void
    setYear(BigInteger year)
    XSD dateTime年フィールドの下位および上位コンポーネントを設定します。
    abstract GregorianCalendar
    toGregorianCalendar()
    このXMLGregorianCalendarをGregorianCalendarに変換します。
    abstract GregorianCalendar
    toGregorianCalendar(TimeZone timezone, Locale aLocale, XMLGregorianCalendar defaults)
    提供されたパラメータに従って、このXMLGregorianCalendarをGregorianCalendarインスタンスに変換します。
    String
    toString()
    このXMLGregorianCalendar ObjectのString表現を返します。
    abstract String
    toXMLFormat()
    thisインスタンスの字句表現を返します。

    クラスオブジェクトで宣言されたメソッド

    finalize, getClass, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。