TimeZoneInfo::GetAmbiguousTimeOffsets Method (DateTime)
Returns information about the possible dates and times that an ambiguous date and time can be mapped to.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- dateTime
- Type: System::DateTime
A date and time.
Return Value
Type: array<System::TimeSpan>An array of objects that represents possible Coordinated Universal Time (UTC) offsets that a particular date and time can be mapped to.
| Exception | Condition |
|---|---|
| ArgumentException | dateTime is not an ambiguous time. |
The precise behavior of this method depends on the relationship between the Kind property and the TimeZoneInfo object, as the following table shows.
TimeZoneInfo object type | Kind property value | Behavior |
|---|---|---|
DateTimeKind::Local or DateTimeKind::Unspecified | Returns ambiguous time offsets for dateTime. | |
DateTimeKind::Utc | Converts dateTime to the local time, and then returns ambiguous time offsets for that time. | |
Any value. | Throws an ArgumentException. | |
Any other time zone. | Local or DateTimeKind::Utc | Converts dateTime to the specified time zone, and then determines whether that time is ambiguous. |
Any other time zone. | Determines whether dateTime is ambiguous in the specified time zone. |
The order of TimeSpan objects in the array returned by this method is undefined. However, you can determine which element represents an offset from the time zone's standard time by comparing its value with the time zone's BaseUtcOffset property. To map an ambiguous time to a time zone's standard time, see How to: Resolve Ambiguous Times.
Notes to CallersOn Windows XP systems, this method applies only the current adjustment rule when determining whether dateTime is ambiguous if the current instance is TimeZoneInfo::Local. As a result, the method may not accurately report ambiguous time offsets for periods before the current adjustment rule came into effect. For more information, see the Notes for Callers section in the Local property.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.