Overview Summary

Please note that the specifications and other information contained herein are not final and are subject to change. The information is being made available to you solely for purpose of evaluation.

# Package javax.xml.datatype

XML/Java Type Mappings.

See: Description

- Class Summary
  Class | Description
  --- | ---
  DatatypeConstants | Utility class to contain basic Datatype values as constants.
  DatatypeConstants.Field | Type-safe enum class that represents six fields of the `Duration` class.
  DatatypeFactory | Factory that creates new `javax.xml.datatype` `Object`s that map XML to/from Java `Object`s.
  Duration | Immutable representation of a time span as defined in the W3C XML Schema 1.0 specification.
  XMLGregorianCalendar | Representation for W3C XML Schema 1.0 date/time datatypes.

- Exception Summary
  Exception | Description
  --- | ---
  DatatypeConfigurationException | Indicates a serious configuration error.

## Package javax.xml.datatype Description

XML/Java Type Mappings.

`javax.xml.datatype`API provides XML/Java type mappings.

The following XML standards apply:

- W3C XML Schema 1.0 Part 2, Section 3.2.7-14
- XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration
- XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration

W3C XML Schema Data Type | Java Data Type
--- | ---
xs:date | `XMLGregorianCalendar`
xs:dateTime | `XMLGregorianCalendar`
xs:duration | `Duration`
xs:gDay | `XMLGregorianCalendar`
xs:gMonth | `XMLGregorianCalendar`
xs:gMonthDay | `XMLGregorianCalendar`
xs:gYear | `XMLGregorianCalendar`
xs:gYearMonth | `XMLGregorianCalendar`
xs:time | `XMLGregorianCalendar`

XQuery 1.0 and XPath 2.0 Data Model | Java Data Type
--- | ---
xdt:dayTimeDuration | `Duration`
xdt:yearMonthDuration | `Duration`

W3C XML Schema data types that have a "natural" mapping to Java types are defined by JSR 31: Java™ Architecture for XML Binding (JAXB) Specification, Binding XML Schema to Java Representations. JAXB defined mappings for XML Schema built-in data types include:

- xs:anySimpleType
- xs:base64Binary
- xs:boolean
- xs:byte
- xs:decimal
- xs:double
- xs:float
- xs:hexBinary
- xs:int
- xs:integer
- xs:long
- xs:QName
- xs:short
- xs:string
- xs:unsignedByte
- xs:unsignedInt
- xs:unsignedShort

- Author Jeff Suttor
- See W3C XML Schema 1.0 Part 2, Section 3.2.7-14
- See XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration
- See XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration
- Since 1.5

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.
DRAFT internal-b00