TimeZoneInfo.IsDaylightSavingTime Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Belirtilen tarih ve saatin geçerli TimeZoneInfo nesnenin saat dilimi için gün ışığından yararlanma saati aralığında olup olmadığını gösterir.

Aşırı Yüklemeler

Name	Description
IsDaylightSavingTime(DateTime)	Belirtilen tarih ve saatin, geçerli TimeZoneInfo nesnenin saat dilimi için gün ışığından yararlanma saati aralığına girip düşmediğini gösterir.
IsDaylightSavingTime(DateTimeOffset)	Belirtilen tarih ve saatin, geçerli TimeZoneInfo nesnenin saat dilimi için gün ışığından yararlanma saati aralığına girip düşmediğini gösterir.

IsDaylightSavingTime(DateTime)

Kaynak:

TimeZoneInfo.cs

Belirtilen tarih ve saatin, geçerli TimeZoneInfo nesnenin saat dilimi için gün ışığından yararlanma saati aralığına girip düşmediğini gösterir.

public:
 bool IsDaylightSavingTime(DateTime dateTime);

public bool IsDaylightSavingTime(DateTime dateTime);

member this.IsDaylightSavingTime : DateTime -> bool

Public Function IsDaylightSavingTime (dateTime As DateTime) As Boolean

Parametreler

dateTime

DateTime

Tarih ve saat değeri.

Döndürülenler

Boolean

true parametresi gün ışığından dateTime yararlanma saatiyse; değilse, false.

Özel durumlar

ArgumentException

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

Örnekler

Aşağıdaki örnek, bir saat diliminin TimeZoneInfo.IsDaylightSavingTime standart saat adının mı yoksa yaz saati adının mı görüntüleneceğini belirlemek için yöntemini kullanan adlı DisplayDateWithTimeZoneName bir yöntemi tanımlar.

private void DisplayDateWithTimeZoneName(DateTime date1, TimeZoneInfo timeZone)
{
   Console.WriteLine("The time is {0:t} on {0:d} {1}", 
                     date1, 
                     timeZone.IsDaylightSavingTime(date1) ?
                         timeZone.DaylightName : timeZone.StandardName);   
}
// The example displays output similar to the following:
//    The time is 1:00 AM on 4/2/2006 Pacific Standard Time

let displayDateWithTimeZoneName (date1: DateTime) (timeZone: TimeZoneInfo) =
    printfn $"The time is {date1:t} on {date1:d} {if timeZone.IsDaylightSavingTime date1 then timeZone.DaylightName else timeZone.StandardName}" 
// The example displays output similar to the following:
//    The time is 1:00 AM on 4/2/2006 Pacific Standard Time

Private Sub DisplayDateWithTimeZoneName(date1 As Date, timeZone As TimeZoneInfo)
   Console.WriteLine("The time is {0:t} on {0:d} {1}", _
                     date1, _
                     IIf(timeZone.IsDaylightSavingTime(date1), _
                         timezone.DaylightName, timezone.StandardName))   
End Sub
' The example displays output similar to the following:
'    The time is 1:00 AM on 4/2/2006 Pacific Standard Time

Açıklamalar

değerinin dönüş değeri TimeZoneInfo.IsDaylightSavingTime , aşağıdaki tabloda gösterildiği gibi nesnesiyle TimeZoneInfo temsil edilen saat dilimi ile Kind parametresinin dateTime özelliği arasındaki ilişkiden etkilenir.

TimeZoneInfo nesnesi	DateTime.Kind özelliği	Result
TimeZoneInfo.Local	DateTimeKind.Local	Yaz saati olup olmadığını dateTime belirler.
TimeZoneInfo.Local	DateTimeKind.Utc	dateTime Eşgüdümlü Evrensel Saat'ten (UTC) yerel saate dönüştürür ve gün ışığından yararlanma saati olup olmadığını belirler.
TimeZoneInfo.Local	DateTimeKind.Unspecified	Bunun yerel saati temsil ettiğini dateTime varsayar ve gün ışığından yararlanma saati olup olmadığını belirler.
TimeZoneInfo.Utc	DateTimeKind.Local, DateTimeKind.Unspecified veya DateTimeKind.Utc	Döndürür false (UTC, gün ışığından yararlanma saatini desteklemez).
Başka TimeZoneInfo bir nesne.	DateTimeKind.Local	Yerel saati nesnenin eşdeğer saatine TimeZoneInfo dönüştürür ve ardından ikincisinin gün ışığından yararlanma saati olup olmadığını belirler.
Başka TimeZoneInfo bir nesne.	DateTimeKind.Utc	UTC'yi nesnenin TimeZoneInfo eşdeğer saatine dönüştürür ve ardından ikincisinin yaz saati olup olmadığını belirler.
Başka TimeZoneInfo bir nesne.	DateTimeKind.Unspecified	Yaz saati olup olmadığını dateTime belirler.

Nesnesi tarafından temsil edilen saat dilimi gün ışığından TimeZoneInfo yararlanma saatini desteklemiyorsa, yöntemi her zaman döndürür false. dahil olmak üzere Utcbir dizi saat dilimi gün ışığından yararlanma saatini gözlemlemez. Bir saat diliminin gün ışığından yararlanma saatini destekleyip desteklemediğini belirlemek için özelliğinin SupportsDaylightSavingTime değerini alın.

parametresi geçerli nesnenin dateTime saat diliminde belirsiz bir saat belirtiyorsa, TimeZoneInfo.IsDaylightSavingTime yöntemi standart saat olarak yorumlanır dateTime ve özelliği DateTimeKind.Local veya DateTimeKind.Unspecifiedise Kind döndürürfalse. Kind özelliği iseDateTimeKind.Utc, bu yöntem doğru belirsiz saati seçer ve gün ışığından yararlanma saati olup olmadığını belirtir.

Yöntemi belirsiz TimeZoneInfo.IsDaylightSavingTime(DateTime) bir tarih ve saat için döndürebildiğinden false (başka bir ifadeyle, belirli bir saat diliminde standart saati veya gün ışığından yararlanma saatini temsil eden bir tarih ve saat), TimeZoneInfo.IsAmbiguousTime(DateTime) bir saatin yaz saati olup olmadığını belirlemek için yöntemiyle IsDaylightSavingTime(DateTime) eşleştirilebilir. Belirsiz bir saat hem gün ışığından yararlanma saati hem de standart saat olabileceğinden, bir tarih ve saatin gün ışığından IsAmbiguousTime(DateTime) yararlanma saati olup olmadığını belirlemek için yöntem ilk olarak çağrılabilir. yöntemi döndürürse false, değerin IsDaylightSavingTime(DateTime) gün ışığından DateTime yararlanma saati olup olmadığını belirlemek için yöntemi çağrılabilir. Aşağıdaki örnekte bu teknik gösterilmektedir.

DateTime unclearDate = new DateTime(2007, 11, 4, 1, 30, 0);
// Test if time is ambiguous.
Console.WriteLine("In the {0}, {1} is {2}ambiguous.", 
                  TimeZoneInfo.Local.DisplayName, 
                  unclearDate, 
                  TimeZoneInfo.Local.IsAmbiguousTime(unclearDate) ? "" : "not ");
// Test if time is DST.
Console.WriteLine("In the {0}, {1} is {2}daylight saving time.", 
                  TimeZoneInfo.Local.DisplayName, 
                  unclearDate, 
                  TimeZoneInfo.Local.IsDaylightSavingTime(unclearDate) ? "" : "not ");
Console.WriteLine();    
// Report time as DST if it is either ambiguous or DST.
if (TimeZoneInfo.Local.IsAmbiguousTime(unclearDate) || 
    TimeZoneInfo.Local.IsDaylightSavingTime(unclearDate))
    Console.WriteLine("{0} may be daylight saving time in {1}.", 
                      unclearDate, TimeZoneInfo.Local.DisplayName);  
// The example displays the following output:
//    In the (GMT-08:00) Pacific Time (US & Canada), 11/4/2007 1:30:00 AM is ambiguous.
//    In the (GMT-08:00) Pacific Time (US & Canada), 11/4/2007 1:30:00 AM is not daylight saving time.
//    
//    11/4/2007 1:30:00 AM may be daylight saving time in (GMT-08:00) Pacific Time (US & Canada).

let unclearDate = DateTime(2007, 11, 4, 1, 30, 0)
// Test if time is ambiguous.
printfn $"""In the {TimeZoneInfo.Local.DisplayName}, {unclearDate} is {if TimeZoneInfo.Local.IsAmbiguousTime unclearDate then "" else "not "}ambiguous."""
// Test if time is DST.
printfn $"""In the {TimeZoneInfo.Local.DisplayName}, {unclearDate} is {if TimeZoneInfo.Local.IsDaylightSavingTime unclearDate then "" else "not "}daylight saving time.
"""
// Report time as DST if it is either ambiguous or DST.
if TimeZoneInfo.Local.IsAmbiguousTime unclearDate || TimeZoneInfo.Local.IsDaylightSavingTime unclearDate then
    printfn $"{unclearDate} may be daylight saving time in {TimeZoneInfo.Local.DisplayName}."

// The example displays the following output:
//    In the (GMT-08:00) Pacific Time (US & Canada), 11/4/2007 1:30:00 AM is ambiguous.
//    In the (GMT-08:00) Pacific Time (US & Canada), 11/4/2007 1:30:00 AM is not daylight saving time.
//    
//    11/4/2007 1:30:00 AM may be daylight saving time in (GMT-08:00) Pacific Time (US & Canada).

Dim unclearDate As Date = #11/4/2007 1:30AM#
' Test if time is ambiguous.
Console.WriteLine("In the {0}, {1} is {2}ambiguous.", _ 
                  TimeZoneInfo.Local.DisplayName, _
                  unclearDate, _
                  IIf(TimeZoneInfo.Local.IsAmbiguousTime(unclearDate), "", "not "))
' Test if time is DST.
Console.WriteLine("In the {0}, {1} is {2}daylight saving time.", _ 
                  TimeZoneInfo.Local.DisplayName, _
                  unclearDate, _
                  IIf(TimeZoneInfo.Local.IsDaylightSavingTime(unclearDate), "", "not "))
Console.WriteLine()    
' Report time as DST if it is either ambiguous or DST.
If TimeZoneInfo.Local.IsAmbiguousTime(unclearDate) OrElse _ 
   TimeZoneInfo.Local.IsDaylightSavingTime(unclearDate) Then
    Console.WriteLine("{0} may be daylight saving time in {1}.", _ 
                      unclearDate, TimeZoneInfo.Local.DisplayName)                                           
End If
' The example displays the following output:
'    In the (GMT-08:00) Pacific Time (US & Canada), 11/4/2007 1:30:00 AM is ambiguous.
'    In the (GMT-08:00) Pacific Time (US & Canada), 11/4/2007 1:30:00 AM is not daylight saving time.
'    
'    11/4/2007 1:30:00 AM may be daylight saving time in (GMT-08:00) Pacific Time (US & Canada).

dateTime Parametresi geçersiz bir zaman belirtirse, yöntem çağrısı parametrenin Kind özelliğinin dateTime değeri ise DateTimeKind.Localbir ArgumentException oluşturur; aksi takdirde yöntemi döndürürfalse.

TimeZoneInfo.IsDaylightSavingTime Saat dilimi adını görüntülerken saat dilimi StandardName değerini mi yoksa DaylightName değerini mi kullanacağınızı belirlemek için yöntemini çağırın. Çizim için Örnek bölümüne bakın.

Ayrıca bkz.

• SupportsDaylightSavingTime

IsDaylightSavingTime(DateTimeOffset)

Kaynak:

TimeZoneInfo.cs

Belirtilen tarih ve saatin, geçerli TimeZoneInfo nesnenin saat dilimi için gün ışığından yararlanma saati aralığına girip düşmediğini gösterir.

public:
 bool IsDaylightSavingTime(DateTimeOffset dateTimeOffset);

public bool IsDaylightSavingTime(DateTimeOffset dateTimeOffset);

member this.IsDaylightSavingTime : DateTimeOffset -> bool

Public Function IsDaylightSavingTime (dateTimeOffset As DateTimeOffset) As Boolean

Parametreler

dateTimeOffset

DateTimeOffset

Tarih ve saat değeri.

Döndürülenler

Boolean

true parametresi gün ışığından dateTimeOffset yararlanma saatiyse; değilse, false.

Açıklamalar

dönüş değeriTimeZoneInfo.IsDaylightSavingTime, nesnesi tarafından temsil edilen saat dilimi ile Offset parametresinin TimeZoneInfo özelliği arasındaki ilişkiden dateTimeOffset etkilenir. dateTimeOffset Eşgüdümlü Evrensel Saat'ten (UTC) geçerli saat diliminin uzaklığıyla eşleşmiyorsa, yöntem bu saati geçerli saat dilimindeki saate dönüştürür. Ardından bu tarih ve saatin yaz saati olup olmadığını belirler.

Nesnesi tarafından temsil edilen saat dilimi gün ışığından TimeZoneInfo yararlanma saatini desteklemiyorsa, yöntemi her zaman döndürür false. Bir saat diliminin gün ışığından yararlanma saatini destekleyip desteklemediğini belirlemek için özelliğinin SupportsDaylightSavingTime değerini alın.

Ayrıca bkz.

• SupportsDaylightSavingTime