Java javax.xml.datatype 类 XMLGregorianCalendar（JDK5）

208 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.xml.datatype
类 XMLGregorianCalendar

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

所有已实现的接口：: Cloneable

public abstract class XMLGregorianCalendar
extends Object

implements Cloneable
extends Object
implements Cloneable

W3C XML Schema 1.0 日期/时间数据类型的表示形式。明确地说，这些日期/时间数据类型是 XML 名称空间 "http://www.w3.org/2001/XMLSchema" 中定义的 dateTime、time、date、gYearMonth、gMonthDay、gYeargMonth 和 gDay。在 W3C XML Schema 1.0 第二部分 3.2.7-14 小节中以标准形式定义了这些数据类型。

下表定义了 XML Schema 1.0 日期/时间数据类型字段和此类的字段之间的映射关系。还总结了 W3C XML Schema 1.0 第二部分的附录 D ISO 8601 Date and Time Formats 中定义的日期和时间字段的值约束。

XML Schema 1.0 和 Java 表示形式之间的日期/时间数据类型字段映射关系
XML Schema 1.0 数据类型字段	相关的 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 Schema 1.0 勘误表说明 year 零是 XML Schema 以后版本中的一个有效词汇值，那么此类允许将 year 字段设置为零。否则，完全按照勘误表和 [ISO-8601-1988] 中的描述处理 year 字段值。注意，W3C XML Schema 1.0 验证不允许 year 字段具有零值。
month	`getMonth()`	1 到 12 或 `DatatypeConstants.FIELD_UNDEFINED`
day	`getDay()`	与 month 无关，最大范围是 1 到 31 或 `DatatypeConstants.FIELD_UNDEFINED`。相对于 month 字段的值说明的标准化值约束位于 W3C XML Schema 1.0 第二部分附录 D 中。
hour	`getHour()`	0 到 24 或 `DatatypeConstants.FIELD_UNDEFINED`。对于值 24，根据 XML Schema 勘误表，minute 和 second 字段必须为零。
minute	`getMinute()`	0 到 59 或 `DatatypeConstants.FIELD_UNDEFINED`
second	`getSecond()` + `getMillisecond()`/1000 或 `getSecond()` + `getFractionalSecond()`	`getSecond()` 范围是 0 到 60 或 `DatatypeConstants.FIELD_UNDEFINED`。（注：60 仅允许闰秒。）在定义 `getSecond()` 时，`getFractionalSecond()` 在范围 0.0 到 1.0 上允许无限精度。 `FractionalSecond` 是可选的，并且当它未定义时，值为 `null`。 `getMillisecond()` 是值 `getFractionalSecond()` 的有用毫秒精度。
timezone	`getTimezone()`	分钟数或 `DatatypeConstants.FIELD_UNDEFINED`。从 -14 小时（-14 * 60 分钟）到 14 小时（14 * 60 分钟）的值范围。

通过此类的工厂方法、DatatypeFactory、设置方法和解析方法检查上面表中为字段列出的所有最大值空间约束。若参数的值超出字段的值约束，或者如果复合值组成一个无效 XMLGregorianCalendar 实例（例如，如果指定六月的第 31 日），则抛出 IllegalArgumentException。

为此类定义以下操作：

用于独立日期/时间字段的 accessors/mutators
此类与 W3C XML Schema 1.0 词汇表示形式、toString()、DatatypeFactory.newXMLGregorianCalendar(String lexicalRepresentation) 之间的转换
此类与 GregorianCalendar、toGregorianCalendar(java.util.TimeZone timezone, java.util.Locale aLocale, XMLGregorianCalendar defaults)、DatatypeFactory 之间的转换
部分顺序关系比较器方法 compare(XMLGregorianCalendar xmlGregorianCalendar)
相对于 compare(XMLGregorianCalendar xmlGregorianCalendar) 定义的 equals(Object)。
W3C XML Schema 1.0 第二部分的附录 E Adding durations to dateTimes 中定义的 Duration 实例的其他操作。

从以下版本开始：: 1.5
另请参见：: Duration, DatatypeFactory

构造方法摘要
`XMLGregorianCalendar()`

方法摘要
`abstract void`	`add(Duration duration)` 将 `duration` 添加到此实例。
`abstract void`	`clear()` 取消设置所有未定义的字段。
`abstract Object`	`clone()` 创建并返回此对象的一个副本。
`abstract int`	`compare(XMLGregorianCalendar xmlGregorianCalendar)` 根据 W3C XML Schema 1.0 第二部分 3.2.7.3 小节 Order relation on dateTime 中定义的部分顺序关系，比较 W3C XML Schema 1.0 日期/时间数据类型的两个实例。
`boolean`	`equals(Object obj)` 指示参数 `obj` 是否“等于”此参数。
`abstract int`	`getDay()` 返回月中的日或 `DatatypeConstants.FIELD_UNDEFINED`。
`abstract BigInteger`	`getEon()` 返回 XML Schema 1.0 日期时间数据类型字段的高顺序组件，用于 `year`。
`abstract BigInteger`	`getEonAndYear()` 返回 `year` XML Schema 1.0 的日期时间数据类型字段。
`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 日期时间数据类型字段的低顺序组件。
`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)` 将时间设置为一个单元。
`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` year 字段的低和高顺序组件。
`abstract void`	`setYear(int year)` 设置 XSD `dateTime` year 字段的年。
`abstract GregorianCalendar`	`toGregorianCalendar()` 将此 `XMLGregorianCalendar` 转换为 `GregorianCalendar`。
`abstract GregorianCalendar`	`toGregorianCalendar(TimeZone timezone, Locale aLocale, XMLGregorianCalendar defaults)` 将此 `XMLGregorianCalendar` 以及提供的参数转换为 `GregorianCalendar` 实例。
`String`	`toString()` 返回此 `XMLGregorianCalendarObject` 的 `String` 表示形式。
`abstract String`	`toXMLFormat()` 返回 `this` 实例的词汇表示形式。

从类 java.lang.Object 继承的方法
`finalize, getClass, notify, notifyAll, wait, wait, wait`

构造方法详细信息

XMLGregorianCalendar

public XMLGregorianCalendar()

方法详细信息

clear

public abstract void clear()

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

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

reset

public abstract void reset()

将此 XMLGregorianCalendar 重设为其原始值。

reset() 的设计目的是允许重用现有的 XMLGregorianCalendar，从而节省与创建新 XMLGregorianCalendar 相关的资源。

setYear

public abstract void setYear(BigInteger year)

设置 XSD dateTime year 字段的低和高顺序组件。

通过使用参数值 null 调用设置方法取消设置此字段。

参数：: year - 日期/时间字段映射表中 year 字段中总结的值约束。
抛出：: IllegalArgumentException - 如果 year 参数超出日期/时间映射表中指定字段的值约束。

setYear

public abstract void setYear(int year)

设置 XSD dateTime year 字段的年。

通过使用 DatatypeConstants.FIELD_UNDEFINED 的参数值调用设置方法取消设置此字段。

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

参数：: year - 日期/时间字段映射表中 year 字段中总结的值约束。如果年是 DatatypeConstants.FIELD_UNDEFINED，那么将 eon 设置为 null。

setMonth

public abstract void setMonth(int month)

设置月。

通过使用 DatatypeConstants.FIELD_UNDEFINED 的参数值调用设置方法取消设置此字段。

参数：: month - 日期/时间映射表的 month 字段中总结的值约束。
抛出：: IllegalArgumentException - 如果 month 参数超出日期/时间映射表中指定字段的值约束。

setDay

public abstract void setDay(int day)

设置月中的日。

通过使用 DatatypeConstants.FIELD_UNDEFINED 的参数值调用设置方法取消设置此字段。

参数：: day - 日期/时间字段映射表的 day 字段中总结的值约束。
抛出：: IllegalArgumentException - 如果 day 参数超出日期/时间映射表中指定字段的值约束。

setTimezone

public abstract void setTimezone(int offset)

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

通过使用 DatatypeConstants.FIELD_UNDEFINED 的参数值调用设置方法取消设置此字段。

参数：: offset - 日期/时间字段映射表的 timezone 字段中总结的值约束。
抛出：: IllegalArgumentException - 如果 offset 参数超出日期/时间映射表中指定字段的值约束。

本文分类：JavaAPI
本文标签：JavaAPI JDK5 Java5
浏览次数：208 次浏览
本文链接：/javaapi/9405.html