DatatypeFactory (Java Platform SE 8 )

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

```
public abstract class DatatypeFactory
extends Object
```
工厂，创造了新的javax.xml.datatype Objects映射XML与java Objects。

该DatatypeFactory新实例通过使用下面的实现机制来确定实施的newInstance()方法创建：
1. 如果指定DATATYPEFACTORY_PROPERTY系统属性，“javax.xml.datatype.DatatypeFactory”存在，随着物业价值的名称一类被实例化。抛出的任何异常的实例化过程中作为一个DatatypeConfigurationException包裹。
2. 如果文件$ { java_home } / lib / jaxp.properties存在，它是装在一个Properties Object。的Properties Object 然后查询的性能在前一步的记录，在前处理步骤记录。
3. 使用服务提供商的装卸设施，由ServiceLoader类定义，试图定位和加载使用default loading mechanism服务的实现：服务提供者装载设备将使用current thread's context class loader尝试加载服务。如果上下文类加载器是空的，将使用的system class loader。在一个DatatypeConfigurationException service configuration error将抛出的情况下
  。
4. 最后的机制是试图实例化指定的类 DATATYPEFACTORY_IMPLEMENTATION_CLASS。抛出的任何异常的实例化过程中作为一个DatatypeConfigurationException包裹。
从以下版本开始：

一点五

Version:

修改：1.13美元美元美元，日期：2010 / 03 / 11 23:10:53美元

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`DATATYPEFACTORY_IMPLEMENTATION_CLASS` 默认实现类的名字作为JSR 206定义：java（TM）API for XML处理（JAXP）1.3。
`static String`	`DATATYPEFACTORY_PROPERTY` 默认属性名称作为JSR 206定义：java（TM）API for XML处理（JAXP）1.3。

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`DatatypeFactory()` 保护构造函数防止instaniation外包装。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract Duration`	`newDuration(boolean isPositive, BigInteger years, BigInteger months, BigInteger days, BigInteger hours, BigInteger minutes, BigDecimal seconds)` 获得一个 `Duration`指定 `Duration`作为一个新的实例是，年，月，日，小时，分钟，秒。
`Duration`	`newDuration(boolean isPositive, int years, int months, int days, int hours, int minutes, int seconds)` 获得一个 `Duration`指定 `Duration`作为一个新的实例是，年，月，日，小时，分钟，秒。
`abstract Duration`	`newDuration(long durationInMilliSeconds)` 获得一个 `Duration`指定 `Duration`为毫秒的一个新实例。
`abstract Duration`	`newDuration(String lexicalRepresentation)` 获得一个 `Duration`指定 `Duration`为字符串表示形式的一个新实例，“pnynmndtnhnmns”，在1节3.2.6.1 XML Schema定义。
`Duration`	`newDurationDayTime(boolean isPositive, BigInteger day, BigInteger hour, BigInteger minute, BigInteger second)` 创建一个 `Duration` `xdt:dayTimeDuration`型使用指定的 `day`， `hour`， `minute`和 `second`定义在 XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration。
`Duration`	`newDurationDayTime(boolean isPositive, int day, int hour, int minute, int second)` 创建一个 `Duration` `xdt:dayTimeDuration`型使用指定的 `day`， `hour`， `minute`和 `second`定义在 XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration。
`Duration`	`newDurationDayTime(long durationInMilliseconds)` 创建一个 `Duration` `xdt:dayTimeDuration`型使用指定的毫秒 XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration定义。
`Duration`	`newDurationDayTime(String lexicalRepresentation)` 通过分析其 `String`表示创建一个 `Duration` `xdt:dayTimeDuration`型，“pndtnhnmns”， XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration。
`Duration`	`newDurationYearMonth(boolean isPositive, BigInteger year, BigInteger month)` 创建一个 `Duration` `xdt:yearMonthDuration`型使用指定的 `year`和 `month`定义在 XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration。
`Duration`	`newDurationYearMonth(boolean isPositive, int year, int month)` 创建一个 `Duration` `xdt:yearMonthDuration`型使用指定的 `year`和 `month`定义在 XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration。
`Duration`	`newDurationYearMonth(long durationInMilliseconds)` 创建一个 `Duration` `xdt:yearMonthDuration`型使用指定的毫秒 XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration定义。
`Duration`	`newDurationYearMonth(String lexicalRepresentation)` 通过分析其 `String`表示创建一个 `Duration` `xdt:yearMonthDuration`型，“pnynm”， XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration。
`static DatatypeFactory`	`newInstance()` 获得一个 `DatatypeFactory`新实例。
`static DatatypeFactory`	`newInstance(String factoryClassName, ClassLoader classLoader)` 从中获得的一个新实例类的名称 `DatatypeFactory`。
`abstract XMLGregorianCalendar`	`newXMLGregorianCalendar()` 创建一个新实例 `XMLGregorianCalendar`。
`abstract XMLGregorianCalendar`	`newXMLGregorianCalendar(BigInteger year, int month, int day, int hour, int minute, int second, BigDecimal fractionalSecond, int timezone)` 构造函数允许完整的价值空间的W3C XML Schema 1推荐的XSD允许：datetime和相关的内置数据类型。
`abstract XMLGregorianCalendar`	`newXMLGregorianCalendar(GregorianCalendar cal)` 创建一个从 `GregorianCalendar` `XMLGregorianCalendar`。
`XMLGregorianCalendar`	`newXMLGregorianCalendar(int year, int month, int day, int hour, int minute, int second, int millisecond, int timezone)` 价值空间， `java.util.GregorianCalendar`实例需要转换到一个 `XMLGregorianCalendar`实例构造函数。
`abstract XMLGregorianCalendar`	`newXMLGregorianCalendar(String lexicalRepresentation)` 通过解析字符串作为一个词汇表示创建一个新的xmlgregoriancalendar。
`XMLGregorianCalendar`	`newXMLGregorianCalendarDate(int year, int month, int day, int timezone)` 创建XML Schema的内置数据类型 `date`或 `g*` java表示。
`XMLGregorianCalendar`	`newXMLGregorianCalendarTime(int hours, int minutes, int seconds, BigDecimal fractionalSecond, int timezone)` 创建一个java XML Schema内置数据类型实例。
`XMLGregorianCalendar`	`newXMLGregorianCalendarTime(int hours, int minutes, int seconds, int timezone)` 创建一个java XML Schema的内置数据类型 `time`实例。
`XMLGregorianCalendar`	`newXMLGregorianCalendarTime(int hours, int minutes, int seconds, int milliseconds, int timezone)` 创建一个java XML Schema内置数据类型实例。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail
- DATATYPEFACTORY_PROPERTY
```
public static final String DATATYPEFACTORY_PROPERTY
```
  默认属性名称作为JSR 206定义：java（TM）API for XML处理（JAXP）1.3。
  
  默认值是javax.xml.datatype.DatatypeFactory。
  
  另请参见：
  
  Constant Field Values
- DATATYPEFACTORY_IMPLEMENTATION_CLASS
```
public static final String DATATYPEFACTORY_IMPLEMENTATION_CLASS
```
  默认实现类的名字作为JSR 206定义：java（TM）API for XML处理（JAXP）1.3。
  
  实施者应指定要实例化，如果没有其他解决机制成功实施一个适当的类的名称。
  
  用户不应该引用这一字段；它只打算记录一个工厂实现细节。

Constructor Detail
- DatatypeFactory
```
protected DatatypeFactory()
```
  保护构造函数防止instaniation外包装。
  
  使用newInstance()创造DatatypeFactory。

方法详细信息

newInstance
```
public static DatatypeFactory newInstance()
                                   throws DatatypeConfigurationException
```
获得一个DatatypeFactory新实例。

解决机制的实现是本类的defined文档。

结果

一个 DatatypeFactory新实例

异常

DatatypeConfigurationException如果实施不可用或不能被实例化。

另请参见：

newInstance(String factoryClassName, ClassLoader classLoader)

newInstance
```
public static DatatypeFactory newInstance(String factoryClassName,
                                          ClassLoader classLoader)
                                   throws DatatypeConfigurationException
```
从中获得的一个新实例类的名称DatatypeFactory。此功能是有用的当有多个供应商在类路径。它给应用程序提供了更多的控制，因为它可以指定要加载哪个提供程序。

一旦申请获得参考一DatatypeFactory可以使用工厂配置和获取的数据类型的实例。

解决问题的技巧

设置jaxp.debug系统属性将导致这种方法印制大量的调试消息System.err关于它是什么做的，是在看。

如果你有问题的话：
```
java djaxp。调试= 1你的…
```
参数

factoryClassName完全合格的工厂类的名称，提供了实现 javax.xml.datatype.DatatypeFactory。

classLoader用于负荷工厂类 ClassLoader。如果 null电流 Thread上下文类加载器来加载工厂类。

结果

一个 DatatypeFactory新实例

异常

DatatypeConfigurationException -如果 factoryClassName是 null，或工厂类不能被加载，实例化。

从以下版本开始：

一点六

另请参见：

newInstance()

newDuration
```
public abstract Duration newDuration(String lexicalRepresentation)
```
获得一个Duration指定Duration为字符串表示形式的一个新实例，“pnynmndtnhnmns”，在1节3.2.6.1 XML Schema定义。

XML架构2部分：Datatypes，duration 3.2.6时间，定义为：

duration represents a duration of time. The value space of duration is a six-dimensional space where the coordinates designate the Gregorian year, month, day, hour, minute, and second components defined in Section 5.5.3.2 of [ISO 8601], respectively. These components are ordered in their significance by their order of appearance i.e. as year, month, day, hour, minute, and second.

所有六个值设置，可从创建Duration

XML架构规范说明，值可以是任意大小的。实现可能选择不支持或不能支持任意大的和/或小的值。一个UnsupportedOperationException将抛出消息表明实现的限制，如果超过了执行能力。

参数

lexicalRepresentation -一个 Duration String表示。

结果

从分析 lexicalRepresentation创造了新的 Duration。

异常

IllegalArgumentException -如果 lexicalRepresentation不是一个 Duration合法表示。

UnsupportedOperationException如果实施不支持请求的值。

如果是 null lexicalRepresentation NullPointerException。

newDuration
```
public abstract Duration newDuration(long durationInMilliSeconds)
```
获得一个Duration指定Duration为毫秒的一个新实例。

XML架构2部分：Datatypes，duration 3.2.6时间，定义为：

duration represents a duration of time. The value space of duration is a six-dimensional space where the coordinates designate the Gregorian year, month, day, hour, minute, and second components defined in Section 5.5.3.2 of [ISO 8601], respectively. These components are ordered in their significance by their order of appearance i.e. as year, month, day, hour, minute, and second.

所有六个值是由计算值指定的毫秒和可利用的Duration get创建的方法。值符合和定义的：
- ISO 8601:2000（E）部分5.5.3.2替代格式
- W3C XML Schema 1.0 Part 2, Appendix D, ISO 8601 Date and Time Formats
- XMLGregorianCalendar日期/时间的XML模式1和java数据类型字段表示之间的映射
默认启动的实例是由GregorianCalendar使用时代的开始定义：即Calendar.YEAR = 1970，Calendar.MONTH = Calendar.JANUARY，Calendar.DATE = 1，等。这是重要的有在公历闰年的变化，如在月= Calendar.FEBRUARY不同天，Duration.getMonths()和Duration.getDays()结果可影响。
参数

创建 durationInMilliSeconds -持续时间。

结果

新的 Duration代表 durationInMilliSeconds。

newDuration
```
public abstract Duration newDuration(boolean isPositive,
                                     BigInteger years,
                                     BigInteger months,
                                     BigInteger days,
                                     BigInteger hours,
                                     BigInteger minutes,
                                     BigDecimal seconds)
```
获得一个Duration指定Duration作为一个新的实例是，年，月，日，小时，分钟，秒。

XML架构规范说明，值可以是任意大小的。实现可能选择不支持或不能支持任意大的和/或小的值。一个UnsupportedOperationException将抛出消息表明实现的限制，如果超过了执行能力。

一个null值表示没有设置字段。

参数

isPositive集 false创造一个负面的持续时间。当持续时间为零的长度时，这个参数将被忽略。

这 Duration years -

这 Duration months -

这 Duration days -

这 Duration hours -

这 Duration minutes -

这 Duration seconds -

结果

从指定的值创建新的 Duration。

异常

IllegalArgumentException -如果值不是一个 Duration有效表示：如果所有的字段（年，月，…）如果任何字段是空的或是消极的。

UnsupportedOperationException如果实施不支持请求的值。

newDuration
```
public Duration newDuration(boolean isPositive,
                            int years,
                            int months,
                            int days,
                            int hours,
                            int minutes,
                            int seconds)
```
获得一个Duration指定Duration作为一个新的实例是，年，月，日，小时，分钟，秒。

一个DatatypeConstants.FIELD_UNDEFINED值表示没有设置字段。

参数

isPositive集 false创造一个负面的持续时间。当持续时间为零的长度时，这个参数将被忽略。

这 Duration years -

这 Duration months -

这 Duration days -

hours -这 Duration

这 Duration minutes -

这 Duration seconds -

结果

从指定的值创建新的 Duration。

异常

IllegalArgumentException -如果值不是一个 Duration有效表示：如果任何字段是负的。

另请参见：

newDuration( boolean isPositive, BigInteger years, BigInteger months, BigInteger days, BigInteger hours, BigInteger minutes, BigDecimal seconds)

newDurationDayTime
```
public Duration newDurationDayTime(String lexicalRepresentation)
```
通过分析其String表示创建一个Duration xdt:dayTimeDuration型，“pndtnhnmns”， XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration。

数据类型xdt:dayTimeDuration是一类xs:duration的词汇表示只包含一天，小时，分钟，和第二组件。这一数据驻留在命名空间http://www.w3.org/2003/11/xpath-datatypes。

所有四个值设置，可从创建Duration

XML架构规范说明，值可以是任意大小的。实现可能选择不支持或不能支持任意大的和/或小的值。一个UnsupportedOperationException将抛出消息表明实现的限制，如果超过了执行能力。

参数

lexicalRepresentation -一个时间词汇表征。

结果

使用指定的 lexicalRepresentation创造了新的 Duration。

异常

IllegalArgumentException -如果 lexicalRepresentation不仅在天和时间表示一个 Duration合法表示。

UnsupportedOperationException如果实施不支持请求的值。

如果是 null lexicalRepresentation NullPointerException。

newDurationDayTime
```
public Duration newDurationDayTime(long durationInMilliseconds)
```
创建一个Duration xdt:dayTimeDuration型使用指定的毫秒 XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration定义。

数据类型xdt:dayTimeDuration是xs:duration的词汇表示只包含天、小时、分钟和第二组件的一个亚型。这一数据驻留在命名空间http://www.w3.org/2003/11/xpath-datatypes。

所有四个值是由计算值指定的毫秒和可利用的Duration get创建的方法，符合定义的值：
- ISO 8601:2000（E）部分5.5.3.2替代格式
- W3C XML Schema 1.0 Part 2, Appendix D, ISO 8601 Date and Time Formats
- XMLGregorianCalendar日期/时间的XML模式1和java数据类型字段表示之间的映射
默认启动的实例是由GregorianCalendar使用时代的开始定义：即Calendar.YEAR = 1970，Calendar.MONTH = Calendar.JANUARY，Calendar.DATE = 1，等。这是重要的有在公历闰年的变化，如在月= Calendar.FEBRUARY不同天，Duration.getDays()结果可以影响。

确定后的一天，一小时，一分钟和第二个小时后，剩余的毫秒数将被丢弃。
参数

durationInMilliseconds -毫秒的 Duration创造。

结果

用指定的 durationInMilliseconds创造了新的 Duration。

另请参见：

XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration

newDurationDayTime
```
public Duration newDurationDayTime(boolean isPositive,
                                   BigInteger day,
                                   BigInteger hour,
                                   BigInteger minute,
                                   BigInteger second)
```
创建一个Duration xdt:dayTimeDuration型使用指定的day，hour，minute和second定义在 XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration。

数据类型xdt:dayTimeDuration是一类xs:duration的词汇表示只包含一天，小时，分钟，和第二组件。这一数据驻留在命名空间http://www.w3.org/2003/11/xpath-datatypes。

XML架构规范说明，值可以是任意大小的。实现可能选择不支持或不能支持任意大的和/或小的值。一个UnsupportedOperationException将抛出消息表明实现的限制，如果超过了执行能力。

一个null值表示没有设置字段。

参数

isPositive集 false创造一个负面的持续时间。当持续时间为零的长度时，这个参数将被忽略。

day天 Duration。

对 Duration hour小时。

minute分钟 Duration。

second -二 Duration。

结果

用指定的 day， hour创造了新的 Duration， minute和 second。

异常

IllegalArgumentException -如果值不是一个 Duration有效表示：如果所有的字段（天、小时，…）如果任何字段是空的或是消极的。

UnsupportedOperationException如果实施不支持请求的值。

newDurationDayTime
```
public Duration newDurationDayTime(boolean isPositive,
                                   int day,
                                   int hour,
                                   int minute,
                                   int second)
```
创建一个Duration xdt:dayTimeDuration型使用指定的day，hour，minute和second定义在 XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration。

数据类型xdt:dayTimeDuration是xs:duration的词汇表示只包含天、小时、分钟和第二组件的一个亚型。这一数据驻留在命名空间http://www.w3.org/2003/11/xpath-datatypes。

一个DatatypeConstants.FIELD_UNDEFINED值表示没有设置字段。

参数

isPositive集 false创造一个负面的持续时间。当持续时间为零的长度时，这个参数将被忽略。

day天 Duration。

hour小时 Duration。

minute分钟 Duration。

second -二 Duration。

结果

用指定的 day， hour创造了新的 Duration， minute和 second。

异常

IllegalArgumentException -如果值不是一个 Duration有效表示：如果任何字段（天、小时，…）是负的。

newDurationYearMonth
```
public Duration newDurationYearMonth(String lexicalRepresentation)
```
通过分析其String表示创建一个Duration xdt:yearMonthDuration型，“pnynm”， XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration。

数据类型xdt:yearMonthDuration是一类xs:duration的词汇表示只包含年、月组成。这一数据驻留在命名空间XMLConstants.W3C_XPATH_DATATYPE_NS_URI。

两值设置，可从创建Duration

XML架构规范说明，值可以是任意大小的。实现可能选择不支持或不能支持任意大的和/或小的值。一个UnsupportedOperationException将抛出消息表明实现的限制，如果超过了执行能力。

参数

lexicalRepresentation -一个时间词汇表征。

结果

使用指定的 lexicalRepresentation创建新 Duration。

异常

IllegalArgumentException -如果 lexicalRepresentation不仅是年和月来表示一个 Duration合法表示。

UnsupportedOperationException如果实施不支持请求的值。

如果是 null lexicalRepresentation NullPointerException。

newDurationYearMonth
```
public Duration newDurationYearMonth(long durationInMilliseconds)
```
创建一个Duration xdt:yearMonthDuration型使用指定的毫秒 XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration定义。

数据类型xdt:yearMonthDuration是一类xs:duration的词汇表示只包含年、月组成。这一数据驻留在命名空间XMLConstants.W3C_XPATH_DATATYPE_NS_URI。

价值观是由计算值指定的毫秒和可利用的Duration get创建的方法。值符合和定义的：
- ISO 8601:2000（E）部分5.5.3.2替代格式
- W3C XML Schema 1.0 Part 2, Appendix D, ISO 8601 Date and Time Formats
- XMLGregorianCalendar日期/时间的XML模式1和java数据类型字段表示之间的映射
默认启动的实例是由GregorianCalendar使用时代的开始定义：即Calendar.YEAR = 1970，Calendar.MONTH = Calendar.JANUARY，Calendar.DATE = 1，等。这是重要的有在公历闰年的变化，如在月= Calendar.FEBRUARY不同天，Duration.getMonths()结果可以影响。

确定一年和一个月后的任何剩余毫秒都将被丢弃。
参数

durationInMilliseconds -毫秒的 Duration创造。

结果

使用指定的 durationInMilliseconds创造了新的 Duration。

newDurationYearMonth
```
public Duration newDurationYearMonth(boolean isPositive,
                                     BigInteger year,
                                     BigInteger month)
```
创建一个Duration xdt:yearMonthDuration型使用指定的year和month定义在 XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration。

XML架构规范说明，值可以是任意大小的。实现可能选择不支持或不能支持任意大的和/或小的值。一个UnsupportedOperationException将抛出消息表明实现的限制，如果超过了执行能力。

一个null值表示没有设置字段。

参数

isPositive集 false创造一个负面的持续时间。当持续时间为零的长度时，这个参数将被忽略。

year年的 Duration。

month -月 Duration。

结果

使用指定的 year和 month创造了新的 Duration。

异常

IllegalArgumentException -如果值不是一个 Duration有效表示：如果所有字段（年、月）如果任何字段是空的或是消极的。

UnsupportedOperationException如果实施不支持请求的值。

newDurationYearMonth
```
public Duration newDurationYearMonth(boolean isPositive,
                                     int year,
                                     int month)
```
创建一个Duration xdt:yearMonthDuration型使用指定的year和month定义在 XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration。

一个DatatypeConstants.FIELD_UNDEFINED值表示没有设置字段。

参数

isPositive集 false创造一个负面的持续时间。当持续时间为零的长度时，这个参数将被忽略。

year年的 Duration。

month -月 Duration。

结果

使用指定的 year和 month创造了新的 Duration。

异常

IllegalArgumentException -如果值不是一个 Duration有效表示：如果任何字段（年、月）是负的。

newXMLGregorianCalendar
```
public abstract XMLGregorianCalendar newXMLGregorianCalendar()
```
创建一个新实例XMLGregorianCalendar。

所有的日期/时间数据类型字段设置为DatatypeConstants.FIELD_UNDEFINED或空。

结果

新的 XMLGregorianCalendar所有日期/时间数据类型字段设置为 DatatypeConstants.FIELD_UNDEFINED或空。

newXMLGregorianCalendar
```
public abstract XMLGregorianCalendar newXMLGregorianCalendar(String lexicalRepresentation)
```
通过解析字符串作为一个词汇表示创建一个新的xmlgregoriancalendar。

词法解析的字符串表示形式是指在XML Schema 1.0 Part 2, Section 3.2.[7-14].1, Lexical Representation.

的字符串表示形式可能没有任何前导和尾随空格。

分析了场的场所以以下适用于任何词汇正确的字符串x：
```
newxmlgregoriancalendar（x）。toxmlformat()等于（X）。
```
除了著名的词汇/典型表示配列在 XML Schema 1.0 errata, Section 3.2.7.2。
参数

lexicalRepresentation词汇表示一个八的XML Schema的日期/时间数据类型。

结果

XMLGregorianCalendar产生 lexicalRepresentation。

异常

IllegalArgumentException -如果 lexicalRepresentation不是有效的 XMLGregorianCalendar。

如果是 null lexicalRepresentation NullPointerException。

newXMLGregorianCalendar

public abstract XMLGregorianCalendar newXMLGregorianCalendar(GregorianCalendar cal)

创建一个从GregorianCalendar XMLGregorianCalendar。

Field by Field Conversion from `GregorianCalendar` to an `XMLGregorianCalendar`
`java.util.GregorianCalendar` field	`javax.xml.datatype.XMLGregorianCalendar` field
`ERA == GregorianCalendar.BC ? -YEAR : YEAR`	`XMLGregorianCalendar.setYear(int year)`
`MONTH + 1`	`XMLGregorianCalendar.setMonth(int month)`
`DAY_OF_MONTH`	`XMLGregorianCalendar.setDay(int day)`
`HOUR_OF_DAY, MINUTE, SECOND, MILLISECOND`	`XMLGregorianCalendar.setTime(int hour, int minute, int second, BigDecimal fractional)`
`(ZONE_OFFSET + DST_OFFSET) / (601000)` (in minutes)*	`XMLGregorianCalendar.setTimezone(int offset)`^*

*转换信息丢失。它是不可能代表一个java.util.GregorianCalendar夏时制时区ID在XML Schema 1日期/时间数据类型表示。

计算返回值的TimeZone场，

当this.getTimezone() != FIELD_UNDEFINED，创建一个使用this.getTimezone()自定义时区ID java.util.TimeZone。
其他人使用的GregorianCalendar默认时区值为主机定义为指定的java.util.TimeZone.getDefault()。

参数: cal - java.util.GregorianCalendar用于创建 XMLGregorianCalendar
结果: 创建 java.util.GregorianCalendar XMLGregorianCalendar
异常: 如果是 null cal NullPointerException。

newXMLGregorianCalendar
```
public abstract XMLGregorianCalendar newXMLGregorianCalendar(BigInteger year,
                                                             int month,
                                                             int day,
                                                             int hour,
                                                             int minute,
                                                             int second,
                                                             BigDecimal fractionalSecond,
                                                             int timezone)
```
构造函数允许完整的价值空间的W3C XML Schema 1推荐的XSD允许：datetime和相关的内置数据类型。注意，year参数支持任意大的数字和fractionalsecond无限精度。

一个null值表示没有设置字段。

参数

year - XMLGregorianCalendar被创建。

要创建的 XMLGregorianCalendar month -。

day - XMLGregorianCalendar被创建。

hour - XMLGregorianCalendar被创建。

minute - XMLGregorianCalendar被创建。

second - XMLGregorianCalendar被创建。

fractionalSecond - XMLGregorianCalendar被创建。

timezone - XMLGregorianCalendar被创建。

结果

XMLGregorianCalendar创建指定的值。

异常

IllegalArgumentException -如果任何一个参数的值在最大值约束的字段的日期/时间在 XMLGregorianCalendar或者复合价值观构成了一个无效的 XMLGregorianCalendar实例所确定的 XMLGregorianCalendar.isValid()数据映射表确定。

newXMLGregorianCalendar
```
public XMLGregorianCalendar newXMLGregorianCalendar(int year,
                                                    int month,
                                                    int day,
                                                    int hour,
                                                    int minute,
                                                    int second,
                                                    int millisecond,
                                                    int timezone)
```
价值空间，java.util.GregorianCalendar实例需要转换到一个XMLGregorianCalendar实例构造函数。

XMLGregorianCalendar eon和fractionalSecond将null

一个DatatypeConstants.FIELD_UNDEFINED值表示没有设置字段。

参数

year - XMLGregorianCalendar被创建。

month - XMLGregorianCalendar被创建。

day - XMLGregorianCalendar被创建。

hour - XMLGregorianCalendar被创建。

minute - XMLGregorianCalendar被创建。

second - XMLGregorianCalendar被创建。

millisecond - XMLGregorianCalendar被创建。

timezone - XMLGregorianCalendar被创建。

结果

XMLGregorianCalendar创建指定的值。

异常

IllegalArgumentException -如果任何一个参数的值在最大值约束的字段的日期/时间在 XMLGregorianCalendar或者复合价值观构成了一个无效的 XMLGregorianCalendar实例所确定的 XMLGregorianCalendar.isValid()数据映射表确定。

newXMLGregorianCalendarDate
```
public XMLGregorianCalendar newXMLGregorianCalendarDate(int year,
                                                        int month,
                                                        int day,
                                                        int timezone)
```
创建XML Schema的内置数据类型date或g* java表示。

例如，对gYear实例可以创建调用该厂month和day参数设置为DatatypeConstants.FIELD_UNDEFINED。

一个DatatypeConstants.FIELD_UNDEFINED值表示没有设置字段。

参数

year - XMLGregorianCalendar被创建。

month - XMLGregorianCalendar被创建。

day - XMLGregorianCalendar被创建。

timezone抵消分钟。 DatatypeConstants.FIELD_UNDEFINED表示不设置可选字段。

结果

XMLGregorianCalendar创建参数值。

异常

IllegalArgumentException -如果任何一个参数的值在最大值约束的字段的日期/时间在 XMLGregorianCalendar或者复合价值观构成了一个无效的 XMLGregorianCalendar实例所确定的 XMLGregorianCalendar.isValid()数据映射表确定。

另请参见：

DatatypeConstants.FIELD_UNDEFINED

newXMLGregorianCalendarTime
```
public XMLGregorianCalendar newXMLGregorianCalendarTime(int hours,
                                                        int minutes,
                                                        int seconds,
                                                        int timezone)
```
创建一个java XML Schema的内置数据类型time实例。

一个DatatypeConstants.FIELD_UNDEFINED值表示没有设置字段。

参数

hours数小时

minutes数分钟

seconds数秒

timezone抵消分钟。 DatatypeConstants.FIELD_UNDEFINED表示不设置可选字段。

结果

XMLGregorianCalendar创建参数值。

异常

IllegalArgumentException -如果任何一个参数的值在最大值约束的字段的日期/时间在 XMLGregorianCalendar或者复合价值观构成了一个无效的 XMLGregorianCalendar实例所确定的 XMLGregorianCalendar.isValid()数据映射表确定。

另请参见：

DatatypeConstants.FIELD_UNDEFINED

newXMLGregorianCalendarTime
```
public XMLGregorianCalendar newXMLGregorianCalendarTime(int hours,
                                                        int minutes,
                                                        int seconds,
                                                        BigDecimal fractionalSecond,
                                                        int timezone)
```
创建一个java XML Schema内置数据类型实例。

一个null值表示没有设置字段。

一个DatatypeConstants.FIELD_UNDEFINED值表示没有设置字段。

参数

hours数小时

minutes数分钟

seconds数秒

fractionalSecond值 null表明未设置此可选字段。

timezone抵消分钟。 DatatypeConstants.FIELD_UNDEFINED表示不设置可选字段。

结果

XMLGregorianCalendar创建参数值。

异常

IllegalArgumentException -如果任何一个参数的值在最大值约束的字段的日期/时间在 XMLGregorianCalendar或者复合价值观构成了一个无效的 XMLGregorianCalendar实例所确定的 XMLGregorianCalendar.isValid()数据映射表确定。

另请参见：

DatatypeConstants.FIELD_UNDEFINED

newXMLGregorianCalendarTime
```
public XMLGregorianCalendar newXMLGregorianCalendarTime(int hours,
                                                        int minutes,
                                                        int seconds,
                                                        int milliseconds,
                                                        int timezone)
```
创建一个java XML Schema内置数据类型实例。

一个DatatypeConstants.FIELD_UNDEFINED值表示没有设置字段。

参数

hours数小时

minutes数分钟

seconds数秒

milliseconds数毫秒

抵消分 timezone -。 DatatypeConstants.FIELD_UNDEFINED表示不设置可选字段。

结果

XMLGregorianCalendar创建参数值。

异常

IllegalArgumentException -如果任何一个参数的值在最大值约束的字段的日期/时间在 XMLGregorianCalendar或者复合价值观构成了一个无效的 XMLGregorianCalendar实例所确定的 XMLGregorianCalendar.isValid()数据映射表确定。

另请参见：

DatatypeConstants.FIELD_UNDEFINED

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 DatatypeFactory

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

DATATYPEFACTORY_PROPERTY

DATATYPEFACTORY_IMPLEMENTATION_CLASS

Constructor Detail

DatatypeFactory

方法详细信息

newInstance

newInstance

解决问题的技巧

newDuration

newDuration

newDuration

newDuration

newDurationDayTime

newDurationDayTime

newDurationDayTime

newDurationDayTime

newDurationYearMonth

newDurationYearMonth

newDurationYearMonth

newDurationYearMonth

newXMLGregorianCalendar

newXMLGregorianCalendar

newXMLGregorianCalendar

newXMLGregorianCalendar

newXMLGregorianCalendar

newXMLGregorianCalendarDate

newXMLGregorianCalendarTime

newXMLGregorianCalendarTime

newXMLGregorianCalendarTime