Package org.joda.time

Class IllegalInstantException

  • All Implemented Interfaces:
    java.io.Serializable
    public class IllegalInstantException
extends java.lang.IllegalArgumentException
    Exception thrown when attempting to create an instant or date-time that cannot exist.

    Classes like DateTime only store valid date-times. One of the cases where validity is important is handling daylight savings time (DST). In many places DST is used, where the local clock moves forward by an hour in spring and back by an hour in autumn/fall. This means that in spring, there is a "gap" where a local time does not exist.

    This exception refers to this gap, and it means that your application tried to create a date-time inside the gap - a time that did not exist. Since Joda-Time objects must be valid, this is not allowed.

    Possible solutions may be as follows:
    Use LocalDateTime, as all local date-times are valid.
    When converting a LocalDate to a DateTime, then use toDateTimeAsStartOfDay() as this handles and manages any gaps.
    When parsing, use parseLocalDateTime() if the string being parsed has no time-zone.

    Since:
    2.2
    See Also:
    Serialized Form

    • Field Summary

      Fields 
      Modifier and Type Field Description
      private static long serialVersionUID
      Serialization lock.

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      private static java.lang.String createMessage​(long instantLocal, java.lang.String zoneId)  
      static boolean isIllegalInstant​(java.lang.Throwable ex)
      Checks if the exception is, or has a cause, of IllegalInstantException.

      • Methods inherited from class java.lang.Throwable

        addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

      • Methods inherited from class java.lang.Object

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

    • Field Detail

      • serialVersionUID

        private static final long serialVersionUID
        Serialization lock.
        See Also:
        Constant Field Values

    • Constructor Detail

      • IllegalInstantException

        public IllegalInstantException​(java.lang.String message)
        Constructor.
        Parameters:
        message - the message

      • IllegalInstantException

        public IllegalInstantException​(long instantLocal,
                               java.lang.String zoneId)
        Constructor.
        Parameters:
        instantLocal - the local instant
        zoneId - the time-zone ID, may be null

    • Method Detail

      • createMessage

        private static java.lang.String createMessage​(long instantLocal,
                                              java.lang.String zoneId)

      • isIllegalInstant

        public static boolean isIllegalInstant​(java.lang.Throwable ex)
        Checks if the exception is, or has a cause, of IllegalInstantException.
        Parameters:
        ex - the exception to check
        Returns:
        true if an IllegalInstantException