Class FixedZoneRules
- All Implemented Interfaces:
Serializable
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final ZoneOffset
The fixed offset.private static final long
A serialization identifier for this class. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionboolean
Checks if this object equals another, comparing the offset.getOffset
(InstantProvider instant) Gets the offset applicable at the specified instant in this zone.getOffsetInfo
(LocalDateTime dateTime) Gets the offset information for a local date-time in this zone.getStandardOffset
(InstantProvider instant) Gets the standard offset for the specified instant in this zone.Gets the list of transition rules for years beyond those defined in the transition list.Gets the complete list of fully defined transitions.int
hashCode()
Returns a suitable hash code.boolean
Checks of the zone rules are fixed, such that the offset never varies.nextTransition
(InstantProvider instantProvider) Gets the next transition after the specified transition.previousTransition
(InstantProvider instantProvider) Gets the previous transition after the specified transition.(package private) static FixedZoneRules
Reads the state from the stream.toString()
Returns a string describing this object.(package private) void
writeExternal
(DataOutput out) Writes the state to the stream.private Object
Uses a serialization delegate.Methods inherited from class javax.time.calendar.zone.ZoneRules
checkNotNull, getDaylightSavings, getOffsetInfo, isDaylightSavings, isValidDateTime, ofFixed
-
Field Details
-
serialVersionUID
private static final long serialVersionUIDA serialization identifier for this class.- See Also:
-
offset
The fixed offset.
-
-
Constructor Details
-
FixedZoneRules
FixedZoneRules(ZoneOffset offset) Constructor.- Parameters:
offset
- the zone offset, not null
-
-
Method Details
-
writeReplace
Uses a serialization delegate.- Returns:
- the replacing object, never null
-
writeExternal
Writes the state to the stream.- Parameters:
out
- the output stream, not null- Throws:
IOException
- if an error occurs
-
readExternal
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
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)
. -
getOffsetInfo
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.
ZoneOffsetInfo.isTransition()
to handle the gap or overlap.- Specified by:
getOffsetInfo
in classZoneRules
- Parameters:
dateTime
- the date-time to find the offset information for, not null- Returns:
- the offset information, never null
-
getStandardOffset
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 classZoneRules
- 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
andOffsetTime
are used in preference to fixed offset time-zones inZonedDateTime
.The default implementation returns false.
- Overrides:
isFixedOffset
in classZoneRules
- Returns:
- true if the time-zone is fixed and the offset never changes
-
nextTransition
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 classZoneRules
- 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
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 classZoneRules
- 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
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 classZoneRules
- Returns:
- independent, modifiable copy of the list of fully defined transitions, never null
-
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 ofZoneOffsetTransitionRule
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 classZoneRules
- Returns:
- independent, modifiable copy of the list of transition rules, never null
-
equals
Checks if this object equals another, comparing the offset.The entire state of the object is compared.
-
hashCode
public int hashCode()Returns a suitable hash code. -
toString
Returns a string describing this object.
-