## org.apache.axis.types
Class Duration

    java.lang.Object
      org.apache.axis.types.Duration

All Implemented Interfaces:
  java.io.Serializable

public class Duration
extends java.lang.Object
implements java.io.Serializable

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

Author:
  Wes Moulder <wes@themindelectric.com>, Dominik Kacprzak (dominik@opentoolbox.com)
See Also:
  XML Schema 3.2.6, Serialized Form

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

Method Summary
`boolean` `equals(java.lang.Object object)` The equals method compares the time represented by duration object, not its string representation.
`java.util.Calendar` `getAsCalendar()` Returns duration as a calendar.
`java.util.Calendar` `getAsCalendar(java.util.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(java.lang.String date)` This method parses the date portion of a String that represents xsd:duration - nYnMnD.
`void` `parseTime(java.lang.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(double seconds)` Sets the seconds.
`void` `setSeconds(int seconds)` Deprecated. use `setSeconds(double)` instead
`void` `setYears(int years)`
`java.lang.String` `toString()` This returns the xml representation of an xsd:duration object.

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

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(java.lang.String duration)
             throws java.lang.IllegalArgumentException

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

Parameters:
  `duration` - String
Throws:
  `SchemaException` - if the string doesn't parse correctly.
  `java.lang.IllegalArgumentException`

### Duration

    public Duration(boolean negative,
                    java.util.Calendar calendar)
             throws java.lang.IllegalArgumentException

  Constructs Duration from a Calendar.

Parameters:
  `calendar` - Calendar
Throws:
  `java.lang.IllegalArgumentException` - if the calendar object does not represent any date nor time.

Method Detail

### parseTime

    public void parseTime(java.lang.String time)
                   throws java.lang.IllegalArgumentException

  This method parses the time portion of a String that represents xsd:duration - nHnMnS.

  Parameters:
    `time` -
  Throws:
    `java.lang.IllegalArgumentException` - if time does not match pattern

### parseDate

    public void parseDate(java.lang.String date)
                   throws java.lang.IllegalArgumentException

  This method parses the date portion of a String that represents xsd:duration - nYnMnD.

  Parameters:
    `date` -
  Throws:
    `java.lang.IllegalArgumentException` - if date does not match pattern

### isNegative

    public boolean isNegative()

### getYears

    public int getYears()

### getMonths

    public int getMonths()

### getDays

    public int getDays()

### getHours

    public int getHours()

### getMinutes

    public int getMinutes()

### getSeconds

    public double getSeconds()

### setNegative

    public void setNegative(boolean negative)

  Parameters:
    `negative` -

### setYears

    public void setYears(int years)

  Parameters:
    `years` -

### setMonths

    public void setMonths(int months)

  Parameters:
    `months` -

### setDays

    public void setDays(int days)

  Parameters:
    `days` -

### setHours

    public void setHours(int hours)

  Parameters:
    `hours` -

### setMinutes

    public void setMinutes(int minutes)

  Parameters:
    `minutes` -

### setSeconds

    public void setSeconds(int seconds)

  Deprecated. use `setSeconds(double)` instead

  Parameters:
    `seconds` -

### setSeconds

    public void setSeconds(double seconds)

  Sets the seconds. NOTE: The fractional value of seconds is rounded up to milliseconds.

  Parameters:
    `seconds` - double

### toString

    public java.lang.String toString()

  This returns the xml representation of an xsd:duration object.

### equals

    public boolean equals(java.lang.Object object)

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

### hashCode

    public int hashCode()

### getAsCalendar

    public java.util.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 java.util.Calendar getAsCalendar(java.util.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

Copyright © 2005 Apache Web Services Project. All Rights Reserved.