Class CalendarValue

All Implemented Interfaces:
Serializable, Comparable, Expression, Item, ValueRepresentation
Direct Known Subclasses:
DateTimeValue, DateValue, TimeValue

public abstract class CalendarValue extends AtomicValue implements Comparable
Abstract superclass for Date, Time, and DateTime.
See Also:
  • Field Details

  • 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

      public abstract DateTimeValue toDateTime()
      Convert the value to a DateTime, retaining all the components that are actually present, and substituting conventional values for components that are missing
    • 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

      public final String getStringValue()
      Convert the value to a string
      Specified by:
      getStringValue in interface Item
      Specified by:
      getStringValue in interface ValueRepresentation
      Specified by:
      getStringValue in class AtomicValue
      Returns:
      the string value of the item
      See Also:
    • getCalendar

      public abstract GregorianCalendar 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

      public abstract CalendarValue add(DurationValue duration) throws XPathException
      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 SecondsDurationValue subtract(CalendarValue other, XPathContext context) throws XPathException
      Determine the difference between two points in time, as a duration
      Parameters:
      other - the other point in time
      context - 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 xdt:dayTimeDuration
      Throws:
      XPathException - for example if one value is a date and the other is a time
    • removeTimezone

      public final CalendarValue 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

      public abstract CalendarValue adjustTimezone(int tz)
      Return a new date, time, or dateTime with the same normalized value, but in a different timezone
      Parameters:
      tz - the new timezone, in minutes
      Returns:
      the date/time in the new timezone
    • copy

      public abstract CalendarValue copy()
      Make a copy of this date, time, or dateTime value
    • compareTo

      public abstract int compareTo(CalendarValue other, Configuration config)
      Compare this value to another value of the same type, using the supplied ConversionContext to get the implicit timezone if required.
    • getComparisonKey

      public abstract ComparisonKey getComparisonKey(Configuration config)
      Get a comparison key for this value. Two values are equal if and only if they their comparison keys are equal
    • appendTimezone

      public final void appendTimezone(FastStringBuffer sb)
      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

      public static final void appendTimezone(int tz, FastStringBuffer sb)
    • appendString

      static void appendString(FastStringBuffer sb, int value, int size)
      Append an integer, formatted with leading zeros to a fixed size, to a string buffer
      Parameters:
      sb - the string buffer
      value - the integer to be formatted
      size - the number of digits required (max 9)
    • appendTwoDigits

      static void appendTwoDigits(FastStringBuffer sb, int value)
      Append an integer, formatted as two digits, to a string buffer
      Parameters:
      sb - the string buffer
      value - the integer to be formatted (must be in the range 0..99