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: 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)