TimeZone 클래스

정의

경고

이 API는 현재 사용되지 않습니다.

표준 시간대를 나타냅니다.Represents a time zone.

public ref class TimeZone abstract
public abstract class TimeZone
[System.Obsolete("System.TimeZone has been deprecated.  Please investigate the use of System.TimeZoneInfo instead.")]
public abstract class TimeZone
[System.Serializable]
public abstract class TimeZone
[System.Runtime.InteropServices.ComVisible(true)]
[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.

중요

가능 하면 TimeZone 클래스 대신 TimeZoneInfo 클래스를 사용 합니다.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.

구현자 참고

Visual Basic에서 MustOverride 표시 된 abstract 멤버에 대 한 구현을 제공 하는 것 외에도 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. 이는 .NET Framework 버전 2.0에 있는 ToLocalTime(DateTime)의 기본 동작이 .NET Framework 버전 1.0 및 1.1에서와 같이 GetUtcOffset(DateTime)에 대 한 호출에 의존 하지 않기 때문입니다.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.

적용 대상

추가 정보