Noda Time
Show / Hide Table of Contents

Class AmbiguousTimeException

Exception thrown to indicate that the specified local date/time occurs twice in a particular time zone due to daylight saving time changes.
Since 1.0.x
Availability net35-Client
Inheritance
Object
Exception
SystemException
ArgumentException
ArgumentOutOfRangeException
AmbiguousTimeException
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 AmbiguousTimeException : ArgumentOutOfRangeException, _Exception, ISerializable
Remarks

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

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.

In theory this isn't calendar-specific; the local value will be ambiguous in this time zone regardless of the calendar used. However, this exception is always created in conjunction with a specific calendar, which leads to a more natural way of examining its information and constructing an error message.

Constructors

AmbiguousTimeException(ZonedDateTime, ZonedDateTime)

Constructs an instance from the given information.
Since 1.0.x
Availability net35-Client
Declaration
public AmbiguousTimeException(ZonedDateTime earlierMapping, ZonedDateTime laterMapping)
Parameters
Type Name Description
ZonedDateTime earlierMapping The earlier possible mapping
ZonedDateTime laterMapping The later possible mapping
Remarks

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

The two mappings must have the same local time and time zone.

Properties

EarlierMapping

The earlier of the two occurrences of the local date and time within the time zone.
Since 1.0.x
Availability net35-Client
Declaration
public ZonedDateTime EarlierMapping { get; }
Property Value
Type Description
ZonedDateTime

LaterMapping

The later of the two occurrences of the local date and time within the time zone.
Since 1.0.x
Availability net35-Client
Declaration
public ZonedDateTime LaterMapping { get; }
Property Value
Type Description
ZonedDateTime

Zone

The time zone in which the local date and time is ambiguous.
Since 1.0.x
Availability net35-Client
Declaration
public DateTimeZone Zone { get; }
Property Value
Type Description
DateTimeZone

Implements

System.Runtime.InteropServices._Exception
System.Runtime.Serialization.ISerializable
In this article
Back to top Generated by DocFX