java/time/ZoneId.java

91  * A {@code ZoneId} is used to identify the rules used to convert between
101  * Calling {@link #normalized()} on any {@code ZoneId} will ensure that a
109  * The distinction has other effects. Serializing the {@code ZoneId} will only send
155  * A {@code ZoneId} can be deserialized in a Java Runtime where the ID is unknown.
157  * the client-side Java Runtime has not been updated. In this case, the {@code ZoneId}
168  * {@code ZoneId} may have unpredictable results and should be avoided.
178 public abstract class ZoneId implements Serializable {
264      * and converts it to a {@code ZoneId}. If the system default time-zone is changed,
271     public static ZoneId systemDefault() {
280      * The ID can be passed to {@link #of(String)} to create a {@code ZoneId}.
293      * Obtains an instance of {@code ZoneId} using its ID using a map
308     public static ZoneId of(String zoneId, Map<String, String> aliasMap) {
316      * Obtains an instance of {@code ZoneId} from an ID ensuring that the
319      * This method parses the ID producing a {@code ZoneId} or {@code ZoneOffset}.
330      * <li>If the zone ID equals 'GMT', 'UTC' or 'UT' then the result is a {@code ZoneId}
336      *  The result will be a {@code ZoneId} with the specified UTC/GMT/UT prefix
338      *  The rules of the returned {@code ZoneId} will be equivalent to the
355     public static ZoneId of(String zoneId) {
360      * Obtains an instance of {@code ZoneId} wrapping an offset.
362      * If the prefix is "GMT", "UTC", or "UT" a {@code ZoneId}
372     public static ZoneId ofOffset(String prefix, ZoneOffset offset) {
399     static ZoneId of(String zoneId, boolean checkAvailable) {
419     private static ZoneId ofWithPrefix(String zoneId, int prefixLength, boolean checkAvailable) {
434             throw new DateTimeException("Invalid ID for offset-based ZoneId: " + zoneId, ex);
440      * Obtains an instance of {@code ZoneId} from a temporal object.
444      * which this factory converts to an instance of {@code ZoneId}.
447      * This factory converts the arbitrary temporal object to an instance of {@code ZoneId}.
453      * allowing it to be used as a query via method reference, {@code ZoneId::from}.
457      * @throws DateTimeException if unable to convert to a {@code ZoneId}
459     public static ZoneId from(TemporalAccessor temporal) {
460         ZoneId obj = temporal.query(TemporalQueries.zone());
462             throw new DateTimeException("Unable to obtain ZoneId from TemporalAccessor: " +
472     ZoneId() {
511      * A {@code ZoneId} can be fully represented as a {@code TemporalAccessor}.
513      * methods on the interface have no meaning to {@code ZoneId}.
534                     return (R) ZoneId.this;
567      * The returns a normalized {@code ZoneId} that can be used in place of this ID.
571      * The normalization checks if the rules of this {@code ZoneId} have a fixed offset.
577     public ZoneId normalized() {
603         if (obj instanceof ZoneId) {
604             ZoneId other = (ZoneId) obj;
647      *  out.writeByte(7);  // identifies a ZoneId (not ZoneOffset)
651      * When read back in, the {@code ZoneId} will be created as though using