TimeZone 클래스

정의

경고

이 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
상속
TimeZone
특성

예제

다음 예제에서는 참조 및 선택한 표시 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 멤버 (표시 된 MustOverride Visual basic에서), 클래스에서 파생 된 것 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 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the TimeZone class.

속성

CurrentTimeZone

현재 컴퓨터의 표준 시간대를 가져옵니다.Gets the time zone of the current computer.

DaylightName

일광 절약 표준 시간대 이름을 가져옵니다.Gets the daylight saving time zone name.

StandardName

표준 시간대 이름을 가져옵니다.Gets the standard time zone name.

메서드

Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetDaylightChanges(Int32)

특정 연도에 대한 일광 절약 시간 적용 기간을 반환합니다.Returns the daylight saving time period for a particular year.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
GetUtcOffset(DateTime)

지정된 현지 시간에 대한 UTC(협정 세계시) 오프셋을 반환합니다.Returns the Coordinated Universal Time (UTC) offset for the specified local time.

IsDaylightSavingTime(DateTime)

지정된 날짜와 시간이 일광 절약 시간 적용 기간 내에 있는지의 여부를 나타내는 값을 반환합니다.Returns a value indicating whether the specified date and time is within a daylight saving time period.

IsDaylightSavingTime(DateTime, DaylightTime)

지정된 날짜와 시간이 지정된 일광 절약 시간 적용 기간 내에 있는지의 여부를 나타내는 값을 반환합니다.Returns a value indicating whether the specified date and time is within the specified daylight saving time period.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
ToLocalTime(DateTime)

지정된 날짜 및 시간 값에 해당하는 현지 시간을 반환합니다.Returns the local time that corresponds to a specified date and time value.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)
ToUniversalTime(DateTime)

지정된 시간에 해당하는 UTC(협정 세계시)를 반환합니다.Returns the Coordinated Universal Time (UTC) that corresponds to a specified time.

적용 대상

추가 정보