FastTimeZone¶

public class org.apache.commons.lang3.time.FastTimeZone[source]¶

Faster methods to produce custom time zones.

Since:: 3.7

Methods¶

`getGmtTimeZone()`	Gets the GMT TimeZone.
`getGmtTimeZone(String)`	Gets a TimeZone with GMT offsets.
`getTimeZone(String)`	Gets a TimeZone, looking first for GMT custom ids, then falling back to Olson ids.

public static TimeZone getGmtTimeZone()[source]¶

Gets the GMT TimeZone.

Returns:: A TimeZone with a raw offset of zero.

public static TimeZone getGmtTimeZone(String pattern)[source]¶

Gets a TimeZone with GMT offsets. A GMT offset must be either ‘Z’, or ‘UTC’, or match (GMT)? hh?(:?mm?)?, where h and m are digits representing hours and minutes.

Note: the underlying regex is lenient — every capture group (sign, hours, minutes, and the GMT prefix) is optional. Inputs that lack any digit group, such as the empty string, "+", "-", or "GMT" alone, still match and the method returns the GMT TimeZone with a raw offset of zero (mirroring TimeZone#getTimeZone(String) JDK-parity for unrecognized ids). Inputs that fail the regex outright, or that match but specify an out-of-range offset (24 hours or 60 minutes and above), return null.

Parameters:: pattern – The GMT offset.
Returns:: A TimeZone matching the (possibly partial or empty) GMT offset pattern, defaulting to GMT for an unrecognized but parseable input, or null if the pattern fails the regex or specifies an out-of-range offset.

public static TimeZone getTimeZone(String id)[source]¶

Gets a TimeZone, looking first for GMT custom ids, then falling back to Olson ids. A GMT custom id can be ‘Z’, or ‘UTC’, or has an optional prefix of GMT, followed by sign, hours digit(s), optional colon(‘:’), and optional minutes digits. i.e. [GMT] (+|-) Hours [[:] Minutes]

Parameters:: id – A GMT custom id or Olson id.
Returns:: A time zone.