public interface

XSDateTime

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

Summary

Public Methods
abstract int getDays()
abstract Duration getDuration()
abstract int getHours()
abstract String getLexicalValue()
abstract int getMinutes()
abstract int getMonths()
abstract double getSeconds()
abstract int getTimeZoneHours()
abstract int getTimeZoneMinutes()
abstract XMLGregorianCalendar getXMLGregorianCalendar()
abstract int getYears()
abstract boolean hasTimeZone()
abstract boolean isNormalized()
abstract XSDateTime normalize()

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)