TimeZoneInfo.IsAmbiguousTime TimeZoneInfo.IsAmbiguousTime TimeZoneInfo.IsAmbiguousTime Method

Definition

Bestimmt, ob ein bestimmtes Datum und eine Uhrzeit in einer bestimmten Zeitzone mehrdeutig sind und zwei oder mehreren UTC-Zeiten (Coordinated Universal Time) zugeordnet werden können.Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

Überlädt

IsAmbiguousTime(DateTime) IsAmbiguousTime(DateTime) IsAmbiguousTime(DateTime)

Bestimmt, ob ein bestimmtes Datum und eine Uhrzeit in einer bestimmten Zeitzone mehrdeutig sind und zwei oder mehreren UTC-Zeiten (Coordinated Universal Time) zugeordnet werden können.Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

IsAmbiguousTime(DateTimeOffset) IsAmbiguousTime(DateTimeOffset) IsAmbiguousTime(DateTimeOffset)

Bestimmt, ob ein bestimmtes Datum und eine Uhrzeit in einer bestimmten Zeitzone mehrdeutig sind und zwei oder mehreren UTC-Zeiten (Coordinated Universal Time) zugeordnet werden können.Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

IsAmbiguousTime(DateTime) IsAmbiguousTime(DateTime) IsAmbiguousTime(DateTime)

Bestimmt, ob ein bestimmtes Datum und eine Uhrzeit in einer bestimmten Zeitzone mehrdeutig sind und zwei oder mehreren UTC-Zeiten (Coordinated Universal Time) zugeordnet werden können.Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

public:
 bool IsAmbiguousTime(DateTime dateTime);
public bool IsAmbiguousTime (DateTime dateTime);
member this.IsAmbiguousTime : DateTime -> bool

Parameter

dateTime
DateTime DateTime DateTime

Ein Datums- und Uhrzeitwert.A date and time value.

Gibt zurück

true, wenn der dateTime-Parameter mehrdeutig ist, andernfalls false.true if the dateTime parameter is ambiguous; otherwise, false.

Ausnahmen

Die Kind-Eigenschaft des dateTime-Werts ist Local und dateTime ist eine ungültige Zeit.The Kind property of the dateTime value is Local and dateTime is an invalid time.

Beispiele

In der Zeitzone Pacific Time endet die Sommerzeit um 2:00 UhrIn the Pacific Time zone, daylight saving time ends at 2:00 A.M. am 4. November 2007.on November 4, 2007. Im folgende Beispiel wird die Zeit in Intervallen von einer Minute von 12:59 UhrThe following example passes the time at one-minute intervals from 12:59 A.M. am 4. November 2007, um 2:01 Uhron November 4, 2007, to 2:01 A.M. am 4. November 2007 um die IsAmbiguousTime(DateTime) -Methode der ein TimeZoneInfo Objekt, das die pazifischen Zeitzone darstellt.on November 4, 2007, to the IsAmbiguousTime(DateTime) method of a TimeZoneInfo object that represents the Pacific Time zone. Die Konsolenausgabe zeigt an, dass alle Zeitangaben von 1:00 UhrThe console output indicates that all times from 1:00 A.M. am 4. November 2007, um 1:59 Uhron November 4, 2007, to 1:59 A.M. sind am 4. November 2007 mehrdeutig.on November 4, 2007, are ambiguous.

// Specify DateTimeKind in Date constructor
DateTime baseTime = new DateTime(2007, 11, 4, 0, 59, 00, DateTimeKind.Unspecified);
DateTime newTime;

// Get Pacific Standard Time zone
TimeZoneInfo pstZone = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time");

// List possible ambiguous times for 63-minute interval, from 12:59 AM to 2:01 AM 
for (int ctr = 0; ctr < 63; ctr++)
{
   // Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
   newTime = baseTime.AddMinutes(ctr);   
   Console.WriteLine("{0} is ambiguous: {1}", newTime, pstZone.IsAmbiguousTime(newTime));
}
' Specify DateTimeKind in Date constructor
Dim baseTime As New Date(2007, 11, 4, 0, 59, 00, DateTimeKind.Unspecified)
Dim newTime As Date

' Get Pacific Standard Time zone
Dim pstZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time")

' List possible ambiguous times for 63-minute interval, from 12:59 AM to 2:01 AM 
For ctr As Integer = 0 To 62
   ' Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
   newTime = baseTime.AddMinutes(ctr)   
   Console.WriteLine("{0} is ambiguous: {1}", newTime, pstZone.IsAmbiguousTime(newTime))
Next

Hinweise

Eine mehrdeutige Zeit fällt in einen Zeitbereich für die aktuelle Zeitzone.An ambiguous time falls within a range of times for the current time zone. Dies bedeutet, dass es entweder auf Standardzeit oder auf eine Zeit, die von der Anwendung von einer Anpassungsregel führt sein kann.This means it can be either a standard time or a time that results from the application of an adjustment rule. Führen in der Regel mehrdeutige Zeiten auf, wenn die Uhr festgelegt ist, von Sommerzeit auf Standardzeit zurückgegeben.Typically, ambiguous times result when the clock is set to return to standard time from daylight saving time. Finden Sie im Abschnitt mit Beispielen veranschaulicht.See the Example section for an illustration.

Coordinated Universal Time (UTC) verfügt über keine mehrdeutigen Zeiten; Zeitpunkt, weder Zonen, die Sommerzeit nicht unterstützen.Coordinated Universal Time (UTC) has no ambiguous times; neither do time zones that do not support daylight saving time. Aus diesem Grund haben diese Zeitzonen, keine Regeln zur zeitzonenanpassung berücksichtigt und die Aufrufe der IsAmbiguousTime immer-Methodenrückgabe false.Therefore, these time zones have no adjustment rules and calls to the IsAmbiguousTime method always return false.

Für Zeitzonen das Sommerzeit berücksichtigt, hängt das genaue Verhalten dieser Methode die Beziehung zwischen der Kind Eigenschaft und die TimeZoneInfo -Objekts entsprechend der folgenden Tabelle gezeigt.For time zones that do observe daylight saving time, the precise behavior of this method depends on the relationship between the Kind property and the TimeZoneInfo object, as the following table shows.

Typ der TimeZoneInfo-ObjektsTimeZoneInfo object type Kind-Eigenschaft-WertKind property value VerhaltenBehavior
TimeZoneInfo.Local DateTimeKind.Local oder DateTimeKind.UnspecifiedDateTimeKind.Local or DateTimeKind.Unspecified Bestimmt, ob die dateTime -Parameter mehrdeutig ist.Determines whether the dateTime parameter is ambiguous.
TimeZoneInfo.Local DateTimeKind.Utc Konvertiert dateTime in die lokale Zeit und ermittelt dann, ob diese Zeit mehrdeutig ist.Converts dateTime to the local time and then determines whether that time is ambiguous.
TimeZoneInfo.Utc DateTimeKind.Utc oder DateTimeKind.UnspecifiedDateTimeKind.Utc or DateTimeKind.Unspecified Gibt false zurück.Returns false.
TimeZoneInfo.Utc DateTimeKind.Local Wenn dateTime ist mehrdeutig, es wird vorausgesetzt, es wird eine Standardzeit in UTC konvertiert und gibt false.If dateTime is ambiguous, assumes it is a standard time, converts it to UTC, and returns false.
Alle anderen Zeitzone.Any other time zone. DateTimeKind.Local oder DateTimeKind.UtcDateTimeKind.Local or DateTimeKind.Utc Konvertiert dateTime in die Zeit in die angegebene Zeitzone und ermittelt dann, ob diese Zeit mehrdeutig ist.Converts dateTime to the time in the specified time zone and then determines whether that time is ambiguous.
Alle anderen Zeitzone.Any other time zone. DateTimeKind.Unspecified Bestimmt, ob dateTime ist mehrdeutig.Determines whether dateTime is ambiguous.
Siehe auch

IsAmbiguousTime(DateTimeOffset) IsAmbiguousTime(DateTimeOffset) IsAmbiguousTime(DateTimeOffset)

Bestimmt, ob ein bestimmtes Datum und eine Uhrzeit in einer bestimmten Zeitzone mehrdeutig sind und zwei oder mehreren UTC-Zeiten (Coordinated Universal Time) zugeordnet werden können.Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

public:
 bool IsAmbiguousTime(DateTimeOffset dateTimeOffset);
public bool IsAmbiguousTime (DateTimeOffset dateTimeOffset);
member this.IsAmbiguousTime : DateTimeOffset -> bool

Parameter

dateTimeOffset
DateTimeOffset DateTimeOffset DateTimeOffset

Ein Datum und eine Uhrzeit.A date and time.

Gibt zurück

true, wenn der dateTimeOffset-Parameter in der aktuellen Zeitzone mehrdeutig ist, andernfalls false.true if the dateTimeOffset parameter is ambiguous in the current time zone; otherwise, false.

Hinweise

Eine mehrdeutige Zeit fällt in einen Zeitbereich für die aktuelle Zeitzone.An ambiguous time falls within a range of times for the current time zone. Dies bedeutet, dass es entweder auf Standardzeit oder auf eine Zeit, die von der Anwendung von einer Anpassungsregel führt sein kann.This means that it can be either a standard time or a time that results from the application of an adjustment rule. Führen in der Regel mehrdeutige Zeiten auf, wenn die Uhr festgelegt ist, von Sommerzeit auf Standardzeit zurückgegeben.Typically, ambiguous times result when the clock is set to return to standard time from daylight saving time. Coordinated Universal Time (UTC) verfügt über keine mehrdeutigen Zeiten; Zeitpunkt, weder Zonen, die Sommerzeit nicht unterstützen.Coordinated Universal Time (UTC) has no ambiguous times; neither do time zones that do not support daylight saving time.

Das genaue Verhalten der Methode hängt von die Beziehung zwischen der Offset Eigenschaft der dateTimeOffset Parameter und der aktuellen Zeitzone.The precise behavior of the method depends on the relationship between the Offset property of the dateTimeOffset parameter and the current time zone. Wenn der Wert des der Offset Eigenschaft handelt es sich um eine mögliche, die von der aktuellen Zeitzone UTC-offset, der Methode wird bestimmt, ob dieses Datum und Uhrzeit ist nicht eindeutig.If the value of the Offset property is a possible offset from the UTC of the current time zone, the method determines whether that date and time is ambiguous. Andernfalls konvertiert dateTimeOffset in die Zeit in der aktuellen Zeitzone und bestimmt dann, ob das Datum und Uhrzeit ist nicht eindeutig.Otherwise, it converts dateTimeOffset to the time in the current time zone, and then determines whether that date and time is ambiguous.

Gilt für: