TimeZoneInfo 클래스

정의

세계의 특정 표준 시간대를 나타냅니다.Represents any time zone in the world.

public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
[System.Serializable]
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface ISerializable
    interface IDeserializationCallback
Public NotInheritable Class TimeZoneInfo
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo), ISerializable
상속
TimeZoneInfo
특성
구현

설명

표준 시간대는 동일한 시간이 사용되는 지리적 영역입니다.A time zone is a geographical region in which the same time is used.

TimeZoneInfo 클래스에 비해 크게 향상 된 TimeZone 제한 된 기능만 제공 하는 클래스입니다.The TimeZoneInfo class offers significant enhancements over the TimeZone class, which provides only limited functionality.

TimeZone 클래스는 로컬 표준 시간대만을 인식 하 고 (UTC) 협정 세계시와 현지 시간 사이의 시간을 변환할 수 있습니다.The TimeZone class recognizes only the local time zone, and can convert times between Coordinated Universal Time (UTC) and local time. A TimeZoneInfo 개체의 메서드와 모든 표준 시간대를 나타낼 수 있습니다는 TimeZoneInfo 클래스를 사용 하 여 다른 표준 시간대의 해당 시간에 한 표준 시간대의 시간을 변환할 수 있습니다.A TimeZoneInfo object can represent any time zone, and methods of the TimeZoneInfo class can be used to convert the time in one time zone to the corresponding time in any other time zone. 멤버는 TimeZoneInfo 클래스 작업을 지원 합니다.The members of the TimeZoneInfo class support the following operations:

  • 운영 체제에서 이미 정의 되어 있는 표준 시간대를 검색 합니다.Retrieving a time zone that is already defined by the operating system.

  • 시스템에서 사용할 수 있는 표준 시간대를 열거 합니다.Enumerating the time zones that are available on a system.

  • 다른 표준 시간대 간에 시간 변환 합니다.Converting times between different time zones.

  • 운영 체제에서 이미 정의 되지 않은 새 표준 시간대를 만드는 중입니다.Creating a new time zone that is not already defined by the operating system.

  • 나중에 검색할 표준 시간대를 직렬화 합니다.Serializing a time zone for later retrieval.

참고

인스턴스는 TimeZoneInfo 클래스는 변경할 수 없습니다.An instance of the TimeZoneInfo class is immutable. 개체는 인스턴스화된 후에 해당 값을 수정할 수 없습니다.Once an object has been instantiated, its values cannot be modified.

인스턴스화할 수 없습니다는 TimeZoneInfo 를 사용 하 여 개체를 new 키워드입니다.You cannot instantiate a TimeZoneInfo object using the new keyword. 정적 멤버 중 하나를 호출 해야 합니다는 대신는 TimeZoneInfo 다음 표에 나와 있는 클래스입니다.Instead, you must call one of the static members of the TimeZoneInfo class shown in the following table.

정적 멤버 이름Static member name 설명Description
CreateCustomTimeZone 메서드CreateCustomTimeZone method 애플리케이션에서 제공한 데이터에서 사용자 지정 표준 시간대를 만듭니다.Creates a custom time zone from application-supplied data.
FindSystemTimeZoneById 메서드FindSystemTimeZoneById method 식별자를 기반으로 표준 시간대를 인스턴스화합니다.Instantiates a time zone based on its identifier.
FromSerializedString 메서드FromSerializedString method 만들려는 다시 이전에 직렬화 된 문자열 값을 deserialize TimeZoneInfo 개체입니다.Deserializes a string value to re-create a previously serialized TimeZoneInfo object.
GetSystemTimeZones 메서드GetSystemTimeZones method 열거형을 반환 ReadOnlyCollection<T>TimeZoneInfo 로컬 시스템에서 사용할 수 있는 모든 표준 시간대를 나타내는 개체입니다.Returns an enumerable ReadOnlyCollection<T> of TimeZoneInfo objects that represents all time zones that are available on the local system.
Local 속성Local property 인스턴스화하는 TimeZoneInfo 현지 표준 시간대를 나타내는 개체입니다.Instantiates a TimeZoneInfo object that represents the local time zone.
Utc 속성Utc property 인스턴스화하는 TimeZoneInfo UTC 표준 시간대를 나타내는 개체입니다.Instantiates a TimeZoneInfo object that represents the UTC zone.

메서드를 CreateCustomTimeZone 사용 하 여 Windows 시스템의 로컬 시스템 레지스트리 또는 Linux 또는 macos의 ICU 라이브러리 에 있는 표준 시간대 클래스에서 정의 되지 않은 표준 시간대를 만들 수 있습니다.You can use the CreateCustomTimeZone method to create a time zone that is not defined in the local system registry on Windows systems or by the time zone classes in the ICU Library on Linux or macOS. 사용할 수는 ToSerializedString 문자열로 서, 애플리케이션에 액세스할 수 있는 몇 가지 형태로 저장할 수 있는 표준 시간대 개체의 정보를 저장 하는 속성입니다.You can then use the ToSerializedString property to save the time zone object's information as a string, which can be stored in some form that is accessible to the application. 사용할 수는 FromSerializedString 직렬화 된 문자열을 변환 하는 방법으로는 TimeZoneInfo 개체입니다.You can use the FromSerializedString method to convert a serialized string back to a TimeZoneInfo object.

속성

BaseUtcOffset

현재 표준 시간대의 표준 시간과 UTC(협정 세계시) 사이의 시간 차이를 가져옵니다.Gets the time difference between the current time zone's standard time and Coordinated Universal Time (UTC).

DaylightName

현재 표준 시간대 일광 절약 시간의 표시 이름을 가져옵니다.Gets the display name for the current time zone's daylight saving time.

DisplayName

해당 표준 시간대를 나타내는 일반 표시 이름을 가져옵니다.Gets the general display name that represents the time zone.

Id

표준 시간대 식별자를 가져옵니다.Gets the time zone identifier.

Local

현지 표준 시간대를 나타내는 TimeZoneInfo 개체를 가져옵니다.Gets a TimeZoneInfo object that represents the local time zone.

StandardName

해당 표준 시간대의 표준 시간을 나타내는 표시 이름을 가져옵니다.Gets the display name for the time zone's standard time.

SupportsDaylightSavingTime

해당 표준 시간대에 일광 절약 시간 규칙이 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the time zone has any daylight saving time rules.

Utc

UTC를 나타내는 TimeZoneInfo 개체를 가져옵니다.Gets a TimeZoneInfo object that represents the Coordinated Universal Time (UTC) zone.

메서드

ClearCachedData()

캐시된 표준 시간대 데이터를 지웁니다.Clears cached time zone data.

ConvertTime(DateTime, TimeZoneInfo)

시간을 특정 표준 시간대의 시간으로 변환합니다.Converts a time to the time in a particular time zone.

ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)

시간을 한 표준 시간대에서 다른 표준 시간대로 변환합니다.Converts a time from one time zone to another.

ConvertTime(DateTimeOffset, TimeZoneInfo)

시간을 특정 표준 시간대의 시간으로 변환합니다.Converts a time to the time in a particular time zone.

ConvertTimeBySystemTimeZoneId(DateTime, String)

표준 시간대 식별자를 기반으로 하여 시간을 다른 표준 시간대의 시간으로 변환합니다.Converts a time to the time in another time zone based on the time zone's identifier.

ConvertTimeBySystemTimeZoneId(DateTime, String, String)

표준 시간대 식별자를 기반으로 하여 시간을 한 표준 시간대에서 다른 표준 시간대로 변환합니다.Converts a time from one time zone to another based on time zone identifiers.

ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)

표준 시간대 식별자를 기반으로 하여 시간을 다른 표준 시간대의 시간으로 변환합니다.Converts a time to the time in another time zone based on the time zone's identifier.

ConvertTimeFromUtc(DateTime, TimeZoneInfo)

UTC(협정 세계시)를 지정된 표준 시간대의 시간으로 변환합니다.Converts a Coordinated Universal Time (UTC) to the time in a specified time zone.

ConvertTimeToUtc(DateTime)

지정된 날짜 및 시간을 UTC(협정 세계시)로 변환합니다.Converts the specified date and time to Coordinated Universal Time (UTC).

ConvertTimeToUtc(DateTime, TimeZoneInfo)

지정된 표준 시간대의 시간을 UTC(협정 세계시)로 변환합니다.Converts the time in a specified time zone to Coordinated Universal Time (UTC).

CreateCustomTimeZone(String, TimeSpan, String, String)

지정된 식별자, UTC(협정 세계시)로부터의 오프셋, 표시 이름 및 표준 시간 표시 이름으로 사용자 지정 표준 시간대를 만듭니다.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, and a standard time display name.

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[])

지정된 식별자, UTC(협정 세계시)로부터의 오프셋, 표시 이름, 표준 시간 이름, 일광 절약 시간 이름 및 일광 절약 시간 규칙으로 사용자 지정 표준 시간대를 만듭니다.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, a standard time name, a daylight saving time name, and daylight saving time rules.

CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean)

지정된 식별자, UTC(협정 세계시)로부터의 오프셋, 표시 이름, 표준 시간 이름, 일광 절약 시간 이름, 일광 절약 시간 규칙 및 반환된 개체가 일광 절약 시간 정보를 반영하는지 여부를 나타내는 값으로 사용자 지정 표준 시간대를 만듭니다.Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, a standard time name, a daylight saving time name, daylight saving time rules, and a value that indicates whether the returned object reflects daylight saving time information.

Equals(Object)

현재 TimeZoneInfo 개체가 다른 개체와 같은지 확인합니다.Determines whether the current TimeZoneInfo object and another object are equal.

Equals(TimeZoneInfo)

현재 TimeZoneInfo 개체가 다른 TimeZoneInfo 개체와 같은지 확인합니다.Determines whether the current TimeZoneInfo object and another TimeZoneInfo object are equal.

FindSystemTimeZoneById(String)

해당 식별자에 따라 새 TimeZoneInfo 개체를 인스턴스화합니다.Instantiates a new TimeZoneInfo object based on its identifier.

FromSerializedString(String)

문자열을 deserialize하여 원래의 serialize된 TimeZoneInfo 개체를 다시 만듭니다.Deserializes a string to re-create an original serialized TimeZoneInfo object.

GetAdjustmentRules()

현재 TimeZoneInfo.AdjustmentRule 개체에 적용되는 TimeZoneInfo 개체 배열을 가져옵니다.Retrieves an array of TimeZoneInfo.AdjustmentRule objects that apply to the current TimeZoneInfo object.

GetAmbiguousTimeOffsets(DateTime)

모호한 날짜 및 시간을 매핑할 수 있는 가능한 날짜 및 시간에 대한 정보를 반환합니다.Returns information about the possible dates and times that an ambiguous date and time can be mapped to.

GetAmbiguousTimeOffsets(DateTimeOffset)

모호한 날짜 및 시간을 매핑할 수 있는 가능한 날짜 및 시간에 대한 정보를 반환합니다.Returns information about the possible dates and times that an ambiguous date and time can be mapped to.

GetHashCode()

해시 테이블과 같은 데이터 구조 및 해싱 알고리즘을 위한 해시 함수 역할을 합니다.Serves as a hash function for hashing algorithms and data structures such as hash tables.

GetSystemTimeZones()

로컬 시스템에서 사용할 수 있는 정보에 대한 모든 정렬된 표준 시간대 컬렉션을 반환합니다.Returns a sorted collection of all the time zones about which information is available on the local system.

GetType()

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

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

이 표준 시간대의 시간과 특정 날짜 및 시간에 대한 UTC 사이의 오프셋 또는 차이를 계산합니다.Calculates the offset or difference between the time in this time zone and Coordinated Universal Time (UTC) for a particular date and time.

GetUtcOffset(DateTimeOffset)

이 표준 시간대의 시간과 특정 날짜 및 시간에 대한 UTC 사이의 오프셋 또는 차이를 계산합니다.Calculates the offset or difference between the time in this time zone and Coordinated Universal Time (UTC) for a particular date and time.

HasSameRules(TimeZoneInfo)

현재 개체 및 다른 TimeZoneInfo 개체에 같은 조정 규칙이 있는지 여부를 나타냅니다.Indicates whether the current object and another TimeZoneInfo object have the same adjustment rules.

IsAmbiguousTime(DateTime)

특정 표준 시간대의 특정 날짜 및 시간이 모호한지 여부와 이를 둘 이상의 UTC 시간에 매핑할 수 있는지 여부를 결정합니다.Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

IsAmbiguousTime(DateTimeOffset)

특정 표준 시간대의 특정 날짜 및 시간이 모호한지 여부와 이를 둘 이상의 UTC 시간에 매핑할 수 있는지 여부를 결정합니다.Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

IsDaylightSavingTime(DateTime)

지정된 날짜 및 시간이 현재 TimeZoneInfo 개체의 표준 시간대에 대한 일광 절약 시간 범위에 속하는지 여부를 나타냅니다.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

IsDaylightSavingTime(DateTimeOffset)

지정된 날짜 및 시간이 현재 TimeZoneInfo 개체의 표준 시간대에 대한 일광 절약 시간 범위에 속하는지 여부를 나타냅니다.Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current TimeZoneInfo object.

IsInvalidTime(DateTime)

특정 날짜 및 시간이 올바르지 않은지 여부를 나타냅니다.Indicates whether a particular date and time is invalid.

MemberwiseClone()

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

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

현재 TimeZoneInfo 개체를 serialize된 문자열로 변환합니다.Converts the current TimeZoneInfo object to a serialized string.

ToString()

현재 TimeZoneInfo 개체의 표시 이름을 반환합니다.Returns the current TimeZoneInfo object's display name.

명시적 인터페이스 구현

IDeserializationCallback.OnDeserialization(Object)

개체의 deserialization이 완료될 때 실행됩니다.Runs when the deserialization of an object has been completed.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

현재 SerializationInfo 개체를 serialize하는 데 필요한 데이터로 TimeZoneInfo 개체를 채웁니다.Populates a SerializationInfo object with the data needed to serialize the current TimeZoneInfo object.

적용 대상