Package org.joda.time

Class IllegalInstantException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

java.lang.IllegalArgumentException

org.joda.time.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

Author:

Stephen Colebourne

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
IllegalInstantException(long instantLocal, java.lang.String zoneId)	Constructor.
IllegalInstantException(java.lang.String message)	Constructor.

Method Summary

Modifier and Type	Method	Description
static boolean	isIllegalInstant(java.lang.Throwable ex)	Checks if the exception is, or has a cause, of IllegalInstantException.

Methods inherited from class java.lang.Object

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

Methods inherited from class java.lang.Throwable

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

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

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