TimeZoneInfo Класс

Определение

Представляет любой часовой пояс в мире.

public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>
public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>
public sealed class TimeZoneInfo : 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>
type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface IDeserializationCallback
    interface ISerializable
type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface ISerializable
    interface IDeserializationCallback
type TimeZoneInfo = class
    interface IDeserializationCallback
    interface ISerializable
    interface IEquatable<TimeZoneInfo>
[<System.Serializable>]
type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface ISerializable
    interface IDeserializationCallback
Public NotInheritable Class TimeZoneInfo
Implements IEquatable(Of TimeZoneInfo)
Public NotInheritable Class TimeZoneInfo
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo), ISerializable
Наследование
TimeZoneInfo
Атрибуты
Реализации

Комментарии

Часовой пояс — это географическая область, в которой действует одно и то же время.

Класс TimeZoneInfo предлагает значительные улучшения по сравнению с классом TimeZone , который предоставляет только ограниченные функциональные возможности.

Класс TimeZone распознает только локальный часовой пояс и может преобразовывать время между универсальным временем в формате UTC и местным временем. TimeZoneInfo Объект может представлять любой часовой пояс, а методы TimeZoneInfo класса можно использовать для преобразования времени в один часовой пояс в соответствующий часовой пояс в любой другой часовой пояс. Члены TimeZoneInfo класса поддерживают следующие операции:

  • Получение часового пояса, который уже определен операционной системой.

  • Перечисление часовых поясов, доступных в системе.

  • Преобразование времени между различными часовых поясами.

  • Создание нового часового пояса, который еще не определен операционной системой.

  • Сериализация часового пояса для последующего извлечения.

Примечание

Экземпляр TimeZoneInfo класса неизменяем. После создания экземпляра объекта его значения нельзя изменить.

Невозможно создать экземпляр TimeZoneInfo объекта с помощью ключевого new слова. Вместо этого необходимо вызвать один из статических членов класса, показанного TimeZoneInfo в следующей таблице.

Имя статического члена Описание
Метод CreateCustomTimeZone Создает пользовательский часовой пояс из предоставленных приложением данных.
Метод FindSystemTimeZoneById Создает экземпляр часового пояса на основе его идентификатора.
Метод FromSerializedString Десериализует строковое значение для повторного создания ранее сериализованного TimeZoneInfo объекта.
Метод GetSystemTimeZones Возвращает перечисление ReadOnlyCollection<T> TimeZoneInfo объектов, представляющих все часовые пояса, доступные в локальной системе.
СвойствоLocal TimeZoneInfo Создает экземпляр объекта, представляющего локальный часовой пояс.
СвойствоUtc TimeZoneInfo Создает экземпляр объекта, представляющего зону UTC.

Этот метод можно использовать для CreateCustomTimeZone создания часового пояса, который не определен в локальном системном реестре в системах Windows или по классам часового пояса в библиотеке ICU в Linux или macOS. Затем можно использовать ToSerializedString свойство для сохранения сведений объекта часового пояса в виде строки, которая может храниться в какой-то форме, доступной приложению. Метод можно использовать для FromSerializedString преобразования сериализованной строки обратно в TimeZoneInfo объект.

Свойства

BaseUtcOffset

Возвращает разницу между зимним временем в текущем часовом поясе и временем в формате UTC.

DaylightName

Возвращает отображаемое имя для летнего времени текущего часового пояса.

DisplayName

Возвращает универсальное отображаемое имя, представляющее часовой пояс.

HasIanaId

Возвращает значение, true если этот объект TimeZoneInfo имеет идентификатор IANA.

Id

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

Local

Возвращает объект TimeZoneInfo, представляющий местный часовой пояс.

StandardName

Возвращает отображаемое имя для зимнего времени часового пояса.

SupportsDaylightSavingTime

Возвращает значение, позволяющее определить, заданы ли для часового пояса какие-либо правила перехода на летнее время.

Utc

Возвращает объект TimeZoneInfo, представляющий часовой пояс UTC.

Методы

ClearCachedData()

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

ConvertTime(DateTime, TimeZoneInfo)

Преобразует время во время в заданном часовом поясе.

ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)

Преобразует время в одном часовом поясе во время в другом.

ConvertTime(DateTimeOffset, TimeZoneInfo)

Преобразует время во время в заданном часовом поясе.

ConvertTimeBySystemTimeZoneId(DateTime, String)

Преобразует время во время в другом часовом поясе, исходя из идентификатора этого пояса.

ConvertTimeBySystemTimeZoneId(DateTime, String, String)

Преобразует время в одном часовом поясе во время в другом, исходя из идентификаторов этих поясов.

ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)

Преобразует время во время в другом часовом поясе, исходя из идентификатора этого пояса.

ConvertTimeFromUtc(DateTime, TimeZoneInfo)

Преобразует время в формате UTC во время в указанном часовом поясе.

ConvertTimeToUtc(DateTime)

Преобразует указанные дату и время в формат UTC.

ConvertTimeToUtc(DateTime, TimeZoneInfo)

Преобразует время в указанном часовом поясе в формат UTC.

CreateCustomTimeZone(String, TimeSpan, String, String)

Создает пользовательский часовой пояс с указанным идентификатором, смещением от времени в формате UTC, отображаемым именем, а также отображаемым именем зимнего времени.

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

Создает пользовательский часовой пояс с указанным идентификатором, смещением от времени в формате UTC, отображаемым именем, именем зимнего времени, именем летнего времени и правилами коррекции для летнего времени.

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

Создает пользовательский часовой пояс с указанным идентификатором, смещением от времени в формате UTC, отображаемым именем, именем зимнего времени, именем летнего времени, правилами коррекции для летнего времени и значением, позволяющим определить, отражает ли возвращаемый объект сведения о летнем времени.

Equals(Object)

Определяет, равен ли текущий объект TimeZoneInfo другому объекту.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
Equals(TimeZoneInfo)

Определяет, равен ли текущий объект TimeZoneInfo другому объекту TimeZoneInfo.

FindSystemTimeZoneById(String)

Создает новый экземпляр объекта TimeZoneInfo на основе его идентификатора.

FromSerializedString(String)

Десериализует строку для повторного создания исходного сериализованного объекта TimeZoneInfo.

GetAdjustmentRules()

Извлекает массив объектов TimeZoneInfo.AdjustmentRule, который применяется к текущему объекту TimeZoneInfo.

GetAmbiguousTimeOffsets(DateTime)

Возвращает сведения о возможных датах и времени, с которыми можно сопоставить неоднозначные значения этих величин.

GetAmbiguousTimeOffsets(DateTimeOffset)

Возвращает сведения о возможных датах и времени, с которыми можно сопоставить неоднозначные значения этих величин.

GetHashCode()

Служит хэш-функцией для алгоритмов хэширования и таких структур данных, как хэш-таблицы.

GetSystemTimeZones()

Возвращает отсортированную коллекцию всех часовых поясов, сведения о которых доступны в локальной системе.

GetType()

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

(Унаследовано от Object)
GetUtcOffset(DateTime)

Вычисляет для определенной даты и времени смещение или разность между временем в данном часовом поясе и временем в формате UTC.

GetUtcOffset(DateTimeOffset)

Вычисляет для определенной даты и времени смещение или разность между временем в данном часовом поясе и временем в формате UTC.

HasSameRules(TimeZoneInfo)

Указывает, совпадают ли правила коррекции текущего объекта и другого объекта TimeZoneInfo.

IsAmbiguousTime(DateTime)

Определяет, являются ли заданная дата и время в заданном часовом поясе неоднозначными и можно ли им сопоставить два и более момента времени в формате UTC.

IsAmbiguousTime(DateTimeOffset)

Определяет, являются ли заданная дата и время в заданном часовом поясе неоднозначными и можно ли им сопоставить два и более момента времени в формате UTC.

IsDaylightSavingTime(DateTime)

Указывает, попадают ли заданные дата и время в диапазон летнего времени для часового пояса текущего объекта TimeZoneInfo.

IsDaylightSavingTime(DateTimeOffset)

Указывает, попадают ли заданные дата и время в диапазон летнего времени для часового пояса текущего объекта TimeZoneInfo.

IsInvalidTime(DateTime)

Указывает, являются ли определенная дата и время допустимыми.

MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToSerializedString()

Преобразует текущий объект TimeZoneInfo в сериализованную строку.

ToString()

Возвращает отображаемое имя текущего объекта TimeZoneInfo.

TryConvertIanaIdToWindowsId(String, String)

Пытается преобразовать идентификатор часового пояса IANA в идентификатор Windows.

TryConvertWindowsIdToIanaId(String, String)

Пытается преобразовать идентификатор часового пояса Windows в идентификатор IANA.

TryConvertWindowsIdToIanaId(String, String, String)

Пытается преобразовать идентификатор часового пояса Windows в идентификатор IANA.

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

IDeserializationCallback.OnDeserialization(Object)

Выполняется после завершения десериализации объекта.

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Заполняет объект SerializationInfo данными, необходимыми для сериализации текущего объекта TimeZoneInfo.

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