AmbiguousTimeResolver Delegate

[This is preliminary documentation and is subject to change.]

Chooses between two ZonedDateTime values that resolve to the same LocalDateTime.

Declaration Syntax

Visual Basic

Visual C++

public delegate ZonedDateTime AmbiguousTimeResolver(
	ZonedDateTime earlier,
	ZonedDateTime later
)

Public Delegate Function AmbiguousTimeResolver ( _
	earlier As ZonedDateTime, _
	later As ZonedDateTime _
) As ZonedDateTime

public delegate ZonedDateTime AmbiguousTimeResolver(
	ZonedDateTime earlier, 
	ZonedDateTime later
)

Parameters

earlier (ZonedDateTime): The earlier of the ambiguous matches for the original local date and time

later (ZonedDateTime): The later of the ambiguous matches for the original local date and time

Return Value

A ZonedDateTime in the target time zone; typically, one of the two input parameters.

Remarks

This delegate is used by CreateMappingResolver(AmbiguousTimeResolver, SkippedTimeResolver) when handling an ambiguous local time, due to clocks moving backward in a time zone transition (usually due to an autumnal daylight saving transition).

The returned value should be one of the two parameter values, based on the policy of the specific implementation. Alternatively, it can throw an AmbiguousTimeException to implement a policy of "reject ambiguous times."

See the Resolvers class for predefined implementations.

Implementations of this delegate can reasonably assume that the target local date and time really is ambiguous; the behaviour when the local date and time can be unambiguously mapped into the target time zone (or when it's skipped) is undefined.

Exceptions

Exception	Condition
AmbiguousTimeException	The implementation rejects requests to map ambiguous times.

Assembly: NodaTime (Module: NodaTime.dll) Version: 1.2.0.0 (1.2.0)