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 + offsettime = 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.

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

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