Teilen über


TimeZoneInfo.IsInvalidTime(DateTime) Methode

Definition

Gibt an, ob ein bestimmtes Datum und eine Zeit ungültig sind.

public:
 bool IsInvalidTime(DateTime dateTime);
public bool IsInvalidTime (DateTime dateTime);
member this.IsInvalidTime : DateTime -> bool
Public Function IsInvalidTime (dateTime As DateTime) As Boolean

Parameter

dateTime
DateTime

Ein Datums- und Uhrzeitwert.

Gibt zurück

Boolean

true, wenn dateTime ungültig ist, andernfalls false.

Beispiele

In der Pazifischen Zeitzone beginnt die Sommerzeit um 2:00 Uhr. am 2. April 2006. Der folgende Code übergibt die Zeit in Intervallen von 1:59 Uhr. am 2. April 2006 bis 3:01 Uhr. am 2. April 2006 an die Methode eines TimeZoneInfo Objekts, das die IsInvalidTime Pazifische Zeitzone darstellt. Die Konsolenausgabe gibt an, dass alle Zeiten von 2:00 A.M. am 2. April 2006 bis 2:59 A.M. am 2. April 2006 sind ungültig.

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

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

// List possible invalid times for a 63-minute interval, from 1:59 AM to 3: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 invalid: {1}", newTime, pstZone.IsInvalidTime(newTime));
}
// Specify DateTimeKind in Date constructor
let baseTime = DateTime(2007, 3, 11, 1, 59, 0, DateTimeKind.Unspecified)

// Get Pacific Standard Time zone
let pstZone = TimeZoneInfo.FindSystemTimeZoneById "Pacific Standard Time"

// List possible invalid times for a 63-minute interval, from 1:59 AM to 3:01 AM
for i = 0 to 62 do
    // Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
    let newTime = baseTime.AddMinutes i
    printfn $"{newTime} is invalid: {pstZone.IsInvalidTime newTime}"
' Specify DateTimeKind in Date constructor
Dim baseTime As New Date(2007, 3, 11, 1, 59, 0, DateTimeKind.Unspecified)
Dim newTime As Date

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

' List possible invalid times for 63-minute interval, from 1:59 AM to 3: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 invalid: {1}", newTime, pstZone.IsInvalidTime(newTime))
Next

Hinweise

Eine ungültige Uhrzeit fällt innerhalb eines Zeitraums für die aktuelle Zeitzone, die aufgrund der Anwendung einer Anpassungsregel nicht koordinierte Weltzeit (UTC) zugeordnet werden kann. In der Regel treten ungültige Zeiten auf, wenn die Zeit für die Sommerzeit voranschreitet. Eine Abbildung finden Sie im Abschnitt "Beispiel".

Der Wert der Kind Eigenschaft des dateTime Parameters wirkt sich darauf aus, ob dateTime eine ungültige Uhrzeit dargestellt wird, wie in der folgenden Tabelle dargestellt.

DateTime.Kind-Eigenschaft TimeZoneInfo-Objekt (sofern zutreffend) Verhalten
DateTimeKind.Local TimeZoneInfo.Local Bestimmt, ob die Uhrzeit ungültig ist.
DateTimeKind.Local TimeZoneInfo.Utc oder eine nicht lokale Zeitzone. dateTime Konvertiert in die Zeit des TimeZoneInfo Objekts und gibt zurückfalse.
DateTimeKind.Unspecified Nicht zutreffend Angenommen dateTime , die Zeit des TimeZoneInfo Objekts und bestimmt, ob es ungültig ist.
DateTimeKind.Utc Nicht zutreffend Gibt falsezurück.

Gilt für

Siehe auch