Class StandardZoneRules
- All Implemented Interfaces:
Serializable
ZoneRules is immutable and thread-safe.
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static final int
The last year to have its transitions cached.private final ZoneOffsetTransitionRule[]
The last rule.private final ConcurrentMap<Year,
ZoneOffsetTransition[]> The map of recent transitions.private final long[]
The transitions between instants (epoch seconds), sorted.private final LocalDateTime[]
The transitions between local date-times, sorted.private static final long
A serialization identifier for this class.private final ZoneOffset[]
The standard offsets.private final long[]
The transitions between standard offsets (epoch seconds), sorted.private final ZoneOffset[]
The wall offsets. -
Constructor Summary
ConstructorsModifierConstructorDescriptionprivate
StandardZoneRules
(long[] standardTransitions, ZoneOffset[] standardOffsets, long[] savingsInstantTransitions, ZoneOffset[] wallOffsets, ZoneOffsetTransitionRule[] lastRules) Constructor.(package private)
StandardZoneRules
(ZoneOffset baseStandardOffset, ZoneOffset baseWallOffset, List<OffsetDateTime> standardOffsetTransitionList, List<ZoneOffsetTransition> transitionList, List<ZoneOffsetTransitionRule> lastRules) Constructor. -
Method Summary
Modifier and TypeMethodDescriptionboolean
Checks if this object equals another, comparing the complete set of rules.private ZoneOffsetInfo
findOffsetInfo
(LocalDateTime dt, ZoneOffsetTransition trans) Finds the offset info for a local date-time and transition.private ZoneOffsetTransition[]
findTransitionArray
(int year) Finds the appropriate transition array for the given year.getOffset
(InstantProvider instantProvider) Gets the offset applicable at the specified instant in this zone.Gets the offset information for a local date-time in this zone.getStandardOffset
(InstantProvider instantProvider) 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 transitions.int
hashCode()
Returns a suitable hash code.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 StandardZoneRules
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, isFixedOffset, isValidDateTime, ofFixed
-
Field Details
-
serialVersionUID
private static final long serialVersionUIDA serialization identifier for this class.- See Also:
-
LAST_CACHED_YEAR
private static final int LAST_CACHED_YEARThe last year to have its transitions cached.- See Also:
-
standardTransitions
private final long[] standardTransitionsThe transitions between standard offsets (epoch seconds), sorted. -
standardOffsets
The standard offsets. -
savingsInstantTransitions
private final long[] savingsInstantTransitionsThe transitions between instants (epoch seconds), sorted. -
savingsLocalTransitions
The transitions between local date-times, sorted. This is a paired array, where the first entry is the start of the transition and the second entry is the end of the transition. -
wallOffsets
The wall offsets. -
lastRules
The last rule. -
lastRulesCache
The map of recent transitions.
-
-
Constructor Details
-
StandardZoneRules
StandardZoneRules(ZoneOffset baseStandardOffset, ZoneOffset baseWallOffset, List<OffsetDateTime> standardOffsetTransitionList, List<ZoneOffsetTransition> transitionList, List<ZoneOffsetTransitionRule> lastRules) Constructor.- Parameters:
baseStandardOffset
- the standard offset to use before legal rules were set, not nullbaseWallOffset
- the wall offset to use before legal rules were set, not nullstandardOffsetTransitionList
- the list of changes to the standard offset, not nulltransitionList
- the list of transitions, not nulllastRules
- the recurring last rules, size 15 or less, not null
-
StandardZoneRules
private StandardZoneRules(long[] standardTransitions, ZoneOffset[] standardOffsets, long[] savingsInstantTransitions, ZoneOffset[] wallOffsets, ZoneOffsetTransitionRule[] lastRules) Constructor.- Parameters:
standardTransitions
- the standard transitions, not nullstandardOffsets
- the standard offsets, not nullsavingsLocalTransitions
- the standard transitions, not nullwallOffsets
- the wall offsets, not nulllastRules
- the recurring last rules, size 15 or less, 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 occursClassNotFoundException
-
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:
dt
- the date-time to find the offset information for, not null- Returns:
- the offset information, never null
-
findOffsetInfo
Finds the offset info for a local date-time and transition.- Parameters:
dt
- the date-time, not nulltrans
- the transition, not null- Returns:
- the offset info, never null
-
findTransitionArray
Finds the appropriate transition array for the given year.- Parameters:
year
- the year, not null- Returns:
- the transition array, 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:
instantProvider
- the instant to find the offset information for, not null- Returns:
- the standard offset, never null
-
nextTransition
Gets the next transition after the specified transition.- 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.- 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 transitions.This list normally contains a complete historical set of transitions that have occurred. Some transitions may be in the future, although generally the transition rules handle future years.
- Specified by:
getTransitions
in classZoneRules
- Returns:
- independent, modifiable copy of the list of transitions, never null
-
getTransitionRules
Gets the list of transition rules for years beyond those defined in the transition list.The list represents all the transitions that are expected in each year beyond those in the transition list. Normally, there are two transitions per year - into and out of daylight savings time. If daylight savings time does not occur then the list will be empty.
- 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 complete set of rules.The entire state of the object is compared.
-
hashCode
public int hashCode()Returns a suitable hash code. -
toString
Returns a string describing this object.
-