TimeZoneInfo.IsInvalidTime(DateTime) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

TimeZoneInfo.cs

Belirli bir tarih ve saatin geçersiz olup olmadığını gösterir.

public:
 bool IsInvalidTime(DateTime dateTime);

public bool IsInvalidTime(DateTime dateTime);

member this.IsInvalidTime : DateTime -> bool

Public Function IsInvalidTime (dateTime As DateTime) As Boolean

Parametreler

dateTime

DateTime

Tarih ve saat değeri.

Döndürülenler

Boolean

true geçersizse dateTime ; değilse, false.

Örnekler

Pasifik Saat diliminde yaz saati 2 Nisan 2006'da saat 02:00'de başlar. Aşağıdaki kod, saati 2 Nisan 2006'da 01:59'dan 2 Nisan 2006'da 03:01'e kadar bir dakikalık aralıklarla Pasifik Saat dilimini temsil eden bir TimeZoneInfo nesnenin yöntemine IsInvalidTime geçirir. Konsol çıkışı, 2 Nisan 2006'da saat 02:00'den 02:59'a kadar olan tüm zamanların 2 Nisan 2006'da geçersiz olduğunu gösterir.

// 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

Açıklamalar

Geçersiz bir saat, geçerli saat dilimi için bir ayarlama kuralının uygulanması nedeniyle Eşgüdümlü Evrensel Saat (UTC) ile eşlenemeyen süre aralığına denk gelir. Genellikle, gün ışığından yararlanma saati için saat ileriye doğru ilerlerken geçersiz saatler oluşur. Çizim için Örnek bölümüne bakın.

Parametresinin Kind özelliğinin dateTime değeri, aşağıdaki tabloda gösterildiği gibi geçersiz bir saati temsil edip etmediğini dateTime etkiler.

DateTime.Kind özelliği	TimeZoneInfo nesnesi (varsa)	Davranış
DateTimeKind.Local	TimeZoneInfo.Local	Saatin geçersiz olup olmadığını belirler.
DateTimeKind.Local	TimeZoneInfo.Utc veya yerel olmayan bir saat dilimini seçin.	dateTime nesnesinin zamanına TimeZoneInfo dönüştürür ve döndürürfalse.
DateTimeKind.Unspecified	Uygulanamaz.	dateTime Nesnenin zamanı olduğunu varsayar ve nesnenin TimeZoneInfo geçersiz olup olmadığını belirler.
DateTimeKind.Utc	Uygulanamaz.	false döndürür.

Ayrıca bkz.

• IsAmbiguousTime