TimeZoneInfo.IsDaylightSavingTime Methode

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)

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)

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)

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

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 TimeZoneInfo.IsDaylightSavingTime wird von der Beziehung zwischen der Zeitzone, die durch das TimeZoneInfo-Objekt dargestellt wird, und der Offset-Eigenschaft des dateTimeOffset-Parameters beeinflusst.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 Uhrzeit 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 durch das TimeZoneInfo Objekt dargestellte Zeitzone die Sommerzeit nicht unterstützt, gibt die Methode immer falsezurü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 Wert der SupportsDaylightSavingTime-Eigenschaft ab.To determine whether a time zone supports daylight saving time, retrieve the value of its SupportsDaylightSavingTime property.

Siehe auch

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

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 dem Namen DisplayDateWithTimeZoneName definiert, die die TimeZoneInfo.IsDaylightSavingTime-Methode verwendet, um zu bestimmen, ob der Standardzeit Name einer Zeitzone oder der Name der Sommerzeit 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 TimeZoneInfo.IsDaylightSavingTime wird von der Beziehung zwischen der durch das TimeZoneInfo-Objekt dargestellten Zeitzone und der Kind-Eigenschaft des dateTime-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, ob dateTime 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 aus, dass dateTime 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).
Alle anderen 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.
Alle anderen 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.
Alle anderen TimeZoneInfo-Objekt.Any other TimeZoneInfo object. DateTimeKind.Unspecified Bestimmt, ob dateTime Sommerzeit ist.Determines whether dateTime is daylight saving time.

Wenn die durch das TimeZoneInfo Objekt dargestellte Zeitzone die Sommerzeit nicht unterstützt, gibt die Methode immer falsezurü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 nicht die Sommerzeit.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 Wert der SupportsDaylightSavingTime-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, interpretiert die TimeZoneInfo.IsDaylightSavingTime-Methode dateTime als Standardzeit und gibt false zurück, wenn Ihre Kind-Eigenschaft DateTimeKind.Local 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 false für eine mehrdeutige Datums-und uhrzeitanzeit zurückgeben kann (d. h. ein Datum und eine Uhrzeit, die entweder eine Standardzeit oder eine Sommerzeit in einer bestimmten Zeitzone darstellen können), kann die TimeZoneInfo.IsAmbiguousTime(DateTime) Methode mit der IsDaylightSavingTime(DateTime)-Methode gekoppelt werden, 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, kann die IsDaylightSavingTime(DateTime)-Methode aufgerufen werden, um zu bestimmen, ob der DateTime 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 einen ungültigen Zeitpunkt angibt, löst der Methodenaufruf eine ArgumentException aus, wenn der Wert der Kind-Eigenschaft des dateTime-Parameters DateTimeKind.Localist. Andernfalls gibt die Methode falsezurü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 oder der DaylightName 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: