net.sf.saxon.value
Class GYearValue

java.lang.Object
  net.sf.saxon.value.Value
      net.sf.saxon.value.AtomicValue
          net.sf.saxon.value.CalendarValue
              net.sf.saxon.value.GDateValue
                  net.sf.saxon.value.GYearValue

All Implemented Interfaces:

Serializable, PullEvent, SequenceIterable, GroundedValue, Item, ValueRepresentation, ConversionResult

public class GYearValue
extends GDateValue

Implementation of the xs:gYear data type

See Also:

Serialized Form

Field Summary

Fields inherited from class net.sf.saxon.value.GDateValue

day, daysPerMonth, month, monthData, year

Fields inherited from class net.sf.saxon.value.CalendarValue

NO_TIMEZONE

Fields inherited from class net.sf.saxon.value.AtomicValue

typeLabel

Fields inherited from class net.sf.saxon.value.Value

INDETERMINATE_ORDERING

Fields inherited from interface net.sf.saxon.om.ValueRepresentation

EMPTY_VALUE_ARRAY

Constructor Summary

GYearValue(int year, int tz)

GYearValue(int year, int tz, AtomicType type)

Method Summary

CalendarValue	add(DurationValue duration) Add a duration to this date/time value
CalendarValue	adjustTimezone(int tz) Return a new date, time, or dateTime with the same normalized value, but in a different timezone
ConversionResult	convertPrimitive(BuiltInAtomicType requiredType, boolean validate, XPathContext context) Convert to target data type
AtomicValue	copyAsSubType(AtomicType typeLabel) Make a copy of this date, time, or dateTime value
CharSequence	getPrimitiveStringValue() Convert the value to a string, using the serialization rules for the primitive type.
BuiltInAtomicType	getPrimitiveType() Determine the primitive type of the value.
static ConversionResult	makeGYearValue(CharSequence value)

Methods inherited from class net.sf.saxon.value.GDateValue

compareTo, equals, getCalendar, getComparisonKey, getComponent, getDay, getMonth, getSchemaComparable, getYear, hashCode, isLeapYear, isValidDate, setLexicalValue, toDateTime

Methods inherited from class net.sf.saxon.value.CalendarValue

adjustTimezone, appendTimezone, appendTimezone, getTimezoneInMinutes, getXPathComparable, hasTimezone, isIdentical, makeCalendarValue, removeTimezone, setTimezoneInMinutes, subtract

Methods inherited from class net.sf.saxon.value.AtomicValue

asAtomic, checkPermittedContents, convert, convert, effectiveBooleanValue, getCardinality, getItemType, getLength, getStringValue, 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, reduce, stringToNumber

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

GYearValue

public GYearValue(int year,
                  int tz)

GYearValue

public GYearValue(int year,
                  int tz,
                  AtomicType type)

Method Detail

makeGYearValue

public static ConversionResult makeGYearValue(CharSequence value)

copyAsSubType

public AtomicValue copyAsSubType(AtomicType typeLabel)

Make a copy of this date, time, or dateTime value

Specified by:

copyAsSubType in class AtomicValue

Parameters:

typeLabel -

Returns:

the copied value

getPrimitiveType

public BuiltInAtomicType getPrimitiveType()

Determine the primitive type of the value. This delivers the same answer as getItemType().getPrimitiveItemType(). The primitive types are the 19 primitive types of XML Schema, plus xs:integer, xs:dayTimeDuration and xs:yearMonthDuration, and xs:untypedAtomic. For external objects, the result is AnyAtomicType.

Specified by:

getPrimitiveType in class AtomicValue

Returns:

the primitive type

convertPrimitive

public ConversionResult convertPrimitive(BuiltInAtomicType requiredType,
                                         boolean validate,
                                         XPathContext context)

Convert to target data type

Specified by:

convertPrimitive in class AtomicValue

Parameters:

requiredType - an integer identifying the required atomic type

context -

validate - true if validation is required. If set to false, the caller guarantees that the value is valid for the target data type, and that further validation is therefore not required. Note that a validation failure may be reported even if validation was not requested.

Returns:

an AtomicValue, a value of the required type; or an ErrorValue

getPrimitiveStringValue

public CharSequence getPrimitiveStringValue()

Description copied from class: AtomicValue

Convert the value to a string, using the serialization rules for the primitive type. This is the result of conversion to a string except that postprocessing defined by the saxon:preprocess facet is not (yet) applied.

Specified by:

getPrimitiveStringValue in class AtomicValue

Returns:

the value converted to a string according to the rules for the primitive type

add

public CalendarValue add(DurationValue duration)
                  throws XPathException

Add a duration to this date/time value

Specified by:

add in class CalendarValue

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

adjustTimezone

public CalendarValue adjustTimezone(int tz)

Return a new date, time, or dateTime with the same normalized value, but in a different timezone

Specified by:

adjustTimezone in class CalendarValue

Parameters:

tz - the new timezone, in minutes

Returns:

the date/time in the new timezone