TimeZone TimeZone TimeZone TimeZone Class

定義

警告

此 API 現已淘汰。

表示時區。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
繼承
TimeZoneTimeZoneTimeZoneTimeZone
屬性

範例

下列範例會參考並顯示選取TimeZone的類別專案。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.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

備註

時區是使用相同標準時間的地理區域。A time zone is a geographical region in which the same standard time is used.

重要

盡可能使用TimeZoneInfo類別, 而不是TimeZone類別。Whenever possible, use the TimeZoneInfo class instead of the TimeZone class.

您可以使用TimeZone類別來抓取目前時區的相關資訊, 以及將時間從當地時間轉換為國際標準時間 (UTC), 反之亦然。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. 不過, 您不能使用TimeZone類別來代表本機區域以外的時區, 或是處理從某個時區到另一個時區的日期和時間轉換。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. 基於此目的, 請使用TimeZoneInfo類別。For this purpose, use the TimeZoneInfo class. 您可以使用這個類別來抓取本機系統上定義的任何時區資訊、建立自訂時區, 以及將時間從一個時區轉換為另一個時區。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.

TimeZone類別僅支援當地時區的單一日光節約時間調整規則。The TimeZone class supports only a single daylight saving time adjustment rule for the local time zone. 因此, 此TimeZone類別可以精確地報告日光節約時間資訊, 或只針對最新調整規則生效的期間, 在 UTC 與當地時間之間轉換。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. 相反地, TimeZoneInfo類別支援多個調整規則, 讓您可以使用歷史時區資料。In contrast, the TimeZoneInfo class supports multiple adjustment rules, which makes it possible to work with historic time zone data.

給繼承者的注意事項

除了提供其abstract成員的實作為 (Visual Basic 中標示MustOverride的), 請務必將衍生自TimeZone的類別覆寫ToLocalTime(DateTime)方法的預設行為。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. 這是因為ToLocalTime(DateTime)在 .NET Framework 版本2.0 中的預設行為不會相依于的GetUtcOffset(DateTime)呼叫, 如同在 .NET Framework 版本1.0 和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. 如需詳細資訊, ToLocalTime(DateTime)請參閱方法。For details, see the ToLocalTime(DateTime) method.

建構函式

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

初始化 TimeZone 類別的新執行個體。Initializes a new instance of the TimeZone class.

屬性

CurrentTimeZone CurrentTimeZone CurrentTimeZone CurrentTimeZone

取得目前電腦的時區。Gets the time zone of the current computer.

DaylightName DaylightName DaylightName DaylightName

取得日光節約時區名稱。Gets the daylight saving time zone name.

StandardName StandardName StandardName StandardName

取得標準時區名稱。Gets the standard time zone name.

方法

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

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

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

傳回特定年份的日光節約時期。Returns the daylight saving time period for a particular year.

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

做為預設雜湊函式。Serves as the default hash function.

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

取得目前執行個體的 TypeGets the Type of the current instance.

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

傳回指定之當地時間的 Coordinated Universal Time (UTC) 位移。Returns the Coordinated Universal Time (UTC) offset for the specified local time.

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

傳回數值,指示指定的日期和時間是否在日光節約時期之內。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)

傳回數值,指示指定的日期和時間是否在指定的日光節約時期之內。Returns a value indicating whether the specified date and time is within the specified daylight saving time period.

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

建立目前 Object 的淺層複本 (Shallow Copy)。Creates a shallow copy of the current Object.

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

傳回對應到指定之日期與時間值的本地時間。Returns the local time that corresponds to a specified date and time value.

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

傳回代表目前物件的字串。Returns a string that represents the current object.

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

傳回對應到某個指定時間的 Coordinated Universal Time (UTC)。Returns the Coordinated Universal Time (UTC) that corresponds to a specified time.

適用於

另請參閱