Class IllegalInstantException
- All Implemented Interfaces:
Serializable
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:
-
Constructor Summary
ConstructorsConstructorDescriptionIllegalInstantException
(long instantLocal, String zoneId) Constructor.IllegalInstantException
(String message) Constructor. -
Method Summary
Modifier and TypeMethodDescriptionstatic boolean
Checks if the exception is, or has a cause, ofIllegalInstantException
.Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Constructor Details
-
IllegalInstantException
Constructor.- Parameters:
message
- the message
-
IllegalInstantException
Constructor.- Parameters:
instantLocal
- the local instantzoneId
- the time-zone ID, may be null
-
-
Method Details
-
isIllegalInstant
Checks if the exception is, or has a cause, ofIllegalInstantException
.- Parameters:
ex
- the exception to check- Returns:
- true if an
IllegalInstantException
-