TimeZoneInfo TimeZoneInfo TimeZoneInfo TimeZoneInfo Class

Определение

Представляет любой часовой пояс в мире.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
Наследование
TimeZoneInfoTimeZoneInfoTimeZoneInfoTimeZoneInfo
Атрибуты
Реализации

Комментарии

Часовой пояс — это географическая область, в которой действует одно и то же время.A time zone is a geographical region in which the same time is used.

Класс предлагает значительные улучшения по сравнению с TimeZone классом, который предоставляет ограниченную функциональность. TimeZoneInfoThe 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. Объект может представлять любой часовой пояс, и методы TimeZoneInfo класса можно использовать для преобразования времени в одном часовом поясе в соответствующее время в любом другом часовом поясе. TimeZoneInfoA 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
Метод CreateCustomTimeZoneCreateCustomTimeZone method Создает пользовательский часовой пояс на основе данных, предоставляемых приложением.Creates a custom time zone from application-supplied data.
Метод FindSystemTimeZoneByIdFindSystemTimeZoneById method Создает часовой пояс на основе его идентификатора.Instantiates a time zone based on its identifier.
Метод FromSerializedStringFromSerializedString method Десериализует строковое значение для повторного создания ранее сериализованного TimeZoneInfo объекта.Deserializes a string value to re-create a previously serialized TimeZoneInfo object.
Метод GetSystemTimeZonesGetSystemTimeZones method Возвращает перечислимый ReadOnlyCollection<T> TimeZoneInfo объект, представляющий все часовые пояса, доступные в локальной системе.Returns an enumerable ReadOnlyCollection<T> of TimeZoneInfo objects that represents all time zones that are available on the local system.
СвойствоLocalLocal property TimeZoneInfo Создает объект, представляющий местный часовой пояс.Instantiates a TimeZoneInfo object that represents the local time zone.
СвойствоUtcUtc property TimeZoneInfo Создает объект, представляющий часовой пояс в формате UTC.Instantiates a TimeZoneInfo object that represents the UTC zone.

CreateCustomTimeZone Метод можно использовать для создания часового пояса, не определенного в локальном системном реестре в системах Windows или в классах часовых поясов в библиотеке ICU в Linux или macOS.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 BaseUtcOffset BaseUtcOffset BaseUtcOffset

Возвращает разницу между зимним временем в текущем часовом поясе и временем в формате UTC.Gets the time difference between the current time zone's standard time and Coordinated Universal Time (UTC).

DaylightName DaylightName DaylightName DaylightName

Возвращает отображаемое имя для летнего времени текущего часового пояса.Gets the display name for the current time zone's daylight saving time.

DisplayName DisplayName DisplayName DisplayName

Возвращает универсальное отображаемое имя, представляющее часовой пояс.Gets the general display name that represents the time zone.

Id Id Id Id

Возвращает идентификатор часового пояса.Gets the time zone identifier.

Local Local Local Local

Возвращает объект TimeZoneInfo, представляющий местный часовой пояс.Gets a TimeZoneInfo object that represents the local time zone.

StandardName StandardName StandardName StandardName

Возвращает отображаемое имя для зимнего времени часового пояса.Gets the display name for the time zone's standard time.

SupportsDaylightSavingTime SupportsDaylightSavingTime SupportsDaylightSavingTime SupportsDaylightSavingTime

Возвращает значение, позволяющее определить, заданы ли для часового пояса какие-либо правила перехода на летнее время.Gets a value indicating whether the time zone has any daylight saving time rules.

Utc Utc Utc Utc

Возвращает объект TimeZoneInfo, представляющий часовой пояс UTC.Gets a TimeZoneInfo object that represents the Coordinated Universal Time (UTC) zone.

Методы

ClearCachedData() ClearCachedData() ClearCachedData() ClearCachedData()

Удаляет кэшированные данные о часовом поясе.Clears cached time zone data.

ConvertTime(DateTime, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo)

Преобразует время во время в заданном часовом поясе.Converts a time to the time in a particular time zone.

ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo) ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)

Преобразует время в одном часовом поясе во время в другом.Converts a time from one time zone to another.

ConvertTime(DateTimeOffset, TimeZoneInfo) ConvertTime(DateTimeOffset, TimeZoneInfo) ConvertTime(DateTimeOffset, TimeZoneInfo) ConvertTime(DateTimeOffset, TimeZoneInfo)

Преобразует время во время в заданном часовом поясе.Converts a time to the time in a particular time zone.

ConvertTimeBySystemTimeZoneId(DateTime, String) ConvertTimeBySystemTimeZoneId(DateTime, String) ConvertTimeBySystemTimeZoneId(DateTime, String) ConvertTimeBySystemTimeZoneId(DateTime, String)

Преобразует время во время в другом часовом поясе, исходя из идентификатора этого пояса.Converts a time to the time in another time zone based on the time zone's identifier.

ConvertTimeBySystemTimeZoneId(DateTime, String, String) ConvertTimeBySystemTimeZoneId(DateTime, String, String) ConvertTimeBySystemTimeZoneId(DateTime, String, String) ConvertTimeBySystemTimeZoneId(DateTime, String, String)

Преобразует время в одном часовом поясе во время в другом, исходя из идентификаторов этих поясов.Converts a time from one time zone to another based on time zone identifiers.

ConvertTimeBySystemTimeZoneId(DateTimeOffset, String) ConvertTimeBySystemTimeZoneId(DateTimeOffset, String) ConvertTimeBySystemTimeZoneId(DateTimeOffset, String) ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)

Преобразует время во время в другом часовом поясе, исходя из идентификатора этого пояса.Converts a time to the time in another time zone based on the time zone's identifier.

ConvertTimeFromUtc(DateTime, TimeZoneInfo) ConvertTimeFromUtc(DateTime, TimeZoneInfo) ConvertTimeFromUtc(DateTime, TimeZoneInfo) ConvertTimeFromUtc(DateTime, TimeZoneInfo)

Преобразует время в формате UTC во время в указанном часовом поясе.Converts a Coordinated Universal Time (UTC) to the time in a specified time zone.

ConvertTimeToUtc(DateTime) ConvertTimeToUtc(DateTime) ConvertTimeToUtc(DateTime) ConvertTimeToUtc(DateTime)

Преобразует указанные дату и время в формат UTC.Converts the specified date and time to Coordinated Universal Time (UTC).

ConvertTimeToUtc(DateTime, TimeZoneInfo) ConvertTimeToUtc(DateTime, TimeZoneInfo) ConvertTimeToUtc(DateTime, TimeZoneInfo) ConvertTimeToUtc(DateTime, TimeZoneInfo)

Преобразует время в указанном часовом поясе в формат UTC.Converts the time in a specified time zone to Coordinated Universal Time (UTC).

CreateCustomTimeZone(String, TimeSpan, String, String) CreateCustomTimeZone(String, TimeSpan, String, String) CreateCustomTimeZone(String, TimeSpan, String, String) 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[]) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[]) 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) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean) CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean) 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) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли текущий объект TimeZoneInfo другому объекту.Determines whether the current TimeZoneInfo object and another object are equal.

Equals(TimeZoneInfo) Equals(TimeZoneInfo) Equals(TimeZoneInfo) Equals(TimeZoneInfo)

Определяет, равен ли текущий объект TimeZoneInfo другому объекту TimeZoneInfo.Determines whether the current TimeZoneInfo object and another TimeZoneInfo object are equal.

FindSystemTimeZoneById(String) FindSystemTimeZoneById(String) FindSystemTimeZoneById(String) FindSystemTimeZoneById(String)

Создает новый экземпляр объекта TimeZoneInfo на основе его идентификатора.Instantiates a new TimeZoneInfo object based on its identifier.

FromSerializedString(String) FromSerializedString(String) FromSerializedString(String) FromSerializedString(String)

Десериализует строку для повторного создания исходного сериализованного объекта TimeZoneInfo.Deserializes a string to re-create an original serialized TimeZoneInfo object.

GetAdjustmentRules() GetAdjustmentRules() GetAdjustmentRules() GetAdjustmentRules()

Извлекает массив объектов TimeZoneInfo.AdjustmentRule, который применятся к текущему объекту TimeZoneInfo.Retrieves an array of TimeZoneInfo.AdjustmentRule objects that apply to the current TimeZoneInfo object.

GetAmbiguousTimeOffsets(DateTime) GetAmbiguousTimeOffsets(DateTime) GetAmbiguousTimeOffsets(DateTime) GetAmbiguousTimeOffsets(DateTime)

Возвращает сведения о возможных датах и времени, которым можно сопоставить неоднозначные значения этих величин.Returns information about the possible dates and times that an ambiguous date and time can be mapped to.

GetAmbiguousTimeOffsets(DateTimeOffset) GetAmbiguousTimeOffsets(DateTimeOffset) GetAmbiguousTimeOffsets(DateTimeOffset) GetAmbiguousTimeOffsets(DateTimeOffset)

Возвращает сведения о возможных датах и времени, которым можно сопоставить неоднозначные значения этих величин.Returns information about the possible dates and times that an ambiguous date and time can be mapped to.

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

Служит хэш-функцией для алгоритмов хэширования и таких структур данных, как хэш-таблицы.Serves as a hash function for hashing algorithms and data structures such as hash tables.

GetSystemTimeZones() GetSystemTimeZones() GetSystemTimeZones() GetSystemTimeZones()

Возвращает сохраненную коллекцию всех часовых поясов, сведения о которых доступны в локальной системе.Returns a sorted collection of all the time zones about which information is available on the local system.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetUtcOffset(DateTime) GetUtcOffset(DateTime) GetUtcOffset(DateTime) 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) GetUtcOffset(DateTimeOffset) GetUtcOffset(DateTimeOffset) 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) HasSameRules(TimeZoneInfo) HasSameRules(TimeZoneInfo) HasSameRules(TimeZoneInfo)

Указывает, совпадают ли правила коррекции текущего объекта и другого объекта TimeZoneInfo.Indicates whether the current object and another TimeZoneInfo object have the same adjustment rules.

IsAmbiguousTime(DateTime) IsAmbiguousTime(DateTime) IsAmbiguousTime(DateTime) 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) IsAmbiguousTime(DateTimeOffset) IsAmbiguousTime(DateTimeOffset) 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) IsDaylightSavingTime(DateTime) IsDaylightSavingTime(DateTime) 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) IsDaylightSavingTime(DateTimeOffset) IsDaylightSavingTime(DateTimeOffset) 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) IsInvalidTime(DateTime) IsInvalidTime(DateTime) IsInvalidTime(DateTime)

Указывает, являются ли определенная дата и время допустимыми.Indicates whether a particular date and time is invalid.

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToSerializedString() ToSerializedString() ToSerializedString() ToSerializedString()

Преобразует текущий объект TimeZoneInfo в сериализованную строку.Converts the current TimeZoneInfo object to a serialized string.

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

Возвращает отображаемое имя текущего объекта TimeZoneInfo.Returns the current TimeZoneInfo object's display name.

Явные реализации интерфейса

IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object) IDeserializationCallback.OnDeserialization(Object)

Выполняется после завершения десериализации объекта.Runs when the deserialization of an object has been completed.

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Заполняет объект SerializationInfo данными, необходимыми для сериализации текущего объекта TimeZoneInfo.Populates a SerializationInfo object with the data needed to serialize the current TimeZoneInfo object.

Применяется к