Class GYearMonth

java.lang.Object
org.exolab.castor.types.DateTimeBase
org.exolab.castor.types.GYearMonth
All Implemented Interfaces:
Serializable, Cloneable
public class GYearMonth extends DateTimeBase
Describe an XML schema gYearMonth type.

The format is defined by W3C XML Schema Recommendation and ISO8601 i.e (-)CCYY-MM(Z|(+|-)hh:mm)

Version:
$Revision: 7289 $
Author:
Arnaud Blandin, Edward Kuns
See Also:

  • Constructor Details

    • GYearMonth

      public GYearMonth()
      public only for the generated source code

    • GYearMonth

      public GYearMonth(short century, short year, short month)
      Instantiates a new gYearMonth given the value of the month and the value of the day.
      Parameters:
      century - the month value
      year - the year value
      month - the month value

    • GYearMonth

      public GYearMonth(int year, int month)
      Instantiates a new gYearMonth given the value of the month and the value of the day.
      Parameters:
      year - the year value
      month - the month value

    • GYearMonth

      public GYearMonth(short[] values)
      Constructs a XML Schema GYearMonth instance given all the values of the different fields. By default a GYearMonth is not UTC and is local.
      Parameters:
      values - an array of shorts that represent the different fields of Time.

    • GYearMonth

      public GYearMonth(String gyearMonth) throws ParseException
      Constructs a GYearMonth given a string representation
      Parameters:
      gyearMonth - the string representation of the GYearMonth to instantiate
      Throws:
      ParseException - a parse exception is thrown if the string to parse does not follow the rigth format (see the description of this class)

  • Method Details

    • setValues

      public void setValues(short[] values)
      Sets all the fields by reading the values in an array

      if a Time Zone is specificied it has to be set by using setZone.

      Specified by:
      setValues in class DateTimeBase
      Parameters:
      values - an array of shorts with the values the array is supposed to be of length 3 and ordered like the following:
      • century
      • year
      • month

    • getValues

      public short[] getValues()
      Returns an array of short with all the fields that describe this gYearMonth type.

      Note:the time zone is not included.

      Specified by:
      getValues in class DateTimeBase
      Returns:
      an array of short with all the fields that describe this Date type.

    • toDate

      public Date toDate()
      converts this gYearMonth into a local java Date.
      Specified by:
      toDate in class DateTimeBase
      Returns:
      a local date representing this Date.

    • toString

      public String toString()
      convert this gYearMonth to a string The format is defined by W3C XML Schema recommendation and ISO8601 i.e (+|-)CCYY-MM(Z|(+|-)hh:mm)
      Overrides:
      toString in class Object
      Returns:
      a string representing this Date

    • parse

      public static Object parse(String str) throws ParseException
      parse a String and convert it into an java.lang.Object
      Parameters:
      str - the string to parse
      Returns:
      an Object represented by the string
      Throws:
      ParseException - a parse exception is thrown if the string to parse does not follow the rigth format (see the description of this class)

    • parseGYearMonth

      public static GYearMonth parseGYearMonth(String str) throws ParseException
      parse a String and convert it into a gYearMonth.
      Parameters:
      str - the string to parse
      Returns:
      the Date represented by the string
      Throws:
      ParseException - a parse exception is thrown if the string to parse does not follow the rigth format (see the description of this class)

    • hasDay

      public boolean hasDay()
      //////////////////////// DISALLOWED METHODS ///////////////////////////
      Overrides:
      hasDay in class DateTimeBase

    • getDay

      public short getDay()
      Overrides:
      getDay in class DateTimeBase

    • setDay

      public void setDay(short day)
      Description copied from class: DateTimeBase
      Sets the Day Field. Note: This field is validated before the assignment is done.
      Overrides:
      setDay in class DateTimeBase
      Parameters:
      day - the value to set up

    • hasHour

      public boolean hasHour()
      Overrides:
      hasHour in class DateTimeBase

    • getHour

      public short getHour()
      Overrides:
      getHour in class DateTimeBase

    • setHour

      public void setHour(short hour)
      Description copied from class: DateTimeBase
      Sets the hour field for this date/time type.
      Overrides:
      setHour in class DateTimeBase
      Parameters:
      hour - the hour to set

    • hasMinute

      public boolean hasMinute()
      Overrides:
      hasMinute in class DateTimeBase

    • getMinute

      public short getMinute()
      Overrides:
      getMinute in class DateTimeBase

    • setMinute

      public void setMinute(short minute)
      Description copied from class: DateTimeBase
      set the minute field for this date/time type.
      Overrides:
      setMinute in class DateTimeBase
      Parameters:
      minute - the minute to set.

    • hasSeconds

      public boolean hasSeconds()
      Overrides:
      hasSeconds in class DateTimeBase

    • getSeconds

      public short getSeconds()
      Overrides:
      getSeconds in class DateTimeBase

    • setSecond

      public void setSecond(short second)
      Description copied from class: DateTimeBase
      Sets the seconds field for this date/time type, not including the fractional seconds. Any fractional seconds previously set is unmodified.
      Overrides:
      setSecond in class DateTimeBase
      Parameters:
      second - the second to set

    • hasMilli

      public boolean hasMilli()
      Overrides:
      hasMilli in class DateTimeBase

    • getMilli

      public short getMilli()
      Overrides:
      getMilli in class DateTimeBase

    • setMilliSecond

      public void setMilliSecond(short millisecond)
      Description copied from class: DateTimeBase
      Sets the millisecond field for this date/time type.
      Overrides:
      setMilliSecond in class DateTimeBase
      Parameters:
      millisecond - the millisecond to set