Interface XSDateTime
-
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$
- Author:
- Ankit Pasricha, IBM
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description int
getDays()
Duration
getDuration()
int
getHours()
String
getLexicalValue()
int
getMinutes()
int
getMonths()
double
getSeconds()
int
getTimeZoneHours()
int
getTimeZoneMinutes()
XMLGregorianCalendar
getXMLGregorianCalendar()
int
getYears()
boolean
hasTimeZone()
boolean
isNormalized()
XSDateTime
normalize()
-
-
-
Method Detail
-
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)
-
-