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, метод возвращает смещение локального часового пояса. Если значение Kind свойства равно DateTimeKind.Utc, метод возвращает смещение, равное TimeSpan.Zero.
Если в местном часовом поясе наблюдается летнее время, GetUtcOffset применяется текущее правило time корректировки при определении смещения местного часового пояса. Т. е. смещение, возвращаемое в соответствии со GetUtcOffsettime стандартным временем часового пояса или временем летнего времени.
Замечание
Метод GetUtcOffset распознает только текущее правило корректировки времени летнего времени для локального часового пояса. В результате гарантированно возвращается точное смещение utc локального времени только в течение периода, в течение которого действует последнее правило корректировки. Он может возвращать неточные результаты, если time это историческое значение даты и времени, которое было подвержено предыдущему правилу корректировки.
Метод GetUtcOffset соответствует методу TimeZoneInfo.GetUtcOffset . По возможности используйте TimeZoneInfo.GetUtcOffset метод.
Поскольку значение даты и времени, time представленное и смещение этого значения из UTC, не тесно связаны, локальное или неопределенное значение даты и времени может возвращать другое значение смещения при выполнении на разных компьютерах или при запуске на одном компьютере в разных часовых поясах. Если это поведение нежелательно, используйте DateTimeOffset вместо этого значение. Тип DateTimeOffset данных тесно связывает значение даты и времени со смещением из UTC.
