XMLGregorianCalendar

XMLGregorianCalendar

XMLGregorianCalendar ()

add

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.0 dateTime字段到该类的这些字段表示的映射。

clear

void clear ()

取消将所有字段设置为未定义。

将所有int字段设置为 FIELD_UNDEFINED并将引用字段设置为null。

clone

Object clone ()

创建并返回此对象的副本。

compare

int compare (XMLGregorianCalendar xmlGregorianCalendar)

根据 W3C XML Schema 1.0 Part 2, Section 3.2.7.3, Order relation on dateTime中定义的部分顺序关系比较W3C XML Schema 1 . 0日期/时间数据类型的两个实例。

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

equals

boolean equals (Object obj)

指示参数 obj是否“等于”这一个。

getDay

int getDay ()

每月返回一天或 FIELD_UNDEFINED 。

该值的值限制总结在 day field of date/time field mapping table中 。

getEon

BigInteger getEon ()

为year返回XML Schema 1.0 dateTime数据类型字段的year 。 null如果这个年份字段的这个可选部分没有定义。

year field of date/time field mapping table中汇总了此值的值限制。

getEonAndYear

BigInteger getEonAndYear ()

返回XML Schema 1.0 dateTime数据类型字段为 year 。

这个值的价值限制总结在 year field of date/time field mapping table 。

getFractionalSecond

BigDecimal getFractionalSecond ()

返回小数秒。

null此可选字段时将返回 null 。

价值限制详见 second field of date/time field mapping table 。

当xs：dateTime第二个字段（由 getSecond()表示）不返回 FIELD_UNDEFINED时，此可选字段只能有一个定义的值。

getHour

int getHour ()

返回小时或FIELD_UNDEFINED 。 如果此字段FIELD_UNDEFINED则返回FIELD_UNDEFINED 。

hour field of date/time field mapping table中汇总了此值的限制值。

getMillisecond

int getMillisecond ()

返回毫秒级精度 getFractionalSecond() 。

此方法表示一个方便的访问器，以无限精度分数秒值返回getFractionalSecond() 。 返回的值是舍入到毫秒getFractionalSecond()值。 当getFractionalSecond()返回null ，此方法必须返回FIELD_UNDEFINED 。

second field of date/time field mapping table中总结了此值的值限制。

getMinute

int getMinute ()

返回分钟或 FIELD_UNDEFINED 。

这个值的价值限制总结在 minute field of date/time field mapping table 。

getMonth

int getMonth ()

返回月数或 FIELD_UNDEFINED 。

该值的值限制总结在 month field of date/time field mapping table中 。

getSecond

int getSecond ()

返回秒或 FIELD_UNDEFINED 。

如果未定义此字段，则返回FIELD_UNDEFINED 。 未定义此字段时，不能定义可选的xs：dateTime小数秒字段（由getFractionalSecond()和getMillisecond()表示）。

second field of date/time field mapping table中总结了此值的价值限制。

getTimeZone

TimeZone getTimeZone (int defaultZoneoffset)

返回 java.util.TimeZone 。

如果为此实例定义时区字段，则返回使用zoneoffset的自定义时区ID初始化的TimeZone。 如果时区字段未定义，请尝试传入的defaultZoneoffset。如果defaultZoneoffset为FIELD_UNDEFINED，则返回此主机的默认时区。 （与java.util.GregorianCalendar相同）。

getTimezone

int getTimezone ()

如果 FIELD_UNDEFINED此可选字段， FIELD_UNDEFINED分钟或 FIELD_UNDEFINED返回时区偏移量。

timezone field of date/time field mapping table中汇总了此值的值限制。

getXMLSchemaType

QName getXMLSchemaType ()

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

getYear

int getYear ()

返回XML Schema 1.0 dateTime数据类型字段为 year或 FIELD_UNDEFINED 。

year field of date/time field mapping table中总结了此值的值限制。

hashCode

int hashCode ()

返回与equals方法的定义一致的散列码。

isValid

boolean isValid ()

通过 getXMLSchemaType()约束验证实例。

normalize

XMLGregorianCalendar normalize ()

将此实例标准化为UTC。

2000-03-04T23：00：00 + 03：00正常化为2000-03-04T20：00：00Z

实现W3C XML Schema第2部分，第3.2.7.3（A）节。

reset

void reset ()

将此 XMLGregorianCalendar重置为其原始值。

XMLGregorianCalendar复位到当它被与创建为相同的值 newXMLGregorianCalendar() ， newXMLGregorianCalendar(String) ， newXMLGregorianCalendar(BigInteger, int, int, int, int, int, BigDecimal, int) ， newXMLGregorianCalendar(int, int, int, int, int, int, int, int) ， newXMLGregorianCalendar(GregorianCalendar) ， newXMLGregorianCalendarDate(int, int, int, int) ， newXMLGregorianCalendarTime(int, int, int, int) ， newXMLGregorianCalendarTime(int, int, int, BigDecimal, int)或 newXMLGregorianCalendarTime(int, int, int, int, int) 。

reset()旨在允许重复使用现有的 XMLGregorianCalendar从而节省与创建新的 XMLGregorianCalendar相关的资源。

setDay

void setDay (int day)

按月设置日期。

通过调用参数值为 FIELD_UNDEFINED的setter来取消设置此字段。

setFractionalSecond

void setFractionalSecond (BigDecimal fractional)

设置小数秒。

通过调用参数值为 null的setter来取消设置此字段。

setHour

void setHour (int hour)

设置小时。

通过调用参数值为 FIELD_UNDEFINED的setter来取消设置此字段。

setMillisecond

void setMillisecond (int millisecond)

设置毫秒。

通过调用参数值为 FIELD_UNDEFINED的setter来取消设置此字段。

setMinute

void setMinute (int minute)

设置分钟。

通过调用带有参数值 FIELD_UNDEFINED的setter来取消设置此字段。

setMonth

void setMonth (int month)

设置月份。

通过调用参数值为 FIELD_UNDEFINED的setter来取消设置此字段。

setSecond

void setSecond (int second)

设置秒。

通过调用参数值为 FIELD_UNDEFINED的setter来取消设置此字段。

setTime

void setTime (int hour, 
                int minute, 
                int second, 
                BigDecimal fractional)

将时间设置为一个单位，包括可选的无限精度小数秒。

setTime

void setTime (int hour, 
                int minute, 
                int second)

将时间设置为一个单位。

setTime

void setTime (int hour, 
                int minute, 
                int second, 
                int millisecond)

将时间设置为一个单位，包括可选的毫秒。

setTimezone

void setTimezone (int offset)

设置时区偏移中的分钟数。

通过调用参数值为 FIELD_UNDEFINED的setter来取消设置此字段。

setYear

void setYear (BigInteger year)

设置XSD dateTime年份字段的低位和高位组件。

通过调用参数值为 null的setter来取消设置此字段。

setYear

void setYear (int year)

设置XSD dateTime年份字段的年份。

通过调用带有参数值 FIELD_UNDEFINED的setter来取消设置此字段。

注意：如果 year参数的绝对值小于10 ^ 9，则通过此方法将XSD年份字段的eon组件设置为 null 。

toGregorianCalendar

GregorianCalendar toGregorianCalendar ()

将此 XMLGregorianCalendar转换为 GregorianCalendar 。

当this实例具有未定义的字段时，此转换依赖于其相应字段的默认值java.util.GregorianCalendar 。 XML Schema 1. java.util.GregorianCalendar期/时间数据类型和java.util.GregorianCalendar之间的显着区别在于时区值对于日期/时间数据类型是可选的，并且它是java.util.GregorianCalendar的必填字段。 有关如何确定默认值，请参阅javadoc获取java.util.TimeZone.getDefault() 。 要明确指定TimeZone实例，请参阅toGregorianCalendar(TimeZone, Locale, XMLGregorianCalendar) 。

为确保转换实现的一致性，应该按照以下方式实例化新的 GregorianCalendar 。

• Using timeZone value as defined above, create a new java.util.GregorianCalendar(timeZone,Locale.getDefault()).
• Initialize all GregorianCalendar fields by calling {(@link GegorianCalendar#clear()}.
• Obtain a pure Gregorian Calendar by invoking GregorianCalendar.setGregorianChange( new Date(Long.MIN_VALUE)).
• Its fields ERA, YEAR, MONTH, DAY_OF_MONTH, HOUR_OF_DAY, MINUTE, SECOND and MILLISECOND are set using the method Calendar.set(int,int)

toGregorianCalendar

GregorianCalendar toGregorianCalendar (TimeZone timezone, 
                Locale aLocale, 
                XMLGregorianCalendar defaults)

将此 XMLGregorianCalendar与提供的参数一起转换为 GregorianCalendar实例。

由于XML Schema 1.0 date / time datetypes没有时区id或夏时制时区id的概念，因此此转换操作允许用户明确指定一个带 timezone参数的参数。

要计算返回值的 TimeZone字段，

• when parameter timeZone is non-null, it is the timezone field.
• else when this.getTimezone() != FIELD_UNDEFINED, create a java.util.TimeZone with a custom timezone id using the this.getTimezone().
• else when defaults.getTimezone() != FIELD_UNDEFINED, create a java.util.TimeZone with a custom timezone id using defaults.getTimezone().
• else use the GregorianCalendar default timezone value for the host is defined as specified by java.util.TimeZone.getDefault().

为确保转换实现的一致性，应该按照以下方式实例化新的 GregorianCalendar 。

• Create a new java.util.GregorianCalendar(TimeZone, Locale) with TimeZone set as specified above and the Locale parameter.
• Initialize all GregorianCalendar fields by calling clear()
• Obtain a pure Gregorian Calendar by invoking GregorianCalendar.setGregorianChange( new Date(Long.MIN_VALUE)).
• Its fields ERA, YEAR, MONTH, DAY_OF_MONTH, HOUR_OF_DAY, MINUTE, SECOND and MILLISECOND are set using the method Calendar.set(int,int)

toString

String toString ()

返回此 XMLGregorianCalendar Object的 String表示 Object 。

结果是由 toXMLFormat()生成的词汇表示。

toXMLFormat

String toXMLFormat ()

返回this实例的词汇表示。 格式在XML Schema 1.0 Part 2, Section 3.2.[7-14].1, Lexical Representation".中指定

Specific target lexical representation format is determined by getXMLSchemaType().