org.exolab.castor.types
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:

Serialized Form

Field Summary

Fields inherited from class org.exolab.castor.types.DateTimeBase

EQUALS, GREATER_THAN, INDETERMINATE, LESS_THAN, MAX_TIME_ZONE_COMPARISON_OFFSET, WRONGLY_PLACED

Constructor Summary

GYearMonth()
public only for the generated source code

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

GYearMonth(short[] values)
Constructs a XML Schema GYearMonth instance given all the values of the different fields.

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

GYearMonth(String gyearMonth)
Constructs a GYearMonth given a string representation

Method Summary

short	getDay()
short	getHour()
short	getMilli()
short	getMinute()
short	getSeconds()
short[]	getValues() Returns an array of short with all the fields that describe this gYearMonth type.
boolean	hasDay()
boolean	hasHour()
boolean	hasMilli()
boolean	hasMinute()
boolean	hasSeconds()
static Object	parse(String str) parse a String and convert it into an java.lang.Object
static GYearMonth	parseGYearMonth(String str) parse a String and convert it into a gYearMonth.
void	setDay(short day) Sets the Day Field.
void	setHour(short hour) Sets the hour field for this date/time type.
void	setMilliSecond(short millisecond) Sets the millisecond field for this date/time type.
void	setMinute(short minute) set the minute field for this date/time type.
void	setSecond(short second) Sets the seconds field for this date/time type, not including the fractional seconds.
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.
Date	toDate() converts this gYearMonth into a local java Date.
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)

Methods inherited from class org.exolab.castor.types.DateTimeBase

addDuration, appendDateString, appendTimeString, appendTimeZoneString, clone, compareTo, equal, equals, getCentury, getMonth, getYear, getZoneHour, getZoneMinute, hasCentury, hashCode, hasIsNegative, hasMonth, hasYear, isLeap, isNegative, isUTC, isZoneNegative, normalize, parseDay, parseMonth, parseTime, parseTimeZone, parseYear, setCentury, setDateFormatTimeZone, setDateFormatTimeZone, setMonth, setNegative, setSecond, setUTC, setYear, setZone, setZoneHour, setZoneMinute, setZoneNegative, toCalendar

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

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 Detail

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

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