所有类


javax.xml.datatype
类 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" 中定义的 dateTimetimedategYearMonthgMonthDaygYear gMonthgDay。在 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

为此类定义以下操作:

从以下版本开始:
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()
          返回 yearDatatypeConstants.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()
          返回此 XMLGregorianCalendar ObjectString 表示形式。
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 重设为其原始值。

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() 的设计目的是允许重用现有的 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 参数超出日期/时间映射表中指定字段的值约束。

微信小程序

微信扫一扫体验

微信公众账号

微信扫一扫加关注

发表
评论
返回
顶部