Class InitialTimeZoneRule

  • All Implemented Interfaces:
    Serializable

    public class InitialTimeZoneRule
    extends TimeZoneRule
    InitialTimeZoneRule represents a time zone rule representing a time zone effective from the beginning and has no actual start times.
    See Also:
    Serialized Form
    • Constructor Detail

      • InitialTimeZoneRule

        public InitialTimeZoneRule​(String name,
                                   int rawOffset,
                                   int dstSavings)
        Constructs a InitialTimeZoneRule with the name, the GMT offset of its standard time and the amount of daylight saving offset adjustment.
        Parameters:
        name - The time zone name.
        rawOffset - The UTC offset of its standard time in milliseconds.
        dstSavings - The amount of daylight saving offset adjustment in milliseconds. If this ia a rule for standard time, the value of this argument is 0.
    • Method Detail

      • isEquivalentTo

        public boolean isEquivalentTo​(TimeZoneRule other)
        Returns if this rule represents the same rule and offsets as another. When two TimeZoneRule objects differ only its names, this method returns true.
        Overrides:
        isEquivalentTo in class TimeZoneRule
        Parameters:
        other - The TimeZoneRule object to be compared with.
        Returns:
        true if the other TimeZoneRule is the same as this one.
      • getFinalStart

        public Date getFinalStart​(int prevRawOffset,
                                  int prevDSTSavings)
        Gets the final time when this rule takes effect.

        Note: This method in InitialTimeZoneRule always returns null.
        Specified by:
        getFinalStart in class TimeZoneRule
        Parameters:
        prevRawOffset - The standard time offset from UTC before this rule takes effect in milliseconds.
        prevDSTSavings - The amount of daylight saving offset from the standard time.
        Returns:
        The very last time when this rule takes effect, or null if this rule is applied for future dates infinitely.
      • getFirstStart

        public Date getFirstStart​(int prevRawOffset,
                                  int prevDSTSavings)
        Gets the very first time when this rule takes effect.

        Note: This method in InitialTimeZoneRule always returns null.
        Specified by:
        getFirstStart in class TimeZoneRule
        Parameters:
        prevRawOffset - The standard time offset from UTC before this rule takes effect in milliseconds.
        prevDSTSavings - The amount of daylight saving offset from the standard time.
        Returns:
        The very first time when this rule takes effect.
      • getNextStart

        public Date getNextStart​(long base,
                                 int prevRawOffset,
                                 int prevDSTSavings,
                                 boolean inclusive)
        Gets the first time when this rule takes effect after the specified time.

        Note: This method in InitialTimeZoneRule always returns null.
        Specified by:
        getNextStart in class TimeZoneRule
        Parameters:
        base - The first time after this time is returned.
        prevRawOffset - The standard time offset from UTC before this rule takes effect in milliseconds.
        prevDSTSavings - The amount of daylight saving offset from the standard time.
        inclusive - Whether the base time is inclusive or not.
        Returns:
        The first time when this rule takes effect after the specified time, or null when this rule never takes effect after the specified time.
      • getPreviousStart

        public Date getPreviousStart​(long base,
                                     int prevRawOffset,
                                     int prevDSTSavings,
                                     boolean inclusive)
        Gets the most recent time when this rule takes effect before the specified time.

        Note: This method in InitialTimeZoneRule always returns null.
        Specified by:
        getPreviousStart in class TimeZoneRule
        Parameters:
        base - The most recent time when this rule takes effect before this time is returned.
        prevRawOffset - The standard time offset from UTC before this rule takes effect in milliseconds.
        prevDSTSavings - The amount of daylight saving offset from the standard time.
        inclusive - Whether the base time is inclusive or not.
        Returns:
        The most recent time when this rule takes effect before the specified time, or null when this rule never takes effect before the specified time.
      • isTransitionRule

        public boolean isTransitionRule()
        Returns if this TimeZoneRule has one or more start times.

        Note: This method in InitialTimeZoneRule always returns false.
        Specified by:
        isTransitionRule in class TimeZoneRule
        Returns:
        true if this TimeZoneRule has one or more start times.