DatatypeFactory (Java Platform SE 8 )

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

```
public abstract class DatatypeFactory
extends Object
```
创建新的javax.xml.datatype Object的工厂，将Java映射到Java Object s。

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尝试加载服务。如果上下文类加载器为null，那么将使用system class loader 。
  在service configuration error的情况下，将会抛出一个DatatypeConfigurationException 。
4. 最终的机制是尝试实例化由类指定的类。在实例化过程中抛出的任何异常被包装为DatatypeConfigurationException 。
从以下版本开始：

1.5

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中定义的默认实现类名称：用于XML处理的Java（TM）API（JAXP）1.3 。
`static String`	`DATATYPEFACTORY_PROPERTY` JSR 206中定义的默认属性名称：用于XML处理的Java（TM）API（JAXP）1.3。

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`DatatypeFactory()` 受保护的构造函数，以防止包装外部的启动。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
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`为isPositive，年，月，日，小时，分钟，秒。
`Duration`	`newDuration(boolean isPositive, int years, int months, int days, int hours, int minutes, int seconds)` 获取一个 `Duration`的新实例，指定 `Duration`为isPositive，年，月，日，小时，分钟，秒。
`abstract Duration`	`newDuration(long durationInMilliSeconds)` 获取一个 `Duration`的新实例，指定 `Duration`为毫秒。
`abstract Duration`	`newDuration(String lexicalRepresentation)` 获取一个 `Duration`的新实例，指定 `Duration`作为其字符串表示形式“PnYnMnDTnHnMnS”，如XML Schema 1.0第3.2.6.1节中所定义。
`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)` 创建 `Duration`型 `xdt:dayTimeDuration`通过分析其 `String`表示，“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)` 创建 `Duration`型 `xdt:yearMonthDuration`通过分析其 `String`表示，“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.0允许的完整值空间的构造方法，用于xsd：dateTime和相关的内置数据类型。
`abstract XMLGregorianCalendar`	`newXMLGregorianCalendar(GregorianCalendar cal)` 创建一个`XMLGregorianCalendar`从`GregorianCalendar` 。
`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)` 通过解析String作为词法表示来创建一个新的XMLGregorianCalendar。
`XMLGregorianCalendar`	`newXMLGregorianCalendarDate(int year, int month, int day, int timezone)` 创建XML Schema内置数据类型 `date`或 `g`的Java表示 `g` 。
`XMLGregorianCalendar`	`newXMLGregorianCalendarTime(int hours, int minutes, int seconds, BigDecimal fractionalSecond, int timezone)` 创建XML Schema内置数据类型时间的Java实例。
`XMLGregorianCalendar`	`newXMLGregorianCalendarTime(int hours, int minutes, int seconds, int timezone)` 创建XML Schema内置数据类型 `time`的Java实例。
`XMLGregorianCalendar`	`newXMLGregorianCalendarTime(int hours, int minutes, int seconds, int milliseconds, int timezone)` 创建XML Schema内置数据类型时间的Java实例。

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

- 字段详细信息
  - DATATYPEFACTORY_PROPERTY
```
public static final String DATATYPEFACTORY_PROPERTY
```
    JSR 206中定义的默认属性名称：用于XML处理的Java（TM）API（JAXP）1.3。
    
    默认值为javax.xml.datatype.DatatypeFactory 。
    
    另请参见：
    
    Constant Field Values
  - DATATYPEFACTORY_IMPLEMENTATION_CLASS
```
public static final String DATATYPEFACTORY_IMPLEMENTATION_CLASS
```
    JSR 206中定义的默认实现类名称：用于XML处理的Java（TM）API（JAXP）1.3 。
    
    如果没有其他实现解析机制成功，实施者应指定要实例化的适当类的名称。
    
    用户不应该参考这个字段; 仅用于记录工厂实施细节。
- 构造方法详细信息
  - DatatypeFactory
```
protected DatatypeFactory()
```
    受保护的构造函数，以防止包装外部的启动。
    
    使用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的DatatypeFactory就可以使用工厂来配置和获取数据类型实例。
    
    提示进行故障排除
    
    设置jaxp.debug系统属性将导致此方法打印大量调试消息到System.err有关它在做什么以及在哪里查看。
    
    如果您有问题，请尝试：
```
  java -Djaxp.debug=1 YourProgram .... 
```
    参数
    
    factoryClassName -完全限定工厂类名称，提供实施 javax.xml.datatype.DatatypeFactory 。
    
    classLoader - ClassLoader用于加载工厂类。如果null当前的Thread的上下文classLoader用于加载工厂类。
    
    结果
    
    新实例的一个 DatatypeFactory
    
    异常
    
    DatatypeConfigurationException - 如果 factoryClassName是 null ，或工厂类无法加载，实例化。
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    newInstance()
  - newDuration
```
public abstract Duration newDuration(String lexicalRepresentation)
```
    获取一个Duration的新实例，指定Duration作为其字符串表示形式“PnYnMnDTnHnMnS”，如XML Schema 1.0第3.2.6.1节中所定义。
    
    XML Schema第2部分：数据类型，3.2.6 duration，定义duration为：
    
    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 Schema规范声明值可以是任意大小。实施可能选择不支持或不能支持任意大和/或小的价值观。 UnsupportedOperationException将抛出一条消息，指示如果超出实施容量，则执行限制。
    
    参数
    
    lexicalRepresentation - String Duration的 Duration 。
    
    结果
    
    新的 Duration创建从解析 lexicalRepresentation 。
    
    异常
    
    IllegalArgumentException - 如果 lexicalRepresentation不是Duration的有效 Duration 。
    
    UnsupportedOperationException - 如果实现不能支持请求的值。
    
    NullPointerException - 如果 lexicalRepresentation是 null 。
  - newDuration
```
public abstract Duration newDuration(long durationInMilliSeconds)
```
    获取一个Duration的新实例，指定Duration为毫秒。
    
    XML Schema第2部分：数据类型，3.2.6 duration，定义duration为：
    
    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 Schema 1.0和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为isPositive，年，月，日，小时，分钟，秒。
    
    XML Schema规范声明值可以是任意大小。实施可能选择不支持或不能支持任意大和/或小的价值观。如果超出实施容量，那么UnsupportedOperationException将被抛出一条消息，指示实现限制。
    
    null值表示该字段未设置。
    
    参数
    
    isPositive - 设置为false创建一个负的持续时间。当持续时间的长度为零时，此参数将被忽略。
    
    years - 的 Duration
    
    months - 的 Duration
    
    days - 的 Duration
    
    hours - 的 Duration
    
    minutes - 的 Duration
    
    seconds - 的 Duration
    
    结果
    
    新建 Duration从指定的值创建。
    
    异常
    
    IllegalArgumentException -如果值不是一个有效表示 Duration ：如果所有的字段（年，月，...）都为空，或者如果任何字段为负。
    
    UnsupportedOperationException - 如果实现不能支持请求的值。
  - newDuration
```
public Duration newDuration(boolean isPositive,
                            int years,
                            int months,
                            int days,
                            int hours,
                            int minutes,
                            int seconds)
```
    获得的新实例Duration指定Duration为isPositive，年，月，日，时，分，秒。
    
    DatatypeConstants.FIELD_UNDEFINED值表示该字段未设置。
    
    参数
    
    isPositive - 设置为false创建一个负的持续时间。当持续时间的长度为零时，此参数将被忽略。
    
    years - 的 Duration
    
    months - 的 Duration
    
    days - 的 Duration
    
    hours - 的 Duration
    
    minutes - 的 Duration
    
    seconds - 的 Duration
    
    结果
    
    新建 Duration从指定的值创建。
    
    异常
    
    IllegalArgumentException - 如果值不是Duration的有效 Duration ：如果任何字段为负数。
    
    另请参见：
    
    newDuration( boolean isPositive, BigInteger years, BigInteger months, BigInteger days, BigInteger hours, BigInteger minutes, BigDecimal seconds)
  - newDurationDayTime
```
public Duration newDurationDayTime(String lexicalRepresentation)
```
    创建Duration型xdt:dayTimeDuration通过分析其String表示，“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 Schema规范声明值可以是任意大小。实施可能选择不支持或不能支持任意大和/或小的价值观。 UnsupportedOperationException将被抛出一个消息，指示执行限制，如果超出执行能力。
    
    参数
    
    lexicalRepresentation - 持续时间的词汇表示。
    
    结果
    
    新建 Duration使用指定的lexicalRepresentation lexicalRepresentation 。
    
    异常
    
    IllegalArgumentException - 如果 lexicalRepresentation不是仅在日期和时间表示的 Duration的有效表示。
    
    UnsupportedOperationException - 如果实现不能支持请求的值。
    
    NullPointerException - 如果 lexicalRepresentation是 null 。
  - 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 Schema 1.0和Java表示之间的日期/时间数据类型字段映射
    默认启动实例由下式定义GregorianCalendar即：的使用历元的开始的Calendar.YEAR = 1970， Calendar.MONTH = Calendar.JANUARY ， Calendar.DATE = 1等由于有在格里历的变化这一点很重要，例如，闰年有当月不同天= Calendar.FEBRUARY这样的结果Duration.getDays()会受到影响。
    
    确定天，小时，分钟和秒后的剩余毫秒数将被丢弃。
    参数
    
    durationInMilliseconds - 创建的毫秒数 Duration 。
    
    结果
    
    新建 Duration用指定的durationInMilliseconds durationInMilliseconds 。
    
    另请参见：
    
    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 Schema规范声明值可以是任意大小。实施可能选择不支持或不能支持任意大和/或小的价值观。如果超出实施容量，则会抛出一个UnsupportedOperationException的消息，指示执行限制。
    
    null值表示该字段未设置。
    
    参数
    
    isPositive - 设置为false创建一个负的持续时间。当持续时间的长度为零时，此参数将被忽略。
    
    day - 天 Duration 。
    
    hour - 小时 Duration 。
    
    minute - 分钟 Duration 。
    
    second - 第二个 Duration 。
    
    结果
    
    新 Duration使用指定的创建 day ， hour ， 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 。
    
    结果
    
    新 Duration使用指定的创建 day ， hour ， minute和 second 。
    
    异常
    
    IllegalArgumentException如果值不是一个有效的表征- Duration如果任何字段（日，小时，...）为负。
  - newDurationYearMonth
```
public Duration newDurationYearMonth(String lexicalRepresentation)
```
    创建Duration型xdt:yearMonthDuration通过分析其String表示，“PnYnM”， XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration 。
    
    数据类型xdt:yearMonthDuration是的亚型xs:duration ，其词汇表示仅包含年份和月份组成部分。该数据类型位于命名空间XMLConstants.W3C_XPATH_DATATYPE_NS_URI中。
    
    这两个值都是从创建的Duration设置和可用
    
    XML Schema规范声明值可以是任意大小。实施可能选择不支持或不能支持任意大和/或小的价值观。如果超出实施容量，那么将抛出一个UnsupportedOperationException的消息，指示实现限制。
    
    参数
    
    lexicalRepresentation - 持续时间的词汇表示。
    
    结果
    
    新建 Duration使用指定的lexicalRepresentation lexicalRepresentation 。
    
    异常
    
    IllegalArgumentException - 如果 lexicalRepresentation不是以年数和月份表示的 Duration的有效表示。
    
    UnsupportedOperationException - 如果实现不能支持请求的值。
    
    NullPointerException - 如果 lexicalRepresentation是 null 。
  - 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中。
    
    这两个值都是通过从指定的毫秒计算它们的值来设置的，并且可以使用创建的88546724563868的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 Schema 1.0和Java表示之间的日期/时间数据类型字段映射
    默认启动实例由下式定义GregorianCalendar即：的使用历元的开始的Calendar.YEAR = 1970， Calendar.MONTH = Calendar.JANUARY ， Calendar.DATE = 1等由于有在格里历的变化这一点很重要，例如，闰年有当月不同天= Calendar.FEBRUARY这样的结果Duration.getMonths()会受到影响。
    
    确定年份和月份后剩余的毫秒数将被丢弃。
    参数
    
    durationInMilliseconds - 创建的毫秒数 Duration 。
    
    结果
    
    新建 Duration使用指定的durationInMilliseconds durationInMilliseconds 。
  - 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 Schema规范声明值可以是任意大小。实施可能选择不支持或不能支持任意大和/或小的价值观。如果超出实施容量，那么UnsupportedOperationException将被抛出一个指示实现限制的消息。
    
    null值表示该字段未设置。
    
    参数
    
    isPositive - 设置为false以创建负持续时间。当持续时间的长度为零时，此参数将被忽略。
    
    year - 年份 Duration 。
    
    month - 月份 Duration 。
    
    结果
    
    新建 Duration使用指定的 year和 month 。
    
    异常
    
    IllegalArgumentException -如果值不是一个有效表示 Duration ：如果所有的字段（年，月）为null，或者如果任何字段为负。
    
    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 。
    
    结果
    
    新建 Duration使用指定的 year和 month 。
    
    异常
    
    IllegalArgumentException -如果值不是一个有效表示 Duration ：如果任何字段（年，月）为负。
  - newXMLGregorianCalendar
```
public abstract XMLGregorianCalendar newXMLGregorianCalendar()
```
    创建一个新的实例XMLGregorianCalendar 。
    
    所有日期/时间数据类型字段设置为DatatypeConstants.FIELD_UNDEFINED或为空。
    
    结果
    
    新的 XMLGregorianCalendar ，所有日期/时间数据类型字段设置为 DatatypeConstants.FIELD_UNDEFINED或为null。
  - newXMLGregorianCalendar
```
public abstract XMLGregorianCalendar newXMLGregorianCalendar(String lexicalRepresentation)
```
    通过解析String作为词法表示来创建一个新的XMLGregorianCalendar。
    
    解析词汇表示法在XML Schema 1.0 Part 2, Section 3.2.[7-14].1, Lexical Representation.中定义
    
    字符串表示可能没有任何前导和尾随空格。
    
    解析按字段字段进行，以便对于任何词法正确的字符串x，以下条件成立：
```
  newXMLGregorianCalendar(x).toXMLFormat().equals(x) 
```
    除了XML Schema 1.0 errata, Section 3.2.7.2中列出的所提及的词汇/规范表示不匹配之外。
    参数
    
    lexicalRepresentation - 八个XML模式日期/时间数据类型之一的词汇表示。
    
    结果
    
    XMLGregorianCalendar创建自 lexicalRepresentation 。
    
    异常
    
    IllegalArgumentException - 如果 lexicalRepresentation不是有效的 XMLGregorianCalendar 。
    
    NullPointerException - 如果 lexicalRepresentation是 null 。
  - newXMLGregorianCalendar
```
public abstract XMLGregorianCalendar newXMLGregorianCalendar(GregorianCalendar cal)
```
    创建一个XMLGregorianCalendar从GregorianCalendar 。
    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) / (60*1000)
    (in minutes) XMLGregorianCalendar.setTimezone(int offset)^*
    
    *转换信息丢失。不可能在XML Schema 1.0日期/时间数据类型表示中表示java.util.GregorianCalendar夏令java.util.GregorianCalendar区id。
    
    要计算返回值的TimeZone字段，
    - 当this.getTimezone() != FIELD_UNDEFINED ，创建一个java.util.TimeZone与自定义时区id使用this.getTimezone() 。
    - 否则使用GregorianCalendar默认的时区值为主机定义由java.util.TimeZone.getDefault() 。
    参数
    
    cal - java.util.GregorianCalendar用于创建 XMLGregorianCalendar
    
    结果
    
    XMLGregorianCalendar创建自 java.util.GregorianCalendar
    
    异常
    
    NullPointerException - 如果 cal是 null 。
  - 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.0允许的完整值空间的构造方法，用于xsd：dateTime和相关的内置数据类型。请注意， year参数支持任意大的数字，小数秒数具有无限精度。
    
    一个null值表示该字段未设置。
    
    参数
    
    year - of XMLGregorianCalendar待创建。
    
    month - of XMLGregorianCalendar待创建。
    
    day - of XMLGregorianCalendar待创建。
    
    hour - of XMLGregorianCalendar待创建。
    
    minute - of XMLGregorianCalendar待创建。
    
    second - of XMLGregorianCalendar待创建。
    
    fractionalSecond - of XMLGregorianCalendar待创建。
    
    timezone - of 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 - of XMLGregorianCalendar待创建。
    
    month - of XMLGregorianCalendar待创建。
    
    day - of XMLGregorianCalendar待创建。
    
    hour - of XMLGregorianCalendar待创建。
    
    minute - of XMLGregorianCalendar待创建。
    
    second - of XMLGregorianCalendar待创建。
    
    millisecond - of XMLGregorianCalendar待创建。
    
    timezone - of XMLGregorianCalendar待创建。
    
    结果
    
    XMLGregorianCalendar从指定的值创建。
    
    异常
    
    IllegalArgumentException -如果任何单独参数的值是由日期/时间数据的映射表中所确定的字段的最大值约束外XMLGregorianCalendar或如果复合值构成的无效XMLGregorianCalendar实例由以下方法测定XMLGregorianCalendar.isValid() 。
  - newXMLGregorianCalendarDate
```
public XMLGregorianCalendar newXMLGregorianCalendarDate(int year,
                                                        int month,
                                                        int day,
                                                        int timezone)
```
    创建XML Schema内置数据类型date或g*的Java表示g* 。
    
    例如，实例gYear可以创建调用此工厂month个day设置为参数DatatypeConstants.FIELD_UNDEFINED 。
    
    DatatypeConstants.FIELD_UNDEFINED值表示该字段未设置。
    
    参数
    
    year - of XMLGregorianCalendar待创建。
    
    month - of XMLGregorianCalendar待创建。
    
    day - of 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)
```
    创建XML Schema内置数据类型time的Java实例。
    
    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)
```
    创建XML Schema内置数据类型时间的Java实例。
    
    A 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)
```
    创建XML Schema内置数据类型时间的Java实例。
    
    一个DatatypeConstants.FIELD_UNDEFINED值表示该字段未设置。
    
    参数
    
    hours - 小时数
    
    minutes - 分钟数
    
    seconds - 秒数
    
    milliseconds - 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

字段详细信息

DATATYPEFACTORY_PROPERTY

DATATYPEFACTORY_IMPLEMENTATION_CLASS

构造方法详细信息

DatatypeFactory

方法详细信息

newInstance

newInstance

提示进行故障排除

newDuration

newDuration

newDuration

newDuration

newDurationDayTime

newDurationDayTime

newDurationDayTime

newDurationDayTime

newDurationYearMonth

newDurationYearMonth

newDurationYearMonth

newDurationYearMonth

newXMLGregorianCalendar

newXMLGregorianCalendar

newXMLGregorianCalendar

newXMLGregorianCalendar

newXMLGregorianCalendar

newXMLGregorianCalendarDate

newXMLGregorianCalendarTime

newXMLGregorianCalendarTime

newXMLGregorianCalendarTime