SkippedTimeError class

Exception thrown to indicate that the specified local time doesn't exist in a particular time zone due to daylight saving time changes.

This normally occurs for spring transitions, where the clock goes forward (usually by an hour). For example, suppose the time zone goes forward at 2am, so the second after 01:59:59 becomes 03:00:00. In that case, local times such as 02:30:00 never occur.

This exception is used to indicate such problems, as they're usually not the same as other RangeError causes, such as entering '15' for a month number.

Note that it is possible (though extremely rare) for a whole day to be skipped due to a time zone transition, so this exception may also be thrown in cases where no local time is valid for a particular local date. (For example, Samoa skipped December 30th 2011 entirely, transitioning from UTC-10 to UTC+14 at midnight.)

Inheritance

Constructors

SkippedTimeError(LocalDateTime localDateTime, DateTimeZone zone)
Creates a new instance for the given local date/time and time zone.

Properties

hashCode int
The hash code for this object.
no setterinherited
localDateTime LocalDateTime
Gets the local date/time which is invalid in the time zone, prompting this exception.
final
message String
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
stackTrace StackTrace?
The stack trace at the point where this error was first thrown.
no setterinherited
zone DateTimeZone
Gets the time zone in which the local date/time is invalid.
final

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() String
A string representation of this object.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited