Class FastTimeZone


  • public class FastTimeZone
    extends java.lang.Object
    Faster methods to produce custom time zones.
    Since:
    3.7
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.util.TimeZone getGmtTimeZone()
      Gets the GMT TimeZone.
      static java.util.TimeZone getGmtTimeZone​(java.lang.String pattern)
      Gets a TimeZone with GMT offsets.
      static java.util.TimeZone getTimeZone​(java.lang.String id)
      Gets a TimeZone, looking first for GMT custom ids, then falling back to Olson ids.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • getGmtTimeZone

        public static java.util.TimeZone getGmtTimeZone()
        Gets the GMT TimeZone.
        Returns:
        A TimeZone with a raw offset of zero.
      • getGmtTimeZone

        public static java.util.TimeZone getGmtTimeZone​(java.lang.String pattern)
        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.
      • getTimeZone

        public static java.util.TimeZone getTimeZone​(java.lang.String id)
        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.