TimeZone TimeZone TimeZone TimeZone Class

Definition

Warnung

Diese API ist jetzt veraltet.

Stellt eine Zeitzone dar.Represents a time zone.

public ref class TimeZone abstract
[System.Runtime.InteropServices.ComVisible(true)]
[System.Obsolete("System.TimeZone has been deprecated.  Please investigate the use of System.TimeZoneInfo instead.")]
[System.Serializable]
public abstract class TimeZone
type TimeZone = class
Public MustInherit Class TimeZone
Vererbung
TimeZoneTimeZoneTimeZoneTimeZone
Attribute

Beispiele

Das folgenden Beispiel-Referenzen und zeigt ausgewählte TimeZone -Klasse Elemente.The following example references and displays selected TimeZone class elements.

// Example of selected TimeZone class elements.
using namespace System;
using namespace System::Globalization;
int main()
{
   String^ dataFmt = "{0,-30}{1}";
   String^ timeFmt = "{0,-30}{1:yyyy-MM-dd HH:mm}";
   Console::WriteLine( "This example of selected TimeZone class "
   "elements generates the following \n"
   "output, which varies depending on the "
   "time zone in which it is run.\n" );
   
   // Get the local time zone and the current local time and year.
   TimeZone^ localZone = TimeZone::CurrentTimeZone;
   DateTime currentDate = DateTime::Now;
   int currentYear = currentDate.Year;
   
   // Display the names for standard time and daylight saving 
   // time for the local time zone.
   Console::WriteLine( dataFmt, "Standard time name:", localZone->StandardName );
   Console::WriteLine( dataFmt, "Daylight saving time name:", localZone->DaylightName );
   
   // Display the current date and time and show if they occur 
   // in daylight saving time.
   Console::WriteLine( String::Concat( "\n", timeFmt ), "Current date and time:", currentDate );
   Console::WriteLine( dataFmt, "Daylight saving time?", localZone->IsDaylightSavingTime( currentDate ) );
   
   // Get the current Coordinated Universal Time (UTC) and UTC 
   // offset.
   DateTime currentUTC = localZone->ToUniversalTime( currentDate );
   TimeSpan currentOffset = localZone->GetUtcOffset( currentDate );
   Console::WriteLine( timeFmt, "Coordinated Universal Time:", currentUTC );
   Console::WriteLine( dataFmt, "UTC offset:", currentOffset );
   
   // Get the DaylightTime object for the current year.
   DaylightTime^ daylight = localZone->GetDaylightChanges( currentYear );
   
   // Display the daylight saving time range for the current year.
   Console::WriteLine( "\nDaylight saving time for year {0}:", currentYear );
   Console::WriteLine( "{0:yyyy-MM-dd HH:mm} to "
   "{1:yyyy-MM-dd HH:mm}, delta: {2}", daylight->Start, daylight->End, daylight->Delta );
}

/*
This example of selected TimeZone class elements generates the following
output, which varies depending on the time zone in which it is run.

Standard time name:           Pacific Standard Time
Daylight saving time name:    Pacific Daylight Time

Current date and time:        2006-01-06 16:47
Daylight saving time?         False
Coordinated Universal Time:   2006-01-07 00:47
UTC offset:                   -08:00:00

Daylight saving time for year 2006:
2006-04-02 02:00 to 2006-10-29 02:00, delta: 01:00:00
*/
// Example of selected TimeZone class elements.
using System;
using System.Globalization;

class TimeZoneDemo
{
    static void Main( )
    {
        const string dataFmt = "{0,-30}{1}";
        const string timeFmt = "{0,-30}{1:yyyy-MM-dd HH:mm}";

        Console.WriteLine(
            "This example of selected TimeZone class " +
            "elements generates the following \n" +
            "output, which varies depending on the " +
            "time zone in which it is run.\n" );

        // Get the local time zone and the current local time and year.
        TimeZone localZone = TimeZone.CurrentTimeZone;
        DateTime currentDate = DateTime.Now;
        int      currentYear = currentDate.Year;

        // Display the names for standard time and daylight saving 
        // time for the local time zone.
        Console.WriteLine( dataFmt, "Standard time name:", 
            localZone.StandardName );
        Console.WriteLine( dataFmt, "Daylight saving time name:", 
            localZone.DaylightName );

        // Display the current date and time and show if they occur 
        // in daylight saving time.
        Console.WriteLine( "\n" + timeFmt, "Current date and time:",
            currentDate );
        Console.WriteLine( dataFmt, "Daylight saving time?", 
            localZone.IsDaylightSavingTime( currentDate ) );

        // Get the current Coordinated Universal Time (UTC) and UTC 
        // offset.
        DateTime currentUTC = 
            localZone.ToUniversalTime( currentDate );
        TimeSpan currentOffset = 
            localZone.GetUtcOffset( currentDate );

        Console.WriteLine( timeFmt, "Coordinated Universal Time:", 
            currentUTC );
        Console.WriteLine( dataFmt, "UTC offset:", currentOffset );

        // Get the DaylightTime object for the current year.
        DaylightTime daylight = 
            localZone.GetDaylightChanges( currentYear );

        // Display the daylight saving time range for the current year.
        Console.WriteLine( 
            "\nDaylight saving time for year {0}:", currentYear );
        Console.WriteLine( "{0:yyyy-MM-dd HH:mm} to " +
            "{1:yyyy-MM-dd HH:mm}, delta: {2}", 
            daylight.Start, daylight.End, daylight.Delta );
    } 
} 

/*
This example of selected TimeZone class elements generates the following
output, which varies depending on the time zone in which it is run.

Standard time name:           Pacific Standard Time
Daylight saving time name:    Pacific Daylight Time

Current date and time:        2006-01-06 16:47
Daylight saving time?         False
Coordinated Universal Time:   2006-01-07 00:47
UTC offset:                   -08:00:00

Daylight saving time for year 2006:
2006-04-02 02:00 to 2006-10-29 02:00, delta: 01:00:00
*/ 
' Example of selected TimeZone class elements.
Imports System
Imports System.Globalization
Imports Microsoft.VisualBasic

Module TimeZoneDemo

    Sub Main( )

        Const dataFmt As String = "{0,-30}{1}"
        Const timeFmt As String = "{0,-30}{1:yyyy-MM-dd HH:mm}"

        Console.WriteLine( "This example of selected " & _
            "TimeZone class elements generates the following " & _
            vbCrLf & "output, which varies depending on the " & _
            "time zone in which it is run." & vbCrLf )

        ' Get the local time zone and the current local time and year.
        Dim localZone As TimeZone = TimeZone.CurrentTimeZone
        Dim currentDate As DateTime = DateTime.Now
        Dim currentYear As Integer = currentDate.Year

        ' Display the names for standard time and daylight saving 
        ' time for the local time zone.
        Console.WriteLine( dataFmt, "Standard time name:", _
            localZone.StandardName )
        Console.WriteLine( dataFmt, "Daylight saving time name:", _
            localZone.DaylightName )

        ' Display the current date and time and show if they occur 
        ' in daylight saving time.
        Console.WriteLine( vbCrLf & timeFmt, _
            "Current date and time:", currentDate )
        Console.WriteLine( dataFmt, "Daylight saving time?", _
            localZone.IsDaylightSavingTime( currentDate ) )

        ' Get the current Coordinated Universal Time (UTC) and UTC 
        ' offset.
        Dim currentUTC As DateTime = _
            localZone.ToUniversalTime( currentDate )
        Dim currentOffset As TimeSpan = _
            localZone.GetUtcOffset( currentDate )

        Console.WriteLine( timeFmt, "Coordinated Universal Time:", _
            currentUTC )
        Console.WriteLine( dataFmt, "UTC offset:", currentOffset )

        ' Get the DaylightTime object for the current year.
        Dim daylight As DaylightTime = _
            localZone.GetDaylightChanges( currentYear )

        ' Display the daylight saving time range for the current year.
        Console.WriteLine( vbCrLf & _
            "Daylight saving time for year {0}:", currentYear )
        Console.WriteLine( "{0:yyyy-MM-dd HH:mm} to " & _
            "{1:yyyy-MM-dd HH:mm}, delta: {2}", _
            daylight.Start, daylight.End, daylight.Delta )
    End Sub 
End Module 

'This example of selected TimeZone class elements generates the following
'output, which varies depending on the time zone in which it is run.
'
'Standard time name:           Pacific Standard Time
'Daylight saving time name:    Pacific Daylight Time
'
'Current date and time:        2006-01-06 16:47
'Daylight saving time?         False
'Coordinated Universal Time:   2006-01-07 00:47
'UTC offset:                   -08:00:00
'
'Daylight saving time for year 2006:
'2006-04-02 02:00 to 2006-10-29 02:00, delta: 01:00:00

Hinweise

Eine Zeitzone ist eine geografische Region, in der die gleiche Standardzeit verwendet wird.A time zone is a geographical region in which the same standard time is used.

Wichtig

Verwenden Sie nach Möglichkeit die TimeZoneInfo -Klasse anstelle der TimeZone Klasse.Whenever possible, use the TimeZoneInfo class instead of the TimeZone class.

Sie können die TimeZone Klasse zum Abrufen von Informationen über die aktuelle Zeitzone, und wie oft von der Ortszeit in Coordinated Universal Time (UTC) oder umgekehrt zu konvertieren.You can use the TimeZone class to retrieve information about the current time zone, and to convert times from local time to Coordinated Universal Time (UTC) or vice versa. Allerdings können keine der TimeZone Klasse zur Darstellung von anderen Zeitzonen als der lokale Zone oder zur Behandlung von Datum und Uhrzeit-Konvertierungen von einer Zeitzone in eine andere.However, you cannot use the TimeZone class to represent time zones other than the local zone or to handle date and time conversions from one time zone to another. Zu diesem Zweck verwenden Sie die TimeZoneInfo Klasse.For this purpose, use the TimeZoneInfo class. Sie können diese Klasse verwenden, zum Abrufen von Informationen auf eine beliebige Zeitzone definiert, auf dem lokalen System aus, um benutzerdefinierte Zeitzonen zu erstellen und zu Zeiten von einer Zeitzone in eine andere zu konvertieren.You can use this class to retrieve information on any time zone defined on the local system, to create custom time zones, and to convert times from one time zone to another.

Die TimeZone -Klasse unterstützt nur eine einzelne Sommerzeit Anpassungsregel für die lokale Zeitzone.The TimeZone class supports only a single daylight saving time adjustment rule for the local time zone. Daher die TimeZone Klasse kann genau Sommerzeit-Berichtsinformationen oder Konvertieren zwischen UTC und Ortszeit lediglich für den Zeitraum, in dem die jüngste Anpassungsregel aktiviert ist.As a result, the TimeZone class can accurately report daylight saving time information or convert between UTC and local time only for the period in which the latest adjustment rule is in effect. Im Gegensatz dazu die TimeZoneInfo Klasse unterstützt mehrere Anpassungsregeln, wodurch es möglich, mit Zeitzonendaten zu arbeiten.In contrast, the TimeZoneInfo class supports multiple adjustment rules, which makes it possible to work with historic time zone data.

Hinweise für Vererber

Zusätzlich zur Bereitstellung von Implementierungen für die abstract Mitglieder (markierten MustOverride in Visual Basic), es ist wichtig, dass Klassen abgeleitete TimeZone überschreiben das Standardverhalten der ToLocalTime(DateTime) Methode.In addition to providing implementations for its abstract members (those marked MustOverride in Visual Basic), it is important that classes derived from TimeZone override the default behavior of the ToLocalTime(DateTime) method. Grund hierfür ist das Standardverhalten des ToLocalTime(DateTime) in .NET Framework Version 2.0 hängt keinem Aufruf von GetUtcOffset(DateTime), wie in den .NET Framework-Versionen 1.0 und 1.1.This is because the default behavior of ToLocalTime(DateTime) in the .NET Framework version 2.0 does not depend on a call to GetUtcOffset(DateTime), as it did in the .NET Framework versions 1.0 and 1.1. Weitere Informationen finden Sie unter den ToLocalTime(DateTime) Methode.For details, see the ToLocalTime(DateTime) method.

Konstruktoren

TimeZone() TimeZone() TimeZone() TimeZone()

Initialisiert eine neue Instanz der TimeZone-Klasse.Initializes a new instance of the TimeZone class.

Eigenschaften

CurrentTimeZone CurrentTimeZone CurrentTimeZone CurrentTimeZone

Ruft die Zeitzone des aktuellen Computers ab.Gets the time zone of the current computer.

DaylightName DaylightName DaylightName DaylightName

Ruft den Namen der Sommerzeitzone ab.Gets the daylight saving time zone name.

StandardName StandardName StandardName StandardName

Ruft den Namen der Standardzeitzone ab.Gets the standard time zone name.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDaylightChanges(Int32) GetDaylightChanges(Int32) GetDaylightChanges(Int32) GetDaylightChanges(Int32)

Gibt den Zeitraum mit Sommerzeit für ein bestimmtes Jahr zurück.Returns the daylight saving time period for a particular year.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
GetUtcOffset(DateTime) GetUtcOffset(DateTime) GetUtcOffset(DateTime) GetUtcOffset(DateTime)

Gibt für die angegebene Ortszeit den Offset zur koordinierten Weltzeit (Coordinated Universal Time, UTC) zurück.Returns the Coordinated Universal Time (UTC) offset for the specified local time.

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

Gibt einen Wert zurück, der angibt, ob das angegebene Datum und die angegebene Uhrzeit innerhalb der Sommerzeit liegen.Returns a value indicating whether the specified date and time is within a daylight saving time period.

IsDaylightSavingTime(DateTime, DaylightTime) IsDaylightSavingTime(DateTime, DaylightTime) IsDaylightSavingTime(DateTime, DaylightTime) IsDaylightSavingTime(DateTime, DaylightTime)

Gibt einen Wert zurück, der angibt, ob das angegebene Datum und die angegebene Uhrzeit innerhalb der angegebenen Sommerzeit liegen.Returns a value indicating whether the specified date and time is within the specified daylight saving time period.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToLocalTime(DateTime) ToLocalTime(DateTime) ToLocalTime(DateTime) ToLocalTime(DateTime)

Gibt die Ortszeit zurück, die einem angegebenen Datums- und Zeitwert entspricht.Returns the local time that corresponds to a specified date and time value.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
ToUniversalTime(DateTime) ToUniversalTime(DateTime) ToUniversalTime(DateTime) ToUniversalTime(DateTime)

Gibt die Coordinated Universal Time (UTC) zurück, die einer angegebenen Zeit entspricht.Returns the Coordinated Universal Time (UTC) that corresponds to a specified time.

Gilt für:

Siehe auch