org.apache.axis.types

Class Duration

public class Duration extends Object implements Serializable

Implementation of the XML Schema type duration. Duration supports a minimum fractional second precision of milliseconds.

Author: Wes Moulder Dominik Kacprzak (dominik@opentoolbox.com)

See Also: XML Schema 3.2.6

Constructor Summary
	Duration() Default no-arg constructor
	Duration(boolean negative, int aYears, int aMonths, int aDays, int aHours, int aMinutes, double aSeconds)
	Duration(String duration) Constructs Duration from a String in an xsd:duration format - PnYnMnDTnHnMnS.
	Duration(boolean negative, Calendar calendar) Constructs Duration from a Calendar.

Method Summary
boolean	equals(Object object) The equals method compares the time represented by duration object, not its string representation.
Calendar	getAsCalendar() Returns duration as a calendar.
Calendar	getAsCalendar(Calendar startTime) Returns duration as a calendar.
int	getDays()
int	getHours()
int	getMinutes()
int	getMonths()
double	getSeconds()
int	getYears()
int	hashCode()
boolean	isNegative()
void	parseDate(String date) This method parses the date portion of a String that represents xsd:duration - nYnMnD.
void	parseTime(String time) This method parses the time portion of a String that represents xsd:duration - nHnMnS.
void	setDays(int days)
void	setHours(int hours)
void	setMinutes(int minutes)
void	setMonths(int months)
void	setNegative(boolean negative)
void	setSeconds(int seconds)
void	setSeconds(double seconds) Sets the seconds.
void	setYears(int years)
String	toString() This returns the xml representation of an xsd:duration object.

Constructor Detail

Duration

public Duration()

Default no-arg constructor

Duration

public Duration(boolean negative, int aYears, int aMonths, int aDays, int aHours, int aMinutes, double aSeconds)

Parameters: negative aYears aMonths aDays aHours aMinutes aSeconds

Duration

public Duration(String duration)

Constructs Duration from a String in an xsd:duration format - PnYnMnDTnHnMnS.

Parameters: duration String

Throws: SchemaException if the string doesn't parse correctly.

Duration

public Duration(boolean negative, Calendar calendar)

Constructs Duration from a Calendar.

Parameters: calendar Calendar

Throws: IllegalArgumentException if the calendar object does not represent any date nor time.

The equals method compares the time represented by duration object, not its string representation. Hence, a duration object representing 65 minutes is considered equal to a duration object representing 1 hour and 5 minutes.

Parameters: object

getAsCalendar

public Calendar getAsCalendar()

Returns duration as a calendar. Due to the way a Calendar class works, the values for particular fields may not be the same as obtained through getter methods. For example, if a duration's object getMonths returns 20, a similar call on a calendar object will return 1 year and 8 months.

Returns: Calendar

getAsCalendar

public Calendar getAsCalendar(Calendar startTime)

Returns duration as a calendar. Due to the way a Calendar class works, the values for particular fields may not be the same as obtained through getter methods. For example, if a Duration's object getMonths returns 20, a similar call on a Calendar object will return 1 year and 8 months.

Parameters: startTime Calendar

Returns: Calendar