Package org.apache.xerces.xs.datatypes

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

        java.lang.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

        javax.xml.datatype.XMLGregorianCalendar getXMLGregorianCalendar()
        Returns:
        an un-normalized XMLGregorianCalendar (if applicable otherwise null)

      • getDuration

        javax.xml.datatype.Duration getDuration()
        Returns:
        a Duration (if applicable otherwise null)