Поделиться через


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()

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

GetSystemTimeZones(Boolean)

Возвращает объект , ReadOnlyCollection<T> содержащий все допустимые часовые пояса с локального компьютера. Этот метод не вызывает исключение TimeZoneNotFoundException или InvalidTimeZoneException.

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.

TryFindSystemTimeZoneById(String, TimeZoneInfo)

Извлекает объект по TimeZoneInfo имени часового пояса.

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

IDeserializationCallback.OnDeserialization(Object)

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

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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

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