net.sf.saxon.value
public final class DayTimeDurationValue extends DurationValue implements Comparable
Constructor Summary | |
---|---|
DayTimeDurationValue(int sign, int days, int hours, int minutes, long seconds, int microseconds)
Create a dayTimeDuration given the number of days, hours, minutes, and seconds. |
Method Summary | |
---|---|
DurationValue | add(DurationValue other)
Add two dayTimeDurations |
int | compareTo(Object other)
Compare the value to another duration value
|
AtomicValue | copyAsSubType(AtomicType typeLabel)
Create a copy of this atomic value, with a different type label
|
DecimalValue | divide(DurationValue other)
Find the ratio between two durations
|
static DayTimeDurationValue | fromMicroseconds(long microseconds)
Construct a duration value as a number of microseconds.
|
static DayTimeDurationValue | fromMilliseconds(long milliseconds)
Construct a duration value as a number of milliseconds.
|
static DayTimeDurationValue | fromSeconds(BigDecimal seconds)
Construct a duration value as a number of seconds.
|
long | getLengthInMicroseconds()
Get length of duration in microseconds, as a long
|
long | getLengthInMilliseconds()
Get length of duration in milliseconds, as a long
|
double | getLengthInSeconds()
Get length of duration in seconds |
CharSequence | getPrimitiveStringValue()
Convert to string
|
BuiltInAtomicType | getPrimitiveType()
Determine the primitive type of the value. |
Object | getXPathComparable(boolean ordered, StringCollator collator, XPathContext context)
Get a Comparable value that implements the XPath ordering comparison semantics for this value.
|
static ConversionResult | makeDayTimeDurationValue(CharSequence s)
Factory method: create a duration value from a supplied string, in
ISO 8601 format [-]PnDTnHnMnS
|
DurationValue | multiply(double n)
Multiply duration by a number. |
DurationValue | negate()
Negate a duration (same as subtracting from zero, but it preserves the type of the original duration)
|
DurationValue | subtract(DurationValue other)
Subtract two dayTime-durations |
Parameters: sign positive number for positive durations, negative for negative duratoins days number of days hours number of hours minutes number of minutes seconds number of seconds microseconds number of microseconds
Throws: IllegalArgumentException if the value is out of range; specifically, if the total number of seconds exceeds 2^63; or if any of the values is negative
Parameters: other The other dateTime value
Returns: negative value if this one is the earler, 0 if they are chronologically equal, positive value if this one is the later. For this purpose, dateTime values with an unknown timezone are considered to be UTC values (the Comparable interface requires a total ordering).
Throws: ClassCastException if the other value is not a DateTimeValue (the parameter is declared as Object to satisfy the Comparable interface)
Parameters: typeLabel the type label of the new copy. The caller is responsible for checking that the value actually conforms to this type.
Parameters: other the dividend
Returns: the ratio, as a decimal
Throws: XPathException
Parameters: microseconds the number of microseconds in the duration. The maximum and minimum limits are such that the number of days in the duration must fit in a 32-bit signed integer.
Returns: the xs:dayTimeDuration represented by the given number of microseconds
Throws: IllegalArgumentException if the value is out of range.
Parameters: milliseconds the number of milliseconds in the duration (may be negative)
Returns: the corresponding xs:dayTimeDuration value
Throws: ValidationException if implementation-defined limits are exceeded, specifically if the total number of seconds exceeds 2^63.
Parameters: seconds the number of seconds in the duration. May be negative
Returns: the xs:dayTimeDuration value with the specified length
Returns: the length in microseconds
Returns: the length of the duration rounded to milliseconds (may be negative)
Returns: ISO 8601 representation.
Parameters: ordered true if an ordered comparable is needed collator Collation used for string comparison context XPath dynamic context
Parameters: s the lexical representation of the xs:dayTimeDuration value
Returns: a DayTimeDurationValue if the format is correct, or a ValidationErrorValue if not
Throws: IllegalArgumentException in the extremely unlikely event that the duration is one that cannot be negated (because the limit for positive durations is one second off from the limit for negative durations)