Package net.sf.saxon.value
Class CalendarValue
java.lang.Object
net.sf.saxon.value.Value
net.sf.saxon.value.AtomicValue
net.sf.saxon.value.CalendarValue
- All Implemented Interfaces:
Serializable
,PullEvent
,SequenceIterable
,GroundedValue
,Item
,ValueRepresentation
,ConversionResult
- Direct Known Subclasses:
DateTimeValue
,GDateValue
,TimeValue
Abstract superclass for Date, Time, and DateTime.
- See Also:
-
Field Summary
FieldsFields inherited from class net.sf.saxon.value.AtomicValue
typeLabel
Fields inherited from class net.sf.saxon.value.Value
EMPTY_CLASS_ARRAY, INDETERMINATE_ORDERING
Fields inherited from interface net.sf.saxon.om.ValueRepresentation
EMPTY_VALUE_ARRAY
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionabstract CalendarValue
add
(DurationValue duration) Add a duration to this date/time valueabstract CalendarValue
adjustTimezone
(int tz) Return a new date, time, or dateTime with the same normalized value, but in a different timezonefinal CalendarValue
Return a new date, time, or dateTime with the same normalized value, but in a different timezone, specified as a dayTimeDurationstatic void
appendTimezone
(int tz, FastStringBuffer sb) Format a timezone and append it to a bufferfinal void
Add a string representation of the timezone, typically formatted as "Z" or "+03:00" or "-10:00", to a supplied string bufferabstract int
compareTo
(CalendarValue other, XPathContext context) Compare this value to another value of the same type, using the supplied Configuration to get the implicit timezone if required.abstract GregorianCalendar
Get a Java Calendar object that represents this date/time value.abstract ComparisonKey
getComparisonKey
(XPathContext context) Get a comparison key for this value.final String
Convert the value to a stringfinal int
Get the timezone value held in this object.getXPathComparable
(boolean ordered, StringCollator collator, XPathContext context) Get an object value that implements the XPath equality and ordering comparison semantics for this value.final boolean
Determine whether this value includes a timezonefinal CalendarValue
Return a date, time, or dateTime with the same localized value, but without the timezone componentfinal void
setTimezoneInMinutes
(int minutes) Modify the timezone value held in this object.subtract
(CalendarValue other, XPathContext context) Determine the difference between two points in time, as a durationabstract DateTimeValue
Convert the value to a DateTime, retaining all the components that are actually present, and substituting conventional values for components that are missingMethods inherited from class net.sf.saxon.value.AtomicValue
asAtomic, checkPermittedContents, convert, convert, convertPrimitive, copyAsSubType, effectiveBooleanValue, equals, getCardinality, getComponent, getItemType, getLength, getPrimitiveType, getSchemaComparable, getStringValueCS, getTypedValue, getTypeLabel, isNaN, itemAt, iterate, process, setTypeLabel, subsequence, toString
Methods inherited from class net.sf.saxon.value.Value
asItem, asItem, asIterator, asValue, convertToJava, fromItem, getCanonicalLexicalRepresentation, getIterator, iterate, makeQNameValue, reduce, stringToNumber
-
Field Details
-
NO_TIMEZONE
public static final int NO_TIMEZONE- See Also:
-
-
Constructor Details
-
CalendarValue
public CalendarValue()
-
-
Method Details
-
hasTimezone
public final boolean hasTimezone()Determine whether this value includes a timezone- Returns:
- true if there is a timezone in the value, false if not
-
setTimezoneInMinutes
public final void setTimezoneInMinutes(int minutes) Modify the timezone value held in this object. This must be done only while the value is being constructed.- Parameters:
minutes
- The timezone offset from GMT in minutes, positive or negative; or the special value NO_TIMEZONE indicating that the value is not in a timezone (this is the default if this method is not called)
-
toDateTime
Convert the value to a DateTime, retaining all the components that are actually present, and substituting conventional values for components that are missing- Returns:
- the equivalent DateTimeValue
-
getTimezoneInMinutes
public final int getTimezoneInMinutes()Get the timezone value held in this object.- Returns:
- The timezone offset from GMT in minutes, positive or negative; or the special value NO_TIMEZONE indicating that the value is not in a timezone
-
getStringValue
Convert the value to a string- Specified by:
getStringValue
in interfaceItem
- Specified by:
getStringValue
in interfaceValueRepresentation
- Specified by:
getStringValue
in classAtomicValue
- Returns:
- the string value of the item
- See Also:
-
getCalendar
Get a Java Calendar object that represents this date/time value. The Calendar object will be newly created for the purpose- Returns:
- A Calendar object representing the date and time. Note that Java can only represent the time to millisecond precision, and that it does not support the full range of timezones required by XPath (-14:00 to +14:00)
-
add
Add a duration to this date/time value- Parameters:
duration
- the duration to be added (which might be negative)- Returns:
- a new date/time value representing the result of adding the duration. The original object is not modified.
- Throws:
XPathException
-
subtract
public DayTimeDurationValue subtract(CalendarValue other, XPathContext context) throws XPathException Determine the difference between two points in time, as a duration- Parameters:
other
- the other point in timecontext
- the dynamic context, used to obtain timezone information. May be set to null only if both values contain an explicit timezone, or if neither does so.- Returns:
- the duration as an xs:dayTimeDuration
- Throws:
XPathException
- for example if one value is a date and the other is a time
-
removeTimezone
Return a date, time, or dateTime with the same localized value, but without the timezone component- Returns:
- the result of removing the timezone
-
adjustTimezone
Return a new date, time, or dateTime with the same normalized value, but in a different timezone- Parameters:
tz
- the new timezone offset from UTC, in minutes- Returns:
- the date/time in the new timezone
-
adjustTimezone
Return a new date, time, or dateTime with the same normalized value, but in a different timezone, specified as a dayTimeDuration- Parameters:
tz
- the new timezone, in minutes- Returns:
- the date/time in the new timezone
- Throws:
XPathException
-
getXPathComparable
public Object getXPathComparable(boolean ordered, StringCollator collator, XPathContext context) throws NoDynamicContextException Get an object value that implements the XPath equality and ordering comparison semantics for this value. If the ordered parameter is set to true, the result will be a Comparable and will support a compareTo() method with the semantics of the XPath lt/gt operator, provided that the other operand is also obtained using the getXPathComparable() method. In all cases the result will support equals() and hashCode() methods that support the semantics of the XPath eq operator, again provided that the other operand is also obtained using the getXPathComparable() method. A context argument is supplied for use in cases where the comparison semantics are context-sensitive, for example where they depend on the implicit timezone or the default collation.- Specified by:
getXPathComparable
in classAtomicValue
- Parameters:
ordered
- true if an ordered comparison is required. In this case the result is null if the type is unordered; in other cases the returned value will be a Comparable.collator
- collation used for stringscontext
- the XPath dynamic evaluation context, used in cases where the comparison is context sensitive @return an Object whose equals() and hashCode() methods implement the XPath comparison semantics with respect to this atomic value. If ordered is specified, the result will either be null if no ordering is defined, or will be a Comparable- Returns:
- an Object whose equals() and hashCode() methods implement the XPath comparison semantics with respect to this atomic value. If ordered is specified, the result will either be null if no ordering is defined, or will be a Comparable
- Throws:
NoDynamicContextException
- if the comparison depends on dynamic context information that is not available, for example implicit timezone
-
compareTo
public abstract int compareTo(CalendarValue other, XPathContext context) throws NoDynamicContextException Compare this value to another value of the same type, using the supplied Configuration to get the implicit timezone if required.- Parameters:
other
- the other value to be comparedcontext
- the XPath dynamic evaluation context- Returns:
- the comparison result
- Throws:
NoDynamicContextException
- if the supplied context is an early evaluation context and the result depends on the implicit timezone, which is not available at compile time
-
getComparisonKey
public abstract ComparisonKey getComparisonKey(XPathContext context) throws NoDynamicContextException Get a comparison key for this value. Two values are equal if and only if they their comparison keys are equal- Parameters:
context
- XPath dynamic evaluation context, used to obtain implicit timezone- Returns:
- a comparison key
- Throws:
NoDynamicContextException
- if the implicit timezone is needed and is not available
-
appendTimezone
Add a string representation of the timezone, typically formatted as "Z" or "+03:00" or "-10:00", to a supplied string buffer- Parameters:
sb
- The StringBuffer that will be updated with the resulting string representation
-
appendTimezone
Format a timezone and append it to a buffer- Parameters:
tz
- the timezonesb
- the buffer
-