TimeZoneInfo.IsDaylightSavingTime Yöntem

Kaynak:

TimeZoneInfo.cs

Kaynak:

TimeZoneInfo.cs

Kaynak:

TimeZoneInfo.cs

public:
 bool IsDaylightSavingTime(DateTime dateTime);

public bool IsDaylightSavingTime (DateTime dateTime);

member this.IsDaylightSavingTime : DateTime -> bool

Public Function IsDaylightSavingTime (dateTime As DateTime) As Boolean

Parametreler

Döndürülenler

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

Özel durumlar

Ö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.

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.

• SupportsDaylightSavingTime

Kaynak:

TimeZoneInfo.cs

Kaynak:

TimeZoneInfo.cs

Kaynak:

TimeZoneInfo.cs

public:
 bool IsDaylightSavingTime(DateTimeOffset dateTimeOffset);

public bool IsDaylightSavingTime (DateTimeOffset dateTimeOffset);

member this.IsDaylightSavingTime : DateTimeOffset -> bool

Public Function IsDaylightSavingTime (dateTimeOffset As DateTimeOffset) As Boolean

Parametreler

Döndürülenler

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.

• SupportsDaylightSavingTime