Aracılığıyla paylaş

TimeZoneInfo.IsDaylightSavingTime Yöntem

  • Başvuru

Tanım

Ad Alanı:
System
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
System.Core.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.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

IsDaylightSavingTime(DateTime)

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

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

IsDaylightSavingTime(DateTime)

Kaynak:
TimeZoneInfo.cs
Kaynak:
TimeZoneInfo.cs
Kaynak:
TimeZoneInfo.cs

Belirtilen tarih ve saatin geçerli TimeZoneInfo nesnenin saat dilimi için gün ışığından yararlanma saati aralığında olup olmadığını 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ı mı yoksa yaz saati adı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

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 Sonuç
TimeZoneInfo.Local DateTimeKind.Local Gün ışığından yararlanma 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 yaz 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.Unspecifiedveya DateTimeKind.Utc döndürür false (UTC yaz saati uygulamasını desteklemez).
Başka TimeZoneInfo bir nesne. DateTimeKind.Local Yerel saati nesnenin eşdeğer zamanına TimeZoneInfo dönüştürür ve ardından ikincisinin yaz 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 Gün ışığından yararlanma 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 yaz saati özelliğini destekleyip desteklemediğini belirlemek için özelliğinin SupportsDaylightSavingTime değerini alın.

parametresi geçerli nesnenin dateTime saat diliminde belirsiz bir saat belirtirse, TimeZoneInfo.IsDaylightSavingTime yöntemi standart saat olarak yorumlar 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.

TimeZoneInfo.IsDaylightSavingTime(DateTime) Yöntemi belirsiz bir tarih ve saat için döndürebileceğinden false (yani, standart bir saati veya belirli bir saat dilimindeki bir yaz saati 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 yaz saati hem de standart saat olabileceğinden, IsAmbiguousTime(DateTime) bir tarih ve saatin yaz saati olup olmadığını belirlemek için önce yöntemi çağrılabilir. yöntemi döndürürse false, değerin IsDaylightSavingTime(DateTime)DateTime yaz 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 saat belirtirse, parametrenin Kind özelliğinin dateTimeDateTimeKind.Localdeğeri ise yöntem çağrısı bir 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.

Şunlara uygulanır

IsDaylightSavingTime(DateTimeOffset)

Kaynak:
TimeZoneInfo.cs
Kaynak:
TimeZoneInfo.cs
Kaynak:
TimeZoneInfo.cs

Belirtilen tarih ve saatin geçerli TimeZoneInfo nesnenin saat dilimi için gün ışığından yararlanma saati aralığında olup olmadığını 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. Eşgüdümlü dateTimeOffset Evrensel Saat'ten (UTC) geçerli saat diliminin uzaklığıyla eşleşmiyorsa, yöntemi bu saati geçerli saat dilimindeki saate dönüştürür. Daha sonra bu tarih ve saatin gün ışığından yararlanma 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 yaz saati özelliğini destekleyip desteklemediğini belirlemek için özelliğinin SupportsDaylightSavingTime değerini alın.

Ayrıca bkz.

Şunlara uygulanır