org.apache.xerces.xs.datatypes.XSDateTime |
Class Overview
Interface to expose the values for all date-time related types. The following
table shows the methods defined for various XML Schema 1.0 built-in types. 'X'
marks whether a particular method is defined for a particular type. Accessing undefined
methods may return unexpected values.
XML Schema Datatype |
getYears() |
getMonths() |
getDays() |
getHours() |
getMinutes() |
getSeconds() |
getTimeZoneHours() |
getTimeZoneMinutes() |
getXMLGregorianCalendar() |
getDuration() |
hasTimeZone() |
normalize() |
isNormalized() |
getLexicalValue() |
gYear |
X |
- |
- |
- |
- |
- |
X |
X |
X |
- |
X |
X |
X |
X |
gMonth |
- |
X |
- |
- |
- |
- |
X |
X |
X |
- |
X |
X |
X |
X |
gDay |
- |
- |
X |
- |
- |
- |
X |
X |
X |
- |
X |
X |
X |
X |
gYearMonth |
X |
X |
- |
- |
- |
- |
X |
X |
X |
- |
X |
X |
X |
X |
gMonthDay |
- |
X |
X |
- |
- |
- |
X |
X |
X |
- |
X |
X |
X |
X |
date |
X |
X |
X |
- |
- |
- |
X |
X |
X |
- |
X |
X |
X |
X |
time |
- |
- |
- |
X |
X |
X |
X |
X |
X |
- |
X |
X |
X |
X |
datetime |
X |
X |
X |
X |
X |
X |
X |
X |
X |
- |
X |
X |
X |
X |
duration |
- |
X |
- |
- |
- |
X |
- |
- |
- |
X |
- |
- |
- |
X |
Public Methods
public
abstract
int
getDays
()
Returns
- days - cannot be negative;
public
abstract
Duration
getDuration
()
Returns
- a Duration (if applicable otherwise null)
public
abstract
int
getHours
()
Returns
- hours - cannot be negative;
public
abstract
String
getLexicalValue
()
Returns
- the original lexical value
public
abstract
int
getMinutes
()
Returns
- minutes - cannot be negative;
public
abstract
int
getMonths
()
Returns
- months - can be negative only for duration types;
For duration types, it returns years*12 + months
public
abstract
double
getSeconds
()
Returns
- seconds - can be negative only for durations;
For duration types, it returns days*24*3600 + hours*3600
+ minutes*60 + seconds
public
abstract
int
getTimeZoneHours
()
Returns
- timezone hours (for GMT-xx:xx this will be negative),
public
abstract
int
getTimeZoneMinutes
()
Returns
- timezone minutes (for GMT-xx:xx this will be negative),
public
abstract
XMLGregorianCalendar
getXMLGregorianCalendar
()
Returns
- an un-normalized XMLGregorianCalendar (if applicable otherwise null)
public
abstract
int
getYears
()
Returns
- years - can be negative for date-time related types;
public
abstract
boolean
hasTimeZone
()
Returns
- boolean (true when timezone is specified in the original lexical value)
public
abstract
boolean
isNormalized
()
Returns
- whether a date-time related object is normalized or not
(value is not useful for types where timezone is not specified)
public
abstract
XSDateTime
normalize
()
Returns
- a new date-time related object with normalized values
(has no effect on objects already
normalized)