TimeZoneInfo.IsAmbiguousTime Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Belirli bir saat dilimindeki belirli bir tarih ve saatin belirsiz olup olmadığını ve iki veya daha fazla Eşgüdümlü Evrensel Saat (UTC) saatine eşlenip eşlenemeyeceğini belirler.

Aşırı Yüklemeler

IsAmbiguousTime(DateTime)	Belirli bir saat dilimindeki belirli bir tarih ve saatin belirsiz olup olmadığını ve iki veya daha fazla Eşgüdümlü Evrensel Saat (UTC) saatine eşlenip eşlenemeyeceğini belirler.
IsAmbiguousTime(DateTimeOffset)	Belirli bir saat dilimindeki belirli bir tarih ve saatin belirsiz olup olmadığını ve iki veya daha fazla Eşgüdümlü Evrensel Saat (UTC) saatine eşlenip eşlenemeyeceğini belirler.

IsAmbiguousTime(DateTime)

Kaynak:

TimeZoneInfo.cs

Belirli bir saat dilimindeki belirli bir tarih ve saatin belirsiz olup olmadığını ve iki veya daha fazla Eşgüdümlü Evrensel Saat (UTC) saatine eşlenip eşlenemeyeceğini belirler.

public:
 bool IsAmbiguousTime(DateTime dateTime);

public bool IsAmbiguousTime (DateTime dateTime);

member this.IsAmbiguousTime : DateTime -> bool

Public Function IsAmbiguousTime (dateTime As DateTime) As Boolean

Parametreler

dateTime

DateTime

Tarih ve saat değeri.

Döndürülenler

Boolean

truedateTime parametresi belirsizse; değilse, false.

Özel durumlar

ArgumentException

Kind değerinin dateTime özelliği ve LocaldateTime geçersiz bir zamandır.

Örnekler

Pasifik Saat diliminde yaz saati 4 Kasım 2007'de saat 02:00'de sona erer. Aşağıdaki örnek, saati 4 Kasım 2007'de 12:59'dan 4 Kasım 2007'de 02:01'e kadar bir dakikalık aralıklarla Pasifik Saat dilimini temsil eden bir TimeZoneInfo nesnenin yöntemine IsAmbiguousTime(DateTime) geçirir. Konsol çıkışı, 4 Kasım 2007'de 01:00 ile 01:59 arasındaki tüm zamanların 4 Kasım 2007'de belirsiz olduğunu gösterir.

   // 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
let baseTime = DateTime(2007, 11, 4, 0, 59, 00, DateTimeKind.Unspecified)

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

// List possible ambiguous times for 63-minute interval, from 12:59 AM to 2: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 ambiguous: {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

Açıklamalar

Belirsiz bir zaman, geçerli saat dilimi için belirli bir zaman aralığı içindedir. Bu, standart bir zaman veya ayarlama kuralının uygulanmasından kaynaklanan bir zaman olabileceği anlamına gelir. Genellikle, belirsiz saatler, saatin yaz saati ile standart saate döndürülecek şekilde ayarlanmasıyla sonuçlanır. Çizim için Örnek bölümüne bakın.

Eşgüdümlü Evrensel Saat 'in (UTC) belirsiz zamanı yoktur; yaz saati desteği olmayan saat dilimleri de yok. Bu nedenle, bu saat dilimleri hiçbir ayarlama kuralına sahip değildir ve yöntemine IsAmbiguousTime yapılan çağrılar her zaman döndürür false.

Gün ışığından yararlanma saatini gözlemleyen saat dilimleri için bu yöntemin kesin davranışı, aşağıdaki tabloda gösterildiği gibi özellik ile TimeZoneInfo nesne arasındaki Kind ilişkiye bağlıdır.

TimeZoneInfo nesne türü	Kind özellik değeri	Davranış
TimeZoneInfo.Local	DateTimeKind.Local veya DateTimeKind.Unspecified	Parametresinin dateTime belirsiz olup olmadığını belirler.
TimeZoneInfo.Local	DateTimeKind.Utc	dateTime Yerel saate dönüştürür ve ardından bu saatin belirsiz olup olmadığını belirler.
TimeZoneInfo.Utc	DateTimeKind.Utc veya DateTimeKind.Unspecified	false döndürür.
TimeZoneInfo.Utc	DateTimeKind.Local	Belirsizse dateTime , bunun standart bir saat olduğunu varsayar, UTC'ye dönüştürür ve döndürür false.
Başka bir saat dilimi.	DateTimeKind.Local veya DateTimeKind.Utc	dateTime Belirtilen saat dilimindeki saate dönüştürür ve ardından bu saatin belirsiz olup olmadığını belirler.
Başka bir saat dilimi.	DateTimeKind.Unspecified	Belirsiz olup olmadığını dateTime belirler.

Ayrıca bkz.

• IsInvalidTime(DateTime)

IsAmbiguousTime(DateTimeOffset)

Kaynak:

TimeZoneInfo.cs

Belirli bir saat dilimindeki belirli bir tarih ve saatin belirsiz olup olmadığını ve iki veya daha fazla Eşgüdümlü Evrensel Saat (UTC) saatine eşlenip eşlenemeyeceğini belirler.

public:
 bool IsAmbiguousTime(DateTimeOffset dateTimeOffset);

public bool IsAmbiguousTime (DateTimeOffset dateTimeOffset);

member this.IsAmbiguousTime : DateTimeOffset -> bool

Public Function IsAmbiguousTime (dateTimeOffset As DateTimeOffset) As Boolean

Parametreler

dateTimeOffset

DateTimeOffset

Tarih ve saat.

Döndürülenler

Boolean

truedateTimeOffset parametresi geçerli saat diliminde belirsizse; değilse, false.

Açıklamalar

Belirsiz bir zaman, geçerli saat dilimi için belirli bir zaman aralığı içindedir. Bu, standart bir zaman veya bir ayarlama kuralının uygulanmasından kaynaklanan bir zaman olabileceği anlamına gelir. Genellikle, belirsiz saatler, saatin yaz saati ile standart saate döndürülecek şekilde ayarlanmasıyla sonuçlanır. Eşgüdümlü Evrensel Saat 'in (UTC) belirsiz zamanı yoktur; yaz saati desteği olmayan saat dilimleri de yok.

Yönteminin kesin davranışı, parametresinin özelliği dateTimeOffset ile geçerli saat dilimi arasındaki Offset ilişkiye bağlıdır. Özelliğin Offset değeri geçerli saat diliminin UTC'sinden olası bir uzaklıksa, yöntem bu tarih ve saatin belirsiz olup olmadığını belirler. Aksi takdirde, geçerli saat dilimindeki saate dönüştürür dateTimeOffset ve ardından bu tarih ve saatin belirsiz olup olmadığını belirler.