Class FixedZoneRules

java.lang.Object
javax.time.calendar.zone.ZoneRules
javax.time.calendar.zone.FixedZoneRules
All Implemented Interfaces:
Serializable

final class FixedZoneRules extends ZoneRules implements Serializable
Implementation of zone rules for fixed offsets.
  • Field Details

    • serialVersionUID

      private static final long serialVersionUID
      A serialization identifier for this class.
      See Also:
    • offset

      private final ZoneOffset offset
      The fixed offset.
  • Constructor Details

    • FixedZoneRules

      FixedZoneRules(ZoneOffset offset)
      Constructor.
      Parameters:
      offset - the zone offset, not null
  • Method Details

    • writeReplace

      private Object writeReplace()
      Uses a serialization delegate.
      Returns:
      the replacing object, never null
    • writeExternal

      void writeExternal(DataOutput out) throws IOException
      Writes the state to the stream.
      Parameters:
      out - the output stream, not null
      Throws:
      IOException - if an error occurs
    • readExternal

      static FixedZoneRules readExternal(DataInput in) throws IOException
      Reads the state from the stream.
      Parameters:
      in - the input stream, not null
      Returns:
      the created object, never null
      Throws:
      IOException - if an error occurs
    • getOffset

      public ZoneOffset getOffset(InstantProvider instant)
      Gets the offset applicable at the specified instant in this zone.

      For any given instant there can only ever be one valid offset, which is returned by this method. To access more detailed information about the offset at and around the instant use ZoneRules.getOffsetInfo(Instant).

      Specified by:
      getOffset in class ZoneRules
      Parameters:
      instant - the instant to find the offset for, ignored for fixed offset rules, otherwise not null
      Returns:
      the offset, never null
    • getOffsetInfo

      public ZoneOffsetInfo getOffsetInfo(LocalDateTime dateTime)
      Gets the offset information for a local date-time in this zone.

      This provides access to full details as to the offset or offsets applicable for the local date-time. The mapping from a local date-time to an offset is not straightforward. There are three cases:

      • Normal. Where there is a single offset for the local date-time.
      • Gap. Where there is a gap in the local time-line normally caused by the spring cutover to daylight savings. There are no valid offsets within the gap
      • Overlap. Where there is a gap in the local time-line normally caused by the autumn cutover from daylight savings. There are two valid offsets during the overlap.
      The returned object provides this information and it is vital to check ZoneOffsetInfo.isTransition() to handle the gap or overlap.
      Specified by:
      getOffsetInfo in class ZoneRules
      Parameters:
      dateTime - the date-time to find the offset information for, not null
      Returns:
      the offset information, never null
    • getStandardOffset

      public ZoneOffset getStandardOffset(InstantProvider instant)
      Gets the standard offset for the specified instant in this zone.

      This provides access to historic information on how the standard offset has changed over time. The standard offset is the offset before any daylight savings time is applied. This is typically the offset applicable during winter.

      Specified by:
      getStandardOffset in class ZoneRules
      Parameters:
      instant - the instant to find the offset information for, not null
      Returns:
      the standard offset, never null
    • isFixedOffset

      public boolean isFixedOffset()
      Checks of the zone rules are fixed, such that the offset never varies.

      It is intended that OffsetDateTime, OffsetDate and OffsetTime are used in preference to fixed offset time-zones in ZonedDateTime.

      The default implementation returns false.

      Overrides:
      isFixedOffset in class ZoneRules
      Returns:
      true if the time-zone is fixed and the offset never changes
    • nextTransition

      public ZoneOffsetTransition nextTransition(InstantProvider instantProvider)
      Gets the next transition after the specified transition.

      This returns details of the next transition after the specified instant.

      Some providers of rules may not be able to return this information, thus the method is defined to throw UnsupportedOperationException. The supplied rules implementations do supply this information and don't throw the exception

      Specified by:
      nextTransition in class ZoneRules
      Parameters:
      instantProvider - the instant to get the next transition after, not null
      Returns:
      the next transition after the specified instant, null if this is after the last transition
    • previousTransition

      public ZoneOffsetTransition previousTransition(InstantProvider instantProvider)
      Gets the previous transition after the specified transition.

      This returns details of the previous transition after the specified instant.

      Some providers of rules may not be able to return this information, thus the method is defined to throw UnsupportedOperationException. The supplied rules implementations do supply this information and don't throw the exception

      Specified by:
      previousTransition in class ZoneRules
      Parameters:
      instantProvider - the instant to get the previous transition after, not null
      Returns:
      the previous transition after the specified instant, null if this is before the first transition
    • getTransitions

      public List<ZoneOffsetTransition> getTransitions()
      Gets the complete list of fully defined transitions.

      The complete set of transitions for this rules instance is defined by this method and ZoneRules.getTransitionRules(). This method returns those transitions that have been fully defined. These are typically historical, but may be in the future. The list will be empty for fixed offset rules.

      Some providers of rules cannot return this information, thus this method is defined to throw UnsupportedOperationException. The supplied 'TZDB' implementation can supply this information thus does not throw the exception.

      Specified by:
      getTransitions in class ZoneRules
      Returns:
      independent, modifiable copy of the list of fully defined transitions, never null
    • getTransitionRules

      public List<ZoneOffsetTransitionRule> getTransitionRules()
      Gets the list of transition rules for years beyond those defined in the transition list.

      The complete set of transitions for this rules instance is defined by this method and ZoneRules.getTransitions(). This method returns instances of ZoneOffsetTransitionRule that define an algorithm for when transitions will occur. The list will be empty for fixed offset rules.

      For any given ZoneRules, this list contains the transition rules for years beyond those years that have been fully defined. These rules typically refer to future daylight savings time rule changes.

      If the zone defines daylight savings into the future, then the list will normally be of size two and hold information about entering and exiting daylight savings. If the zone does not have daylight savings, or information about future changes is uncertain, then the list will be empty.

      Some providers of rules cannot return this information, thus this method is defined to throw UnsupportedOperationException. The supplied 'TZDB' implementation can supply this information thus does not throw the exception.

      Specified by:
      getTransitionRules in class ZoneRules
      Returns:
      independent, modifiable copy of the list of transition rules, never null
    • equals

      public boolean equals(Object otherRules)
      Checks if this object equals another, comparing the offset.

      The entire state of the object is compared.

      Specified by:
      equals in class ZoneRules
      Parameters:
      otherRules - the other rules, null returns false
      other - the other object to compare to, null returns false
      Returns:
      true if equal
    • hashCode

      public int hashCode()
      Returns a suitable hash code.
      Specified by:
      hashCode in class ZoneRules
      Returns:
      the hash code
    • toString

      public String toString()
      Returns a string describing this object.
      Overrides:
      toString in class Object
      Returns:
      a string for debugging, never null