net.sf.saxon.value
public final class TimeValue extends CalendarValue
Constructor Summary | |
---|---|
TimeValue(byte hour, byte minute, byte second, int microsecond, int tz)
Construct a time value given the hour, minute, second, and microsecond components.
| |
TimeValue(GregorianCalendar calendar, int tz)
Constructor: create a time value given a Java calendar object | |
TimeValue(CharSequence s)
Constructor: create a dateTime value from a supplied string, in
ISO 8601 format |
Method Summary | |
---|---|
CalendarValue | add(DurationValue duration)
Add a duration to a dateTime |
CalendarValue | adjustTimezone(int timezone)
Return a new time with the same normalized value, but
in a different timezone. |
int | compareTo(Object other)
Compare the value to another dateTime value |
int | compareTo(CalendarValue other, XPathContext context)
Compare the value to another dateTime value |
AtomicValue | convertPrimitive(BuiltInAtomicType requiredType, boolean validate, XPathContext context)
Convert to target data type |
Object | convertToJava(Class target, XPathContext context)
Convert to Java object (for passing to external functions) |
CalendarValue | copy()
Make a copy of this date, time, or dateTime value |
boolean | equals(Object other) |
GregorianCalendar | getCalendar()
Get a Java Calendar object corresponding to this time, on a reference date |
AtomicValue | getComponent(int component)
Get a component of the value. |
ItemType | getItemType(TypeHierarchy th)
Determine the data type of the expression |
CharSequence | getStringValueCS()
Convert to string |
int | hashCode() |
SecondsDurationValue | subtract(CalendarValue other, XPathContext context)
Determine the difference between two points in time, as a duration |
DateTimeValue | toDateTime()
Convert to a DateTime value. |
Parameters: hour the hour value, 0-23 minute the minutes value, 0-59 second the seconds value, 0-59 microsecond the number of microseconds, 0-999999 tz the timezone displacement in minutes from UTC. Supply the value CalendarValue.NO_TIMEZONE if there is no timezone component.
Parameters: calendar holds the date and time tz the timezone offset in minutes, or NO_TIMEZONE indicating that there is no timezone
Parameters: duration the duration to be added (may be negative)
Returns: the new date
Throws: net.sf.saxon.trans.XPathException if the duration is an xs:duration, as distinct from a subclass thereof
Parameters: timezone the new timezone offset, in minutes
Returns: the time in the new timezone. This will be a new TimeValue unless no change was required to the original value
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: 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: requiredType an integer identifying the required atomic type context
Returns: an AtomicValue, a value of the required type; or an ErrorValue
Parameters: th
Returns: Type.TIME_TYPE,
Returns: ISO 8601 representation, in the localized timezone (the timezone held within the value).
Parameters: other the other point in time context
Returns: the duration as an xdt:dayTimeDuration
Throws: net.sf.saxon.trans.XPathException for example if one value is a date and the other is a time