TimeZoneInfo Класс

Определение

Пространство имен:

System

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

TimeZoneInfo.cs

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

public ref class TimeZoneInfo sealed : IEquatable<TimeZoneInfo ^>, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public sealed class TimeZoneInfo : IEquatable<TimeZoneInfo>, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

type TimeZoneInfo = class
    interface IEquatable<TimeZoneInfo>
    interface IDeserializationCallback
    interface ISerializable

Public NotInheritable Class TimeZoneInfo
Implements IDeserializationCallback, IEquatable(Of TimeZoneInfo), ISerializable

Наследование

Object

TimeZoneInfo

Реализации

IEquatable<TimeZoneInfo> IDeserializationCallback ISerializable

Комментарии

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

Класс 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, TimeZoneInfo)	Преобразует время из одного часового пояса в другой.
ConvertTime(DateTime, TimeZoneInfo)	Преобразует время в определенный часовой пояс.
ConvertTime(DateTimeOffset, TimeZoneInfo)	Преобразует время в определенный часовой пояс.
ConvertTimeBySystemTimeZoneId(DateTime, String, String)	Преобразует время из одного часового пояса в другой на основе идентификаторов часового пояса.
ConvertTimeBySystemTimeZoneId(DateTime, String)	Преобразует время в время в другом часовом поясе на основе идентификатора часового пояса.
ConvertTimeBySystemTimeZoneId(DateTimeOffset, String)	Преобразует время в время в другом часовом поясе на основе идентификатора часового пояса.
ConvertTimeFromUtc(DateTime, TimeZoneInfo)	Преобразует координированное универсальное время (UTC) в время в указанном часовом поясе.
ConvertTimeToUtc(DateTime, TimeZoneInfo)	Преобразует время в заданном часовом поясе в координированное универсальное время (UTC).
ConvertTimeToUtc(DateTime)	Преобразует указанную дату и время в согласованное универсальное время (UTC).
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[], Boolean)	Создает пользовательский часовой пояс с указанным идентификатором, смещением от координированного универсального времени (UTC), отображаемого имени, стандартного имени времени, имени летнего времени, правил летнего времени и значения, указывающего, отражает ли возвращаемый объект сведения о времени летнего времени.
CreateCustomTimeZone(String, TimeSpan, String, String, String, TimeZoneInfo+AdjustmentRule[])	Создает настраиваемый часовой пояс с заданным идентификатором, смещением от координированного универсального времени (UTC), отображаемого имени, стандартного имени времени, имени летнего времени и правил летнего времени.
CreateCustomTimeZone(String, TimeSpan, String, String)	Создает пользовательский часовой пояс с указанным идентификатором, смещением от координированного универсального времени (UTC), отображаемого имени и стандартного отображаемого имени времени.
Equals(Object)	Определяет, равны ли текущий TimeZoneInfo объект и другой объект.
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, String)	Пытается преобразовать идентификатор часового пояса Windows в идентификатор IANA.
TryConvertWindowsIdToIanaId(String, String)	Пытается преобразовать идентификатор часового пояса Windows в идентификатор IANA.
TryFindSystemTimeZoneById(String, TimeZoneInfo)	Извлекает объект по имени часового пояса TimeZoneInfo .

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

Имя	Описание
IDeserializationCallback.OnDeserialization(Object)	Выполняется при завершении десериализации объекта.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Заполняет объект данными SerializationInfo , необходимыми для сериализации текущего TimeZoneInfo объекта.