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 net6.0, net8.0, netstandard2.0
Inheritance
object
Exception
SystemException
ArgumentException
ArgumentOutOfRangeException
AmbiguousTimeException
Implements
Inherited Members
Namespace: NodaTime
Assembly: NodaTime.dll
Syntax
public sealed class AmbiguousTimeException : ArgumentOutOfRangeException, 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 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 net6.0, net8.0, netstandard2.0
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

Gets the earlier of the two occurrences of the local date and time within the time zone.
Since 1.0.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public ZonedDateTime EarlierMapping { get; }
Property Value
Type Description
ZonedDateTime The earlier of the two occurrences of the local date and time within the time zone.

LaterMapping

Gets the later of the two occurrences of the local date and time within the time zone.
Since 1.0.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public ZonedDateTime LaterMapping { get; }
Property Value
Type Description
ZonedDateTime The later of the two occurrences of the local date and time within the time zone.

Zone

The time zone in which the local date and time is ambiguous.
Since 1.0.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public DateTimeZone Zone { get; }
Property Value
Type Description
DateTimeZone The time zone in which the local date and time is ambiguous.

Implements