TimeZone.GetUtcOffset(DateTime) Метод

Определение

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

System

Сборки:

netstandard.dll, System.Runtime.dll

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

TimeZone.cs

Возвращает смещение всеобщего скоординированного времени (UTC) относительно заданного местного времени.

C#

public abstract TimeSpan GetUtcOffset(DateTime time);

Параметры

time

DateTime

Значение даты и времени.

Возвращаемое значение

TimeSpan

Смещение всеобщего скоординированного времени (UTC) относительно time.

Комментарии

Этот метод возвращает смещение или разницу между параметром time и универсальным временем в формате UTC. Это означает следующее:

time = UTC + смещение

Метод интерпретирует часовой пояс на time основе его Kind свойства . Если значение Kind свойства равно DateTimeKind.Local или DateTimeKind.Unspecified, метод возвращает смещение местного часового пояса. Если свойство имеет DateTimeKind.Utcзначение Kind , метод возвращает смещение, равное TimeSpan.Zero.

Если в местном часовом поясе используется летнее время, GetUtcOffset при определении смещения местного часового пояса применяется текущее правило time корректировки. То есть смещение, возвращаемое параметром GetUtcOffset , отражает, падает ли time в стандартное время часового пояса или летнее время.

Примечание

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

Метод GetUtcOffset соответствует методу TimeZoneInfo.GetUtcOffset . По возможности используйте TimeZoneInfo.GetUtcOffset метод .

Поскольку значение даты и времени, представленное time и смещение этого значения от UTC, не тесно связаны, локальное или неопределенное значение даты и времени может возвращать другое значение смещения при выполнении на разных компьютерах или при выполнении на одном компьютере в разных часовых поясах. Если такое поведение нежелательно, используйте DateTimeOffset вместо него значение . Тип DateTimeOffset данных тесно связан со значением даты и времени со смещением от UTC.

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

См. также раздел

• GetUtcOffset(DateTime)