Class SaxonDuration

Computes a new duration whose value is this+rhs.

This implementation follows the XPath semantics. This means that the operation will fail if the duration is not a yearMonthDuration or a dayTimeDuration.

Adds this duration to a java.util.Calendar object.

Calls java.util.Calendar.add(int,int) in the order of YEARS, MONTHS, DAYS, HOURS, MINUTES, SECONDS, and MILLISECONDS if those fields are present. Because the java.util.Calendar class uses int to hold values, there are cases where this method won't work correctly (for example if values of fields exceed the range of int.)

Also, since this duration class is a Gregorian duration, this method will not work correctly if the given java.util.Calendar object is based on some other calendar systems.

Any fractional parts of this Duration object beyond milliseconds will be simply ignored. For example, if this duration is "P1.23456S", then 1 is added to SECONDS, 234 is added to MILLISECONDS, and the rest will be unused.

Note that because java.util.Calendar.add(int, int) is using int, Duration with values beyond the range of int in its fields will cause overflow/underflow to the given java.util.Calendar. javax.xml.datatype.XMLGregorianCalendar.add(javax.xml.datatype.Duration) provides the same basic operation as this method while avoiding the overflow/underflow issues.

Partial order relation comparison with this Duration instance.

This implementation follows the XPath semantics. This means that the result is defined only for dayTimeDuration and yearMonthDuration values, and the result is never indeterminate.

Return:

• javax.xml.datatype.DatatypeConstants.LESSER if this Duration is shorter than duration parameter
• javax.xml.datatype.DatatypeConstants.EQUAL if this Duration is equal to duration parameter
• javax.xml.datatype.DatatypeConstants.GREATER if this Duration is longer than duration parameter
• javax.xml.datatype.DatatypeConstants.INDETERMINATE if a conclusive partial order relation cannot be determined

Gets the value of a field.

Fields of a duration object may contain arbitrary large value. Therefore this method is designed to return a Number object.

In case of YEARS, MONTHS, DAYS, HOURS, and MINUTES, the returned number will be a non-negative integer. In case of seconds, the returned number may be a non-negative decimal value.

The Saxon implementation of duration uses normalized values. This means that the YEARS and DAYS fields may be arbitrarily large, but other components will be limited in size: for example MINUTES will never exceed 60 and MONTHS will never exceed 12.

Returns the sign of this duration in -1,0, or 1.

Get the type of this duration, as one of the values xs:duration, xs:dayTimeDuration, or xs:yearMonthDuration. (Note that the XML Schema namespace URI is used, whereas the current implementation of the superclass uses a provisional URI allocated in a 2003 W3C working draft)

Returns a hash code consistent with the definition of the equals method.

Checks if a field is set. In this implementation, all fields are always set.

Computes a new duration whose value is factor times longer than the value of this duration.

This implementation follows the XPath semantics. This means that it is defined only on yearMonthDuration and dayTimeDuration. Other cases produce an IllegalStateException.

Returns a new Duration object whose value is -this.

Since the Duration class is immutable, this method doesn't change the value of this object. It simply computes a new Duration object and returns it.

Converts the years and months fields into the days field by using a specific time instant as the reference point.

This implementation does not support this method

Computes a new duration whose value is this-rhs.

This implementation follows the XPath semantics. This means that the operation will fail if the duration is not a yearMonthDuration or a dayTimeDuration.