XMLGregorianCalendar (Java Platform SE 8 )

java.lang.Object
- javax.xml.datatype.XMLGregorianCalendar

All Implemented Interfaces:: Cloneable

public abstract class XMLGregorianCalendar
extends Object
implements Cloneable

表示为W3C XML Schema 1日期/时间数据类型。具体而言，这些日期/时间数据类型DatatypeConstants.DATETIME，DatatypeConstants.TIME，DatatypeConstants.DATE，DatatypeConstants.GYEARMONTH，DatatypeConstants.GMONTHDAY，DatatypeConstants.GYEAR，DatatypeConstants.GMONTH，和DatatypeConstants.GDAY在XML命名空间"http://www.w3.org/2001/XMLSchema"定义。这些数据类型的规范中定义的W3C XML Schema 1.0 Part 2, Section 3.2.7-14。

下表定义了XML Schema 1日期/时间数据类型的字段，这类的字段之间的映射。总结了价值约束的日期和时间字段中定义的W3C XML Schema 1.0 Part 2, Appendix D, ISO 8601 Date and Time Formats。

Date/Time Datatype Field Mapping Between XML Schema 1.0 and Java Representation
XML Schema 1.0 datatype field	Related XMLGregorianCalendar Accessor(s)	Value Range
year	`getYear()` + `getEon()` or `getEonAndYear()`	`getYear()` is a value between -(10^9-1) to (10^9)-1 or `DatatypeConstants.FIELD_UNDEFINED`. `getEon()` is high order year value in billion of years. `getEon()` has values greater than or equal to (10^9) or less than or equal to -(10^9). A value of null indicates field is undefined. Given that XML Schema 1.0 errata states that the year zero will be a valid lexical value in a future version of XML Schema, this class allows the year field to be set to zero. Otherwise, the year field value is handled exactly as described in the errata and [ISO-8601-1988]. Note that W3C XML Schema 1.0 validation does not allow for the year field to have a value of zero.
month	`getMonth()`	1 to 12 or `DatatypeConstants.FIELD_UNDEFINED`
day	`getDay()`	Independent of month, max range is 1 to 31 or `DatatypeConstants.FIELD_UNDEFINED`. The normative value constraint stated relative to month field's value is in W3C XML Schema 1.0 Part 2, Appendix D.
hour	`getHour()`	0 to 23 or `DatatypeConstants.FIELD_UNDEFINED`. An hour value of 24 is allowed to be set in the lexical space provided the minute and second field values are zero. However, an hour value of 24 is not allowed in value space and will be transformed to represent the value of the first instance of the following day as per XML Schema Part 2: Datatypes Second Edition, 3.2 Primitive datatypes.
minute	`getMinute()`	0 to 59 or `DatatypeConstants.FIELD_UNDEFINED`
second	`getSecond()` + `getMillisecond()`/1000 or `getSecond()` + `getFractionalSecond()`	`getSecond()` from 0 to 60 or `DatatypeConstants.FIELD_UNDEFINED`. (Note: 60 only allowable for leap second.) `getFractionalSecond()` allows for infinite precision over the range from 0.0 to 1.0 when the `getSecond()` is defined. `FractionalSecond` is optional and has a value of `null` when it is undefined. `getMillisecond()` is the convenience millisecond precision of value of `getFractionalSecond()`.
timezone	`getTimezone()`	Number of minutes or `DatatypeConstants.FIELD_UNDEFINED`. Value range from -14 hours (-14 * 60 minutes) to 14 hours (14 * 60 minutes).

最大值空间限制上市上面表中的字段由工厂方法检查，“{链接datatypefactory }，setter方法，这类方法解析。IllegalArgumentException是当一个参数的值是在现场或者复合价值观构成了一个无效的xmlgregoriancalendar实例的值约束抛（例如，如果六月三十一日指定）。

下面的操作为这个类定义：

访问/修改独立的日期/时间字段
转换这类和W3C XML Schema 1词汇表征，toString()之间，DatatypeFactory.newXMLGregorianCalendar(String lexicalRepresentation)
这类GregorianCalendar之间转换，toGregorianCalendar(java.util.TimeZone timezone, java.util.Locale aLocale, XMLGregorianCalendar defaults)，DatatypeFactory
偏序关系比较的方法，compare(XMLGregorianCalendar xmlGregorianCalendar)
equals(Object)定义相对于compare(XMLGregorianCalendar xmlGregorianCalendar)。
与Duration实例中定义的 W3C XML Schema 1.0 Part 2, Appendix E, Adding durations to dateTimes加法运算。

从以下版本开始：: 一点五
另请参见：: Duration， DatatypeFactory

构造方法摘要

构造方法
Constructor and Description
`XMLGregorianCalendar()` 默认的无参数构造函数。

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract void`	`add(Duration duration)` 添加 `duration`这个实例。
`abstract void`	`clear()` 消除所有字段定义。
`abstract Object`	`clone()` 创建并返回此对象的副本。
`abstract int`	`compare(XMLGregorianCalendar xmlGregorianCalendar)` 比较两个实例的W3C XML Schema 1日期/时间数据类型根据偏序关系定义在 W3C XML Schema 1.0 Part 2, Section 3.2.7.3, Order relation on dateTime。
`boolean`	`equals(Object obj)` 将此日历与指定的对象进行比较。
`abstract int`	`getDay()` 在月或 `DatatypeConstants.FIELD_UNDEFINED`返回日。
`abstract BigInteger`	`getEon()` 返回的XML Schema 1日期时间数据类型字段 `year`高阶分量。
`abstract BigInteger`	`getEonAndYear()` 返回的XML Schema 1日期时间数据类型字段 `year`。
`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模式日期/时间类型的名称。
`abstract int`	`getYear()` 返回的XML Schema 1日期时间数据类型字段 `year`或 `DatatypeConstants.FIELD_UNDEFINED`低阶分量。
`int`	`hashCode()` 返回与等于方法的定义一致的哈希代码。
`abstract boolean`	`isValid()` 通过 `getXMLSchemaType()`约束验证实例。
`abstract XMLGregorianCalendar`	`normalize()` 规范此实例时。
`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)` 设置时间为一个单位。
`void`	`setTime(int hour, int minute, int second, BigDecimal fractional)` 设置时间为一个单位，包括可选的无限精密分数秒。
`void`	`setTime(int hour, int minute, int second, int millisecond)` 设置时间为一个单位，包括可选的毫秒。
`abstract void`	`setTimezone(int offset)` 集数分钟的时区偏移量。
`abstract void`	`setYear(BigInteger year)` 设置低和XSD `dateTime`年场高阶分量。
`abstract void`	`setYear(int year)` XSD `dateTime`年场年。
`abstract GregorianCalendar`	`toGregorianCalendar()` 将这一 `GregorianCalendar` `XMLGregorianCalendar`。
`abstract GregorianCalendar`	`toGregorianCalendar(TimeZone timezone, Locale aLocale, XMLGregorianCalendar defaults)` 把这 `XMLGregorianCalendar`随着提供的参数为 `GregorianCalendar`实例。
`String`	`toString()` 返回该 `XMLGregorianCalendar` `Object`一 `String`表示。
`abstract String`	`toXMLFormat()` 返回 `this`实例的词汇表征。

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail
- XMLGregorianCalendar
```
public XMLGregorianCalendar()
```
  默认的无参数构造函数。
  注：总是用DatatypeFactory构建XMLGregorianCalendar实例。这类的构造函数不能保证生产一致性状态的对象和未来可能会删除。

方法详细信息

clear
```
public abstract void clear()
```
消除所有字段定义。

设置所有的int字段DatatypeConstants.FIELD_UNDEFINED和参考字段为空。

reset
```
public abstract void reset()
```
这XMLGregorianCalendar复位到其原始值。

XMLGregorianCalendar设置为相同的值时DatatypeFactory.newXMLGregorianCalendar()，DatatypeFactory.newXMLGregorianCalendar(String lexicalRepresentation)，DatatypeFactory.newXMLGregorianCalendar( BigInteger year, int month, int day, int hour, int minute, int second, BigDecimal fractionalSecond, int timezone)，DatatypeFactory.newXMLGregorianCalendar( int year, int month, int day, int hour, int minute, int second, int millisecond, int timezone)，DatatypeFactory.newXMLGregorianCalendar(GregorianCalendar cal)，DatatypeFactory.newXMLGregorianCalendarDate( int year, int month, int day, int timezone)，DatatypeFactory.newXMLGregorianCalendarTime( int hours, int minutes, int seconds, int timezone)创建，DatatypeFactory.newXMLGregorianCalendarTime( int hours, int minutes, int seconds, BigDecimal fractionalSecond, int timezone)或DatatypeFactory.newXMLGregorianCalendarTime( int hours, int minutes, int seconds, int milliseconds, int timezone)。

reset()旨在让现有的XMLGregorianCalendars节约与新XMLGregorianCalendars创作相关资源的重用。

setYear
```
public abstract void setYear(BigInteger year)
```
设置低和XSD dateTime年场高阶分量。

取消这场通过调用setter和null参数值。

参数

year值限制了 year field of date/time field mapping table。

异常

IllegalArgumentException -如果 year参数以外的字段值的约束中指定的 date/time field mapping table。

setYear
```
public abstract void setYear(int year)
```
XSD dateTime年场年。

取消这场通过调用setter和DatatypeConstants.FIELD_UNDEFINED参数值。

注意：如果在year参数的绝对值小于9的10 ^，XSD年场EON组件设置null通过这种方法。

参数

year值约束进行了 year field of date/time field mapping table。如果今年 DatatypeConstants.FIELD_UNDEFINED，然后将 null EON。

setMonth
```
public abstract void setMonth(int month)
```
月设定。

取消这场通过调用setter和DatatypeConstants.FIELD_UNDEFINED参数值。

参数

month值限制了 month field of date/time field mapping table。

异常

IllegalArgumentException -如果 month参数以外的字段值的约束中指定的 date/time field mapping table。

setDay
```
public abstract void setDay(int day)
```
月定天数。

取消这场通过调用setter和DatatypeConstants.FIELD_UNDEFINED参数值。

参数

day值限制了 day field of date/time field mapping table。

异常

IllegalArgumentException -如果 day参数以外的字段值的约束中指定的 date/time field mapping table。

setTimezone
```
public abstract void setTimezone(int offset)
```
集数分钟的时区偏移量。

取消这场通过调用setter和DatatypeConstants.FIELD_UNDEFINED参数值。

参数

offset值限制了 timezone field of date/time field mapping table。

异常

IllegalArgumentException -如果 offset参数以外的字段值的约束中指定的 date/time field mapping table。

setTime
```
public void setTime(int hour,
                    int minute,
                    int second)
```
设置时间为一个单位。

参数

hour值约束进行了 hour field of date/time field mapping table。

minute值约束进行了 minute field of date/time field mapping table。

second值约束进行了 second field of date/time field mapping table。

异常

IllegalArgumentException -如果任何参数以外的字段值的约束中指定的 date/time field mapping table。

另请参见：

setTime(int, int, int, BigDecimal)

setHour
```
public abstract void setHour(int hour)
```
设置时间。

取消这场通过调用setter和DatatypeConstants.FIELD_UNDEFINED参数值。

参数

hour值限制了 hour field of date/time field mapping table。

异常

IllegalArgumentException -如果 hour参数以外的字段值的约束中指定的 date/time field mapping table。

setMinute
```
public abstract void setMinute(int minute)
```
设置分钟。

取消这场通过调用setter和DatatypeConstants.FIELD_UNDEFINED参数值。

参数

minute值限制了 minute field of date/time field mapping table。

异常

IllegalArgumentException -如果 minute参数以外的字段值的约束中指定的 date/time field mapping table。

setSecond
```
public abstract void setSecond(int second)
```
设置秒。

取消这场通过调用setter和DatatypeConstants.FIELD_UNDEFINED参数值。

参数

second值限制了 second field of date/time field mapping table。

异常

IllegalArgumentException -如果 second参数以外的字段值的约束中指定的 date/time field mapping table。

setMillisecond
```
public abstract void setMillisecond(int millisecond)
```
设置毫秒。

取消这场通过调用setter和DatatypeConstants.FIELD_UNDEFINED参数值。

参数

millisecond值限制了 second field of date/time field mapping table。

异常

IllegalArgumentException -如果 millisecond参数以外的字段值的约束中指定的 date/time field mapping table。

setFractionalSecond
```
public abstract void setFractionalSecond(BigDecimal fractional)
```
设置分数秒。

取消这场通过调用setter和null参数值。

参数

fractional值限制了 second field of date/time field mapping table。

异常

IllegalArgumentException -如果 fractional参数以外的字段值的约束中指定的 date/time field mapping table。

setTime
```
public void setTime(int hour,
                    int minute,
                    int second,
                    BigDecimal fractional)
```
设置时间为一个单位，包括可选的无限精密分数秒。

参数

hour值约束进行了 hour field of date/time field mapping table。

minute值约束进行了 minute field of date/time field mapping table。

second值约束进行了 second field of date/time field mapping table。

fractional值 null表示未设置此可选字段。

异常

IllegalArgumentException -如果任何参数以外的字段值的约束中指定的 date/time field mapping table。

setTime
```
public void setTime(int hour,
                    int minute,
                    int second,
                    int millisecond)
```
设置时间为一个单位，包括可选的毫秒。

参数

hour值约束进行了 hour field of date/time field mapping table。

minute值约束进行了 minute field of date/time field mapping table。

second值约束进行了 second field of date/time field mapping table。

millisecond值 DatatypeConstants.FIELD_UNDEFINED表示未设置此可选字段。

异常

IllegalArgumentException -如果任何参数以外的字段值的约束中指定的 date/time field mapping table。

getEon
```
public abstract BigInteger getEon()
```
返回的XML Schema datetime数据类型year 1场高阶分量。如果这一年的null可选字段部分未定义。

这个值的约束进行了year field of date/time field mapping table。

结果

EON这 XMLGregorianCalendar。返回的值是10的整数倍^ 9。

另请参见：

getYear()， getEonAndYear()

getYear
```
public abstract int getYear()
```
返回的XML Schema 1日期时间数据类型字段year或DatatypeConstants.FIELD_UNDEFINED低阶分量。

这个值的约束进行了year field of date/time field mapping table。

结果

这 XMLGregorianCalendar年。

另请参见：

getEon()， getEonAndYear()

getEonAndYear
```
public abstract BigInteger getEonAndYear()
```
返回的XML Schema 1日期时间数据类型字段year。

这个值的约束进行了year field of date/time field mapping table。

结果

笔 eon和 BigInteger.valueOf(year)当字段定义。只有 year定义，返回。当 eon和 year没有定义，返回 null。

另请参见：

getEon()， getYear()

getMonth
```
public abstract int getMonth()
```
返回或DatatypeConstants.FIELD_UNDEFINED数月。

这个值的约束进行了month field of date/time field mapping table。

结果

这 XMLGregorianCalendar年。

getDay
```
public abstract int getDay()
```
在月或 DatatypeConstants.FIELD_UNDEFINED返回日。

这个值的约束进行了day field of date/time field mapping table。

另请参见：

setDay(int)

getTimezone
```
public abstract int getTimezone()
```
返回时区偏移在几分钟或 DatatypeConstants.FIELD_UNDEFINED如果这个字段没有定义。
这个值的约束进行了timezone field of date/time field mapping table。

另请参见：

setTimezone(int)

getHour
```
public abstract int getHour()
```
返回时间或 DatatypeConstants.FIELD_UNDEFINED。返回 DatatypeConstants.FIELD_UNDEFINED如果这个字段没有定义。
这个值的约束进行了hour field of date/time field mapping table。

另请参见：

setTime(int, int, int)

getMinute
```
public abstract int getMinute()
```
返回分钟或 DatatypeConstants.FIELD_UNDEFINED。
返回 DatatypeConstants.FIELD_UNDEFINED如果这个字段没有定义。
这个值的约束进行了minute field of date/time field mapping table。

另请参见：

setTime(int, int, int)

getSecond
```
public abstract int getSecond()
```
返回秒或DatatypeConstants.FIELD_UNDEFINED。

返回DatatypeConstants.FIELD_UNDEFINED如果这个字段没有定义。当这场是没有定义的，可选的XS：datetime小数秒的领域，通过getFractionalSecond()和getMillisecond()表示，不能确定。

这个值的约束进行了second field of date/time field mapping table。

结果

这 XMLGregorianCalendar二。

另请参见：

getFractionalSecond()， getMillisecond()， setTime(int, int, int)

getMillisecond
```
public int getMillisecond()
```
对getFractionalSecond()返回毫秒精度。

这种方法是一种方便的访问到无限精度小数秒的返回值getFractionalSecond()。返回值是圆形的到getFractionalSecond()毫秒值。当getFractionalSecond()返回null，这个方法必须返回DatatypeConstants.FIELD_UNDEFINED。

这个值的约束进行了second field of date/time field mapping table。

结果

这 XMLGregorianCalendar毫秒。

另请参见：

getFractionalSecond()， setTime(int, int, int)

getFractionalSecond
```
public abstract BigDecimal getFractionalSecond()
```
返回分数秒。

null时返回此可选字段没有定义。

价值的详细约束在second field of date/time field mapping table。

本字段只能有一个明确的价值当xs：日期时间第二场，由getSecond()，不返回DatatypeConstants.FIELD_UNDEFINED。

结果

这 XMLGregorianCalendar分数秒。

另请参见：

getSecond()， setTime(int, int, int, BigDecimal)

compare
```
public abstract int compare(XMLGregorianCalendar xmlGregorianCalendar)
```
比较两个实例的W3C XML Schema 1日期/时间数据类型根据偏序关系定义在W3C XML Schema 1.0 Part 2, Section 3.2.7.3, Order relation on dateTime。

xsd:dateTime数据类型的字段映射到该类的访问器定义在date/time field mapping table。

参数

xmlGregorianCalendar实例的 XMLGregorianCalendar比较

结果

this XMLGregorianCalendar和指定的 xmlGregorianCalendar作为 DatatypeConstants.LESSER， DatatypeConstants.EQUAL之间的关系， DatatypeConstants.GREATER或 DatatypeConstants.INDETERMINATE。

异常

NullPointerException -如果 xmlGregorianCalendar是空的。

normalize
```
public abstract XMLGregorianCalendar normalize()
```
规范此实例时。

2000-03-04t23:00:00 +规范化2000-03-04t20:00:00z 03:00

实现了W3C XML Schema部分2、部分3.2.7.3（一）。

结果

this XMLGregorianCalendar归一化UTC。

equals
```
public boolean equals(Object obj)
```
将此日历与指定的对象进行比较。其结果是true当且仅当参数不为空，是一个XMLGregorianCalendar表示在时间这个对象的一瞬间。

重写：

equals 方法重写，继承类 Object

参数

obj -比较。

结果

true当 obj是 XMLGregorianCalendar和 compare(XMLGregorianCalendar obj)返回 DatatypeConstants.EQUAL实例，否则 false。

另请参见：

Object.hashCode()， HashMap

hashCode
```
public int hashCode()
```
返回与等于方法的定义一致的哈希代码。

重写：

hashCode 方法重写，继承类 Object

结果

此对象的哈希代码。

另请参见：

Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)

toXMLFormat
```
public abstract String toXMLFormat()
```
返回this实例的词汇表征。格式是指定在XML Schema 1.0 Part 2, Section 3.2.[7-14].1, Lexical Representation".

具体的目标词汇表示格式是由getXMLSchemaType()。

结果

XML作为 String，这 XMLGregorianCalendar表示

异常

IllegalStateException -如果设置字段的组合不匹配的八个定义的XML架构内置的日期/时间数据类型。

getXMLSchemaType

public abstract QName getXMLSchemaType()

返回此实例映射到的XML模式日期/时间类型的名称。类型是基于设置的字段计算的。

Required fields for XML Schema 1.0 Date/Time Datatypes. (timezone is optional for all date/time datatypes)
Datatype	year	month	day	hour	minute	second
`DatatypeConstants.DATETIME`	X	X	X	X	X	X
`DatatypeConstants.DATE`	X	X	X
`DatatypeConstants.TIME`				X	X	X
`DatatypeConstants.GYEARMONTH`	X	X
`DatatypeConstants.GMONTHDAY`		X	X
`DatatypeConstants.GYEAR`	X
`DatatypeConstants.GMONTH`		X
`DatatypeConstants.GDAY`			X

结果: 下面的一个类常量： DatatypeConstants.DATETIME， DatatypeConstants.TIME， DatatypeConstants.DATE， DatatypeConstants.GYEARMONTH， DatatypeConstants.GMONTHDAY， DatatypeConstants.GYEAR， DatatypeConstants.GMONTH或 DatatypeConstants.GDAY。
异常: IllegalStateException -如果设置字段的组合不匹配的八个定义的XML架构内置的日期/时间数据类型。

toString
```
public String toString()
```
返回该XMLGregorianCalendar Object一String表示。

其结果是一个词汇表征所产生的toXMLFormat()。

重写：

toString 方法重写，继承类 Object

结果

非 null有效 String表示这 XMLGregorianCalendar。

异常

IllegalStateException -如果设置字段的组合不匹配的八个定义的XML架构内置的日期/时间数据类型。

另请参见：

toXMLFormat()

isValid
```
public abstract boolean isValid()
```
通过 getXMLSchemaType()约束验证实例。

结果

如果数据值是有效的。

add
```
public abstract void add(Duration duration)
```
添加duration这个实例。

计算指定在XML Schema 1.0 Part 2, Appendix E, Adding durations to dateTimes>。date/time field mapping table定义映射的XML Schema 1 dateTime领域，这些领域这类的表示。

参数

duration时间添加到这 XMLGregorianCalendar。

异常

NullPointerException当 duration参数 null。

toGregorianCalendar

public abstract GregorianCalendar toGregorianCalendar()

将这一GregorianCalendar XMLGregorianCalendar。

当this实例具有一个未定义的领域，这一转换依赖于其相应的领域java.util.GregorianCalendar默认。XML Schema 1日期/时间数据类型和java.util.GregorianCalendar之间的显著区别是时区值为日期/时间数据类型，它是java.util.GregorianCalendar必填字段可选。看javadoc java.util.TimeZone.getDefault()如何预设确定。显式地指定TimeZone实例，看toGregorianCalendar(TimeZone, Locale, XMLGregorianCalendar)。

Field by Field Conversion from this class to `java.util.GregorianCalendar`
`java.util.GregorianCalendar` field	`javax.xml.datatype.XMLGregorianCalendar` field
`ERA`	`getEonAndYear().signum() < 0 ? GregorianCalendar.BC : GregorianCalendar.AD`
`YEAR`	`getEonAndYear().abs().intValue()`*
`MONTH`	`getMonth()` - `DatatypeConstants.JANUARY` + `Calendar.JANUARY`
`DAY_OF_MONTH`	`getDay()`
`HOUR_OF_DAY`	`getHour()`
`MINUTE`	`getMinute()`
`SECOND`	`getSecond()`
`MILLISECOND`	get millisecond order from `getFractionalSecond()`*
`GregorianCalendar.setTimeZone(TimeZone)`	`getTimezone()` formatted into Custom timezone id

*指定由于源数据类型数据类型具有比目标高精度转换期间丢失精度。

为保证转换实现的一致性，新的GregorianCalendar应该实例化方式如下。

使用timeZone值如上定义，创建一个新的java.util.GregorianCalendar(timeZone,Locale.getDefault())。
通过调用初始化所有字段Calendar.clear()公历。
通过调用GregorianCalendar.setGregorianChange( new Date(Long.MIN_VALUE))获得纯阳历。
其领域的时代，年，月，day_of_month，hour_of_day，分钟，二和毫秒设置使用方法Calendar.set(int,int)

另请参见：: toGregorianCalendar(java.util.TimeZone, java.util.Locale, XMLGregorianCalendar)

toGregorianCalendar
```
public abstract GregorianCalendar toGregorianCalendar(TimeZone timezone,
                                                      Locale aLocale,
                                                      XMLGregorianCalendar defaults)
```
把这XMLGregorianCalendar随着提供的参数为GregorianCalendar实例。

由于XML Schema 1日期/时间datetypes没有时区标识或夏令时区IDS的概念，这个转换操作允许用户显式地指定一个timezone参数。

计算返回值的TimeZone场，
- 当参数timeZone非空，它是时区的领域。
- 别的，this.getTimezone() != FIELD_UNDEFINED，创建一个使用this.getTimezone()自定义时区ID java.util.TimeZone。
- 别的，defaults.getTimezone() != FIELD_UNDEFINED，创建一个使用defaults.getTimezone()自定义时区ID java.util.TimeZone。
- 其他人使用的GregorianCalendar默认时区值为主机定义为指定的java.util.TimeZone.getDefault()。
参数

timezone提供时区。 null是法律价值。

aLocale提供明确的现场。如果使用默认值 null公历现场。

defaults提供默认字段值时要使用的相应字段的这个实例是field_undefined或空。如果在指定的 defaults defaultsis null或一场是未定义的，只是用 java.util.GregorianCalendar违约。

结果

这一实例java.util.gregoriancalendar转换。

getTimeZone
```
public abstract TimeZone getTimeZone(int defaultZoneoffset)
```
返回该类java.util.TimeZone。

如果时区领域是该实例的定义，返回时区与时区ID zoneoffset自定义初始化。如果时区字段定义，尝试defaultzoneoffset，通过。如果defaultzoneoffset是field_undefined，此主机返回的默认时区。（如java，util。GregorianCalendar相同的默认）。

参数

defaultZoneoffset违约zoneoffset如果这zoneoffset是 DatatypeConstants.FIELD_UNDEFINED。

结果

时区这。

clone
```
public abstract Object clone()
```
创建并返回此对象的副本。

重写：

clone 方法重写，继承类 Object

结果

这 Object复制

另请参见：

Cloneable

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class XMLGregorianCalendar

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

XMLGregorianCalendar

方法详细信息

clear

reset

setYear

setYear

setMonth

setDay

setTimezone

setTime

setHour

setMinute

setSecond

setMillisecond

setFractionalSecond

setTime

setTime

getEon

getYear

getEonAndYear

getMonth

getDay

getTimezone

getHour

getMinute

getSecond

getMillisecond

getFractionalSecond

compare

normalize

equals

hashCode

toXMLFormat

getXMLSchemaType

toString

isValid

add

toGregorianCalendar

toGregorianCalendar

getTimeZone

clone