Class SkippedTimeException

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

Since 1.0.x

Availability net35-Client, PCL

Inheritance

Object

Exception

SystemException

ArgumentException

ArgumentOutOfRangeException

SkippedTimeException

Implements

_Exception

ISerializable

Inherited Members

ArgumentOutOfRangeException.GetObjectData(SerializationInfo, StreamingContext)

ArgumentOutOfRangeException.Message

ArgumentOutOfRangeException.ActualValue

ArgumentException.ParamName

Exception.GetBaseException()

Exception.ToString()

Exception.GetType()

Exception.Data

Exception.InnerException

Exception.TargetSite

Exception.StackTrace

Exception.HelpLink

Exception.Source

Exception.HResult

Object.Equals(Object)

Object.Equals(Object, Object)

Object.ReferenceEquals(Object, Object)

Object.GetHashCode()

Object.MemberwiseClone()

Namespace: NodaTime

Assembly: NodaTime.dll

Syntax

[Serializable]
public sealed class SkippedTimeException : ArgumentOutOfRangeException, _Exception, ISerializable

Remarks

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 System.ArgumentOutOfRangeException 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.)

Constructors

SkippedTimeException(LocalDateTime, DateTimeZone)

Creates a new instance for the given local date/time and time zone.

Since 1.0.x

Availability net35-Client, PCL

Declaration

public SkippedTimeException(LocalDateTime localDateTime, DateTimeZone zone)

Parameters

Type	Name	Description
LocalDateTime	localDateTime	The local date/time which is skipped in the specified time zone.
DateTimeZone	zone	The time zone in which the local date/time does not exist.

Remarks

User code is unlikely to need to deliberately call this constructor except possibly for testing.

Properties

LocalDateTime

The local date/time which is invalid in the time zone

Since 1.0.x

Availability net35-Client, PCL

Declaration

public LocalDateTime LocalDateTime { get; }

Property Value

Type	Description
LocalDateTime

Zone

The time zone in which the local date/time is invalid

Since 1.0.x

Availability net35-Client, PCL

Declaration

public DateTimeZone Zone { get; }

Property Value

Type	Description
DateTimeZone

Implements

System.Runtime.InteropServices._Exception

System.Runtime.Serialization.ISerializable