Checks if this time-zone ID is equal to another time-zone ID.
Checks if this time-zone ID is equal to another time-zone ID.
The comparison is based on the ID.
the object to check, null returns false
true if this is equal to the other time-zone ID
Gets the textual representation of the zone, such as 'British Time' or '+02:00'.
Gets the textual representation of the zone, such as 'British Time' or '+02:00'.
This returns the textual name used to identify the time-zone ID, suitable for presentation to the user. The parameters control the style of the returned text and the locale.
If no textual mapping is found then the full ID
is returned.
the length of the text required, not null
the locale to use, not null
the text value of the zone, not null
Gets the unique time-zone ID.
Gets the unique time-zone ID.
This ID uniquely defines this object. The format of an offset based ID is defined by ZoneOffset#getId()
.
the time-zone unique ID, not null
Gets the time-zone rules for this ID allowing calculations to be performed.
Gets the time-zone rules for this ID allowing calculations to be performed.
The rules provide the functionality associated with a time-zone, such as finding the offset for a given instant or local date-time.
A time-zone can be invalid if it is deserialized in a Java Runtime which does not have the same
rules loaded as the Java Runtime that stored it. In this case, calling this method will throw a
ZoneRulesException
.
The rules are supplied by ZoneRulesProvider
. An advanced provider may support dynamic
updates to the rules without restarting the Java Runtime. If so, then the result of this method
may change over time. Each individual call will be still remain thread-safe.
ZoneOffset
will always return a set of rules where the offset never changes.
the rules, not null
ZoneRulesException
if no rules are available for this ID
A hash code for this time-zone ID.
A hash code for this time-zone ID.
a suitable hash code
Normalizes the time-zone ID, returning a ZoneOffset
where possible.
Normalizes the time-zone ID, returning a ZoneOffset
where possible.
The returns a normalized ZoneId
that can be used in place of this ID. The result will
have ZoneRules
equivalent to those returned by this object, however the ID returned by
getId()
may be different.
The normalization checks if the rules of this ZoneId
have a fixed offset. If they do,
then the ZoneOffset
equal to that offset is returned. Otherwise this
is
returned.
the time-zone unique ID, not null
Outputs this zone as a String
, using the ID.
Outputs this zone as a String
, using the ID.
a string representation of this time-zone ID, not null
A geographical region where the same time-zone rules apply.
Time-zone information is categorized as a set of rules defining when and how the offset from UTC/Greenwich changes. These rules are accessed using identifiers based on geographical regions, such as countries or states. The most common region classification is the Time Zone Database (TZDB), which defines regions such as 'Europe/Paris' and 'Asia/Tokyo'.
The region identifier, modeled by this class, is distinct from the underlying rules, modeled by
ZoneRules
. The rules are defined by governments and change frequently. By contrast, the region identifier is well-defined and long-lived. This separation also allows rules to be shared between regions if appropriate.Specification for implementors
This class is immutable and thread-safe.