TimeZone Klasse

Definition

Achtung

System.TimeZone has been deprecated. Please investigate the use of System.TimeZoneInfo instead.

Achtung

System.TimeZone has been deprecated. Investigate the use of System.TimeZoneInfo instead.

Stellt eine Zeitzone dar.

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

Beispiele

Im folgenden Beispiel werden ausgewählte TimeZone Klassenelemente referenziert und angezeigt.

// 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.Globalization

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.

Wichtig

Wenn möglich, verwenden Sie die TimeZoneInfo Klasse anstelle der TimeZone Klasse.

Sie können die TimeZone Klasse verwenden, um Informationen zur aktuellen Zeitzone abzurufen und Zeiten von der lokalen Zeit in koordinierte Weltzeit (UTC) zu konvertieren oder umgekehrt. Sie können die TimeZone Klasse jedoch nicht verwenden, um andere Zeitzonen als die lokale Zone darzustellen oder Datums- und Uhrzeitkonvertierungen von einer Zeitzone in eine andere zu behandeln. Verwenden Sie dazu die TimeZoneInfo Klasse. Sie können diese Klasse verwenden, um Informationen zu jeder zeitzone abzurufen, die im lokalen System definiert ist, um benutzerdefinierte Zeitzonen zu erstellen und Zeiten von einer Zeitzone in eine andere zu konvertieren.

Die TimeZone Klasse unterstützt nur eine einzige Sommerzeitanpassungsregel für die lokale Zeitzone. Daher kann die TimeZone Klasse Sommerzeitinformationen genau melden oder zwischen UTC und Ortszeit nur für den Zeitraum konvertieren, in dem die neueste Anpassungsregel wirksam ist. Im Gegensatz dazu unterstützt die TimeZoneInfo Klasse mehrere Anpassungsregeln, wodurch es möglich ist, mit historischen Zeitzonendaten zu arbeiten.

Hinweise für Ausführende

Zusätzlich zur Bereitstellung von Implementierungen für seine abstract Member (die in Visual Basic gekennzeichnet sindMustOverride), ist es wichtig, dass Klassen, die von TimeZone der Überschreibung des Standardverhaltens der ToLocalTime(DateTime) Methode abgeleitet wurden, außer Kraft setzen. Dies liegt daran, dass das Standardverhalten ToLocalTime(DateTime) in der .NET Framework Version 2.0 nicht von einem Aufruf GetUtcOffset(DateTime)abhängig ist, wie es in den .NET Framework Versionen 1.0 und 1.1 der Fall ist. Ausführliche Informationen finden Sie in der ToLocalTime(DateTime) Methode.

Konstruktoren

TimeZone()

Initialisiert eine neue Instanz der TimeZone-Klasse.

Eigenschaften

CurrentTimeZone

Ruft die Zeitzone des aktuellen Computers ab.

DaylightName

Ruft den Namen der Sommerzeitzone ab.

StandardName

Ruft den Namen der Standardzeitzone ab.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetDaylightChanges(Int32)

Gibt den Zeitraum mit Sommerzeit für ein bestimmtes Jahr zurück.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetUtcOffset(DateTime)

Gibt für die angegebene Ortszeit den Offset zur koordinierten Weltzeit (Coordinated Universal Time, UTC) zurück.

IsDaylightSavingTime(DateTime)

Gibt einen Wert zurück, der angibt, ob das angegebene Datum und die angegebene Uhrzeit innerhalb der Sommerzeit liegen.

IsDaylightSavingTime(DateTime, DaylightTime)

Gibt einen Wert zurück, der angibt, ob das angegebene Datum und die angegebene Uhrzeit innerhalb der angegebenen Sommerzeit liegen.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToLocalTime(DateTime)

Gibt die Ortszeit zurück, die einem angegebenen Datums- und Zeitwert entspricht.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
ToUniversalTime(DateTime)

Gibt die Coordinated Universal Time (UTC) zurück, die einer angegebenen Zeit entspricht.

Gilt für

Siehe auch