Class TimeZones

java.lang.Object

org.apache.commons.lang3.time.TimeZones

public class TimeZones
extends Object

Helps work with TimeZones.

Since:

3.7

Field Summary

Fields

Modifier and Type	Field	Description
static final TimeZone	GMT	The GMT time zone.
static final String	GMT_ID	A public version of TimeZone's package private GMT_ID field.

Method Summary

Modifier and Type	Method	Description
static TimeZone	getTimeZone(String id)	Gets the time zone using TimeZone.getTimeZone(String).
static TimeZone	toTimeZone(TimeZone timeZone)	Returns the given TimeZone if non-null, otherwise TimeZone.getDefault().

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

GMT_ID

public static final String GMT_ID

A public version of TimeZone's package private GMT_ID field.

See Also:

• Constant Field Values

GMT

public static final TimeZone GMT

The GMT time zone.

Since:

3.13.0

Method Details

getTimeZone

public static TimeZone getTimeZone(String id)

Gets the time zone using TimeZone.getTimeZone(String). On Java 25 and later, maps IDs found in ZoneId.SHORT_IDS.

On Java 25, calling TimeZone.getTimeZone(String) with an ID in ZoneId.SHORT_IDS writes a message to System.err in the form:

WARNING: Use of the three-letter time zone ID "the-short-id" is deprecated and it will be removed in a future release

You can disable mapping from ZoneId.SHORT_IDS by setting the system property "TimeZones.mapShortIDs=false".

Parameters:

id - Same as TimeZone.getTimeZone(String).

Returns:

Same as TimeZone.getTimeZone(String).

Since:

3.20.0

toTimeZone

public static TimeZone toTimeZone(TimeZone timeZone)

Returns the given TimeZone if non-null, otherwise TimeZone.getDefault().

Parameters:

timeZone - A locale or null.

Returns:

The given locale if non-null, otherwise TimeZone.getDefault().

Since:

3.13.0