net.time4j.tz.other

Class WindowsZone

java.lang.Object

net.time4j.tz.other.WindowsZone

All Implemented Interfaces:

Serializable, Comparable<WindowsZone>

public final class WindowsZone
extends Object
implements Comparable<WindowsZone>, Serializable

Represents a windows timezone name which can be mapped to an IANA/Olson-ID using a territory information.

Example:

  WindowsZone wzn = WindowsZone.of("Eastern Standard Time");
  TZID winzone = wzn.resolveSmart(Locale.US);
  System.out.println(winzone.canonical());
  // output: WINDOWS~America/New_York
 

Since:

2.2

Author:

Meno Hochschild

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
int	compareTo(WindowsZone other) The natural order is based on the lexicographical order of the underlying names of windows zones.
boolean	equals(Object obj)
static Set<String>	getAvailableNames() Yields all available names of windows zones.
int	hashCode()
static WindowsZone	of(String name) Creates a name reference to a windows zone.
Set<TZID>	resolve(Locale country) Resolves this name reference to a set of various zone ids for given country.
TZID	resolveSmart(Locale country) Resolves this name reference to at most one zone id for given country.
String	toString() Returns the name of this windows zone reference.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

getAvailableNames

public static Set<String> getAvailableNames()

Yields all available names of windows zones.

Returns:

unmodifiable set of zone names for Windows

Since:

2.3

of

public static WindowsZone of(String name)

Creates a name reference to a windows zone.

Parameters:

name - standardized windows zone name

Returns:

new instance of WindowsZone

Throws:

IllegalArgumentException - if given name is not supported

Since:

2.2

See Also:

getAvailableNames()

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Returns the name of this windows zone reference.

Overrides:

toString in class Object

Returns:

name of windows zone

compareTo

public int compareTo(WindowsZone other)

The natural order is based on the lexicographical order of the underlying names of windows zones.

Specified by:

compareTo in interface Comparable<WindowsZone>

Parameters:

other - another windows zone name reference

Returns:

a negative integer, zero, or a positive integer as this object is less than, equal to, or greater than the specified object.

resolve

public Set<TZID> resolve(Locale country)

Resolves this name reference to a set of various zone ids for given country.

Parameters:

country - country reference

Returns:

set of ids belonging to this windows zone

Since:

2.2

resolveSmart

public TZID resolveSmart(Locale country)

Resolves this name reference to at most one zone id for given country.

Normally windows zones cannot be resolved to one single zone id, but there is usually one preferred zone id based on the fact that the daylight saving rules for this name and given country are often the same for all belonging zone ids in the recent past. This method tries its best to yield a result but applications have to check if the result is null.

Parameters:

country - country reference

Returns:

preferred zone id belonging to this windows zone or null if given country is not related to this name

Since:

2.2