TimeZone.GetUtcOffset(DateTime) TimeZone.GetUtcOffset(DateTime) TimeZone.GetUtcOffset(DateTime) TimeZone.GetUtcOffset(DateTime) Method

Определение

Возвращает смещение всеобщего скоординированного времени (UTC) относительно заданного местного времени.Returns the Coordinated Universal Time (UTC) offset for the specified local time.

public:
 abstract TimeSpan GetUtcOffset(DateTime time);
public abstract TimeSpan GetUtcOffset (DateTime time);
abstract member GetUtcOffset : DateTime -> TimeSpan
Public MustOverride Function GetUtcOffset (time As DateTime) As TimeSpan

Параметры

time
DateTime DateTime DateTime DateTime

Значение даты и времени.A date and time value.

Возвраты

Смещение всеобщего скоординированного времени (UTC) относительно time.The Coordinated Universal Time (UTC) offset from time.

Комментарии

Этот метод возвращает смещение или разность между time параметр и временем в формате UTC.This method returns the offset, or difference, between the time parameter and Coordinated Universal Time (UTC). Это означает следующее:That is:

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

Этот метод интерпретирует часовой пояс time на основе его Kind свойство.The method interprets the time zone of time based on its Kind property. Если значение Kind свойство DateTimeKind.Local или DateTimeKind.Unspecified, метод возвращает смещение местного часового пояса.If the value of the Kind property is DateTimeKind.Local or DateTimeKind.Unspecified, the method returns the offset of the local time zone. Если значение Kind свойство DateTimeKind.Utc, метод возвращает смещение равно TimeSpan.Zero.If the value of the Kind property is DateTimeKind.Utc, the method returns an offset equal to TimeSpan.Zero.

Если местный часовой пояс обнаруживает летнего времени, GetUtcOffset применяется текущее правило коррекции для time при определении смещение местного часового пояса.If the local time zone observes daylight saving time, GetUtcOffset applies the current adjustment rule to time when determining the offset of the local time zone. То есть смещение, возвращенный GetUtcOffset отражает ли time попадает в стандартное время часового пояса или его летнее время.That is, the offset returned by GetUtcOffset reflects whether time falls in the time zone's standard time or its daylight saving time.

Примечание

GetUtcOffset Метод распознает только текущее правило коррекции летнего времени, для местного часового пояса.The GetUtcOffset method recognizes only the current daylight saving time adjustment rule for the local time zone. Таким образом гарантируется возврат точного смещение UTC в местное время только в течение периода, в котором фактически является последнее правило коррекции.As a result, it is guaranteed to accurately return the UTC offset of a local time only during the period in which the latest adjustment rule is in effect. Он может возвращать неточные результаты, если time является исторические значения даты и времени, когда действовало предыдущее правило коррекции.It may return inaccurate results if time is a historic date and time value that was subject to a previous adjustment rule.

GetUtcOffset Метод соответствует TimeZoneInfo.GetUtcOffset метод.The GetUtcOffset method corresponds to the TimeZoneInfo.GetUtcOffset method. По возможности используйте TimeZoneInfo.GetUtcOffset метод.Whenever possible, use the TimeZoneInfo.GetUtcOffset method.

Так как значение даты и времени, представленное time и это значение смещения относительно времени UTC не связаны тесно, дату локальной или не задан, и значение времени может возвращать разные значения смещения при на разных компьютерах или при запуске на том же компьютере в разные часовые пояса.Because the date and time value represented by time and this value's offset from UTC are not tightly coupled, a local or unspecified date and time value can return a different offset value when run on different computers or when run on the same computer under different time zones. Если такое поведение нежелательно, используйте DateTimeOffset вместо этого значения.If this behavior is undesirable, use a DateTimeOffset value instead. DateTimeOffset Тип данных жестко связывает значение даты и времени с его смещение от времени UTC.The DateTimeOffset data type tightly couples a date and time value with its offset from UTC.

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

Дополнительно