net.time4j.tz

Interface TZID

All Known Implementing Classes:

ZonalOffset

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 in instance of type ZonalOffset, especially if the timezone offset for a given timepoint is already known.

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.

Author:

Meno Hochschild

Method Summary

Methods

Modifier and Type	Method and Description
String	canonical() Represents the full canonical name of a timezone (for example "Europe/Paris" or "UTC+01:00").

Method Detail

canonical

String canonical()

Represents the full canonical name of a timezone (for example "Europe/Paris" or "UTC+01:00").

Returns:

String in TZDB format (Olson-ID) or in offset format