public interface TZID
Identifies a timezone.
In most cases, the timezone ID has the Olson-format
"{region}/{city}" or is an offset in the format
"UTC±hh:mm". In latter case applications can
instead directly use an instance of type ZonalOffset,
especially if the timezone offset for a given timepoint is
already known.
Provider-specific keys have the
name of the provider followed by the
separator char "~" and the normal canonical identifier. This
form can be used if a custom registered ZoneProvider shall be
used instead of the default provider for lookup of the zonal data. For
example following key will search the timezone data via the API of
java.util.TimeZone even if there is configured another default
zone provider: "java.util.TimeZone~Europe/Berlin"
Lexical comparisons of IDs should always be done by the method
canonical() because an object of type TZID is only
designed for encapsulating a canonical name. The comparison
using the method equals() is not allowed.
If a timezone offset is known for historical timezones before the year
1970 then users should generally prefer the class ZonalOffset because
the timezone data associated with the enum constants are not necessarily
correct.
Specification: All implementations must be immutable, thread-safe and serializable.
| Modifier and Type | Method and Description |
|---|---|
java.lang.String |
canonical()
Represents the full canonical name of a timezone (for
example "Europe/Paris" or "UTC+01:00").
|