TimeZoneInfo.IsDaylightSavingTime TimeZoneInfo.IsDaylightSavingTime TimeZoneInfo.IsDaylightSavingTime Method

Definition

Gibt an, ob ein angegebenes Datum und eine Zeit in den Bereich der Sommerzeit für die Zeitzone des aktuellen TimeZoneInfo-Objekts fallen.Indicates whether a specified date and time falls in the range of daylight saving time for the current TimeZoneInfo object's time zone.

Überlädt

IsDaylightSavingTime(DateTimeOffset) IsDaylightSavingTime(DateTimeOffset) IsDaylightSavingTime(DateTimeOffset)

Gibt an, ob ein angegebenes Datum und eine Zeit in den Bereich der Sommerzeit für die Zeitzone des aktuellen TimeZoneInfo-Objekts fallen.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

IsDaylightSavingTime(DateTime) IsDaylightSavingTime(DateTime) IsDaylightSavingTime(DateTime)

Gibt an, ob ein angegebenes Datum und eine Zeit in den Bereich der Sommerzeit für die Zeitzone des aktuellen TimeZoneInfo-Objekts fallen.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

IsDaylightSavingTime(DateTimeOffset) IsDaylightSavingTime(DateTimeOffset) IsDaylightSavingTime(DateTimeOffset)

Gibt an, ob ein angegebenes Datum und eine Zeit in den Bereich der Sommerzeit für die Zeitzone des aktuellen TimeZoneInfo-Objekts fallen.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

public:
 bool IsDaylightSavingTime(DateTimeOffset dateTimeOffset);
public bool IsDaylightSavingTime (DateTimeOffset dateTimeOffset);
member this.IsDaylightSavingTime : DateTimeOffset -> bool

Parameter

dateTimeOffset
DateTimeOffset DateTimeOffset DateTimeOffset

Ein Datums- und Uhrzeitwert.A date and time value.

Gibt zurück

true, wenn der dateTimeOffset-Parameter eine Sommerzeit darstellt, andernfalls false.true if the dateTimeOffset parameter is a daylight saving time; otherwise, false.

Hinweise

Der Rückgabewert von TimeZoneInfo.IsDaylightSavingTime ist von der Beziehung zwischen der durch das TimeZoneInfo dateTimeOffset -Objekt dargestellten Zeitzone und der Offset -Eigenschaft des-Parameters betroffen.The return value of TimeZoneInfo.IsDaylightSavingTime is affected by the relationship between the time zone represented by the TimeZoneInfo object and the Offset property of the dateTimeOffset parameter. Wenn dateTimeOffset nicht dem Offset der aktuellen Zeitzone von der koordinierten Weltzeit (UTC) entspricht, konvertiert die-Methode diese Zeit in die Zeit in der aktuellen Zeitzone.If dateTimeOffset does not correspond to the current time zone's offset from Coordinated Universal Time (UTC), the method converts that time to the time in the current time zone. Anschließend bestimmt er, ob dieses Datum und die Uhrzeit eine Sommerzeit sind.It then determines whether that date and time is a daylight saving time.

Wenn die Zeitzone, die durch das TimeZoneInfo -Objekt dargestellt wird, keine Sommerzeit unterstützt, gibt falsedie Methode immer zurück.If the time zone represented by the TimeZoneInfo object does not support daylight saving time, the method always returns false. Um zu ermitteln, ob eine Zeitzone die Sommerzeit unterstützt, rufen Sie den SupportsDaylightSavingTime Wert der zugehörigen-Eigenschaft ab.To determine whether a time zone supports daylight saving time, retrieve the value of its SupportsDaylightSavingTime property.

Siehe auch

IsDaylightSavingTime(DateTime) IsDaylightSavingTime(DateTime) IsDaylightSavingTime(DateTime)

Gibt an, ob ein angegebenes Datum und eine Zeit in den Bereich der Sommerzeit für die Zeitzone des aktuellen TimeZoneInfo-Objekts fallen.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

public:
 bool IsDaylightSavingTime(DateTime dateTime);
public bool IsDaylightSavingTime (DateTime dateTime);
member this.IsDaylightSavingTime : DateTime -> bool

Parameter

dateTime
DateTime DateTime DateTime

Ein Datums- und Uhrzeitwert.A date and time value.

Gibt zurück

true, wenn der dateTime-Parameter eine Sommerzeit darstellt, andernfalls false.true if the dateTime parameter is a daylight saving time; otherwise, false.

Ausnahmen

Die Kind-Eigenschaft des dateTime-Werts ist Local und dateTime ist eine ungültige Zeit.The Kind property of the dateTime value is Local and dateTime is an invalid time.

Beispiele

Im folgenden Beispiel wird eine Methode mit DisplayDateWithTimeZoneName dem Namen definiert TimeZoneInfo.IsDaylightSavingTime , die die-Methode verwendet, um zu bestimmen, ob der Name der Standardzeit und der Sommerzeit einer Zeitzone angezeigt werden soll.The following example defines a method named DisplayDateWithTimeZoneName that uses the TimeZoneInfo.IsDaylightSavingTime method to determine whether to display a time zone's standard time name or daylight saving time name.

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

Hinweise

Der Rückgabewert von TimeZoneInfo.IsDaylightSavingTime wird von der Beziehung zwischen der durch das TimeZoneInfo dateTime -Objekt dargestellten Zeitzone und der Kind -Eigenschaft des-Parameters beeinflusst, wie in der folgenden Tabelle gezeigt.The return value of TimeZoneInfo.IsDaylightSavingTime is affected by the relationship between the time zone represented by the TimeZoneInfo object and the Kind property of the dateTime parameter, as the following table shows.

TimeZoneInfo-ObjektTimeZoneInfo object DateTime. Kind-EigenschaftDateTime.Kind property ErgebnisResult
TimeZoneInfo.Local DateTimeKind.Local Bestimmt, dateTime ob die Sommerzeit ist.Determines whether dateTime is daylight saving time.
TimeZoneInfo.Local DateTimeKind.Utc Konvertiert dateTime von der koordinierten Weltzeit (UTC) in die Ortszeit und bestimmt, ob es sich um Sommerzeit handelt.Converts dateTime from Coordinated Universal Time (UTC) to local time and determines whether it is daylight saving time.
TimeZoneInfo.Local DateTimeKind.Unspecified Geht davon dateTime aus, dass die Ortszeit darstellt und bestimmt, ob es sich um Sommerzeit handelt.Assumes that dateTime represents local time and determines whether it is daylight saving time.
TimeZoneInfo.Utc DateTimeKind.Local, DateTimeKind.Unspecifiedoder DateTimeKind.UtcDateTimeKind.Local, DateTimeKind.Unspecified, or DateTimeKind.Utc Gibt false zurück (UTC unterstützt keine Sommerzeit).Returns false (UTC does not support daylight saving time).
Ein beliebiges anderes TimeZoneInfo -Objekt.Any other TimeZoneInfo object. DateTimeKind.Local Konvertiert die lokale Zeit in die entsprechende Zeit des TimeZoneInfo -Objekts und bestimmt dann, ob letztere die Sommerzeit ist.Converts the local time to the equivalent time of the TimeZoneInfo object and then determines whether the latter is daylight saving time.
Ein beliebiges anderes TimeZoneInfo -Objekt.Any other TimeZoneInfo object. DateTimeKind.Utc Konvertiert UTC in die entsprechende Zeit des TimeZoneInfo -Objekts und bestimmt dann, ob letztere die Sommerzeit ist.Converts UTC to the equivalent time of the TimeZoneInfo object and then determines whether the latter is daylight saving time.
Ein beliebiges anderes TimeZoneInfo -Objekt.Any other TimeZoneInfo object. DateTimeKind.Unspecified Bestimmt, dateTime ob die Sommerzeit ist.Determines whether dateTime is daylight saving time.

Wenn die Zeitzone, die durch das TimeZoneInfo -Objekt dargestellt wird, keine Sommerzeit unterstützt, gibt falsedie Methode immer zurück.If the time zone represented by the TimeZoneInfo object does not support daylight saving time, the method always returns false. Eine Reihe von Zeitzonen, einschließlich Utc, beobachten die Sommerzeit nicht.A number of time zones, including Utc, do not observe daylight saving time. Um zu ermitteln, ob eine Zeitzone die Sommerzeit unterstützt, rufen Sie den SupportsDaylightSavingTime Wert der zugehörigen-Eigenschaft ab.To determine whether a time zone supports daylight saving time, retrieve the value of its SupportsDaylightSavingTime property.

Wenn der dateTime -Parameter eine mehrdeutige Zeit in der Zeitzone des aktuellen-Objekts angibt TimeZoneInfo.IsDaylightSavingTime , interpretiert dateTime die Methode als Standardzeit false und gibt Kind zurück, DateTimeKind.Local wenn die-Eigenschaft oder DateTimeKind.Unspecifiedist.If the dateTime parameter specifies an ambiguous time in the current object's time zone, the TimeZoneInfo.IsDaylightSavingTime method interprets dateTime as standard time and returns false if its Kind property is DateTimeKind.Local or DateTimeKind.Unspecified. Wenn die Kind -Eigenschaft DateTimeKind.Utcist, wählt diese Methode die richtige mehrdeutige Zeit aus und gibt an, ob es sich um eine Sommerzeit handelt.If the Kind property is DateTimeKind.Utc, this method will select the correct ambiguous time and indicate whether it is a daylight saving time.

Da die TimeZoneInfo.IsDaylightSavingTime(DateTime) Methode für eine false mehrdeutige Datums-und uhrzeitanzeit (d. h. ein Datum und eine Uhrzeit, die entweder eine Standardzeit oder eine Sommerzeit in einer bestimmten Zeitzone darstellen kann) TimeZoneInfo.IsAmbiguousTime(DateTime) zurückgeben kann, kann die Methode mit dem IsDaylightSavingTime(DateTime) Methode, um zu bestimmen, ob eine Zeit eine Sommerzeit sein kann.Because the TimeZoneInfo.IsDaylightSavingTime(DateTime) method can return false for a date and time that is ambiguous (that is, a date and time that can represent either a standard time or a daylight saving time in a particular time zone), the TimeZoneInfo.IsAmbiguousTime(DateTime) method can be paired with the IsDaylightSavingTime(DateTime) method to determine whether a time may be a daylight saving time. Da eine mehrdeutige Zeit sowohl eine Sommerzeit als auch eine Standardzeit sein kann, kann die IsAmbiguousTime(DateTime) -Methode zuerst aufgerufen werden, um zu bestimmen, ob ein Datum und eine Uhrzeit eine Sommerzeit sein können.Because an ambiguous time is one that can be both a daylight saving time and a standard time, the IsAmbiguousTime(DateTime) method can be called first to determine whether a date and time may be a daylight saving time. Wenn die-Methode falsezurückgibt IsDaylightSavingTime(DateTime) , kann die-Methode aufgerufen werden, DateTime um zu bestimmen, ob der Wert eine Sommerzeit ist.If the method returns false, the IsDaylightSavingTime(DateTime) method can be called to determine whether the DateTime value is a daylight saving time. Dieses Verfahren wird im folgenden Beispiel veranschaulicht.The following example illustrates this technique.

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

Wenn der dateTime -Parameter eine ungültige Zeit angibt, löst der Methoden ArgumentException Aufruf eine aus, dateTime wenn der Wert Kind der- DateTimeKind.LocalEigenschaft des-Parameters ist false. andernfalls gibt die Methode zurück.If the dateTime parameter specifies an invalid time, the method call throws an ArgumentException if the value of the dateTime parameter's Kind property is DateTimeKind.Local; otherwise, the method returns false.

Ruft die TimeZoneInfo.IsDaylightSavingTime -Methode auf, um zu bestimmen, ob der StandardName Wert einer Zeitzone DaylightName oder deren Wert beim Anzeigen des Zeit Zonen namens verwendet werden soll.Call the TimeZoneInfo.IsDaylightSavingTime method to determine whether to use a time zone's StandardName value or its DaylightName value when displaying the time zone name. Eine Abbildung finden Sie im Beispiel Abschnitt.See the Example section for an illustration.

Siehe auch

Gilt für: