public interface XSDateTime
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 |
- Version:
- $Id: XSDateTime.java 447250 2006-09-18 05:27:17Z mrglavas $
- Author:
- Ankit Pasricha, IBM
-
Method Details
-
getYears
int getYears()- Returns:
- years - can be negative for date-time related types;
-
getMonths
int getMonths()- Returns:
- months - can be negative only for duration types; For duration types, it returns years*12 + months
-
getDays
int getDays()- Returns:
- days - cannot be negative;
-
getHours
int getHours()- Returns:
- hours - cannot be negative;
-
getMinutes
int getMinutes()- Returns:
- minutes - cannot be negative;
-
getSeconds
double getSeconds()- Returns:
- seconds - can be negative only for durations; For duration types, it returns days*24*3600 + hours*3600 + minutes*60 + seconds
-
hasTimeZone
boolean hasTimeZone()- Returns:
- boolean (true when timezone is specified in the original lexical value)
-
getTimeZoneHours
int getTimeZoneHours()- Returns:
- timezone hours (for GMT-xx:xx this will be negative),
-
getTimeZoneMinutes
int getTimeZoneMinutes()- Returns:
- timezone minutes (for GMT-xx:xx this will be negative),
-
getLexicalValue
String getLexicalValue()- Returns:
- the original lexical value
-
normalize
XSDateTime normalize()- Returns:
- a new date-time related object with normalized values (has no effect on objects already normalized)
-
isNormalized
boolean isNormalized()- Returns:
- whether a date-time related object is normalized or not (value is not useful for types where timezone is not specified)
-
getXMLGregorianCalendar
XMLGregorianCalendar getXMLGregorianCalendar()- Returns:
- an un-normalized XMLGregorianCalendar (if applicable otherwise null)
-
getDuration
Duration getDuration()- Returns:
- a Duration (if applicable otherwise null)
-