TimeZoneInfo.IsInvalidTime(DateTime) Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

System.Core.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

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.

Siehe auch

• IsAmbiguousTime