TimeZone.GetUtcOffset(DateTime) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает смещение всеобщего скоординированного времени (UTC) относительно заданного местного времени.
public:
abstract TimeSpan GetUtcOffset(DateTime time);public abstract TimeSpan GetUtcOffset (DateTime time);abstract member GetUtcOffset : DateTime -> TimeSpanPublic MustOverride Function GetUtcOffset (time As DateTime) As TimeSpanПараметры
- time
- DateTime
Значение даты и времени.
Возвращаемое значение
Смещение всеобщего скоординированного времени (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.
