TimeZone.ToUniversalTime(DateTime) Метод

Определение

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

System

Сборки:

netstandard.dll, System.Runtime.dll

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

TimeZone.cs

Возвращает универсальное время (UTC), соответствующее заданному времени.

public:
 virtual DateTime ToUniversalTime(DateTime time);

public virtual DateTime ToUniversalTime(DateTime time);

abstract member ToUniversalTime : DateTime -> DateTime
override this.ToUniversalTime : DateTime -> DateTime

Public Overridable Function ToUniversalTime (time As DateTime) As DateTime

Параметры

time

DateTime

Дата и время.

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

DateTime

Объект DateTime , timeзначение которого соответствует универсальному времени (UTC).

Комментарии

Если локальный часовой пояс наблюдает летнее время, ToUniversalTime применяет текущее правило корректировки к time параметру при выполнении преобразования.

Замечание

Метод ToUniversalTime распознает только текущее правило корректировки времени летнего времени для локального часового пояса. В результате гарантируется точное возвращение согласованного универсального времени (UTC), соответствующего определенному местному времени только в течение периода, в течение которого действует последнее правило корректировки. Он может возвращать неточные результаты, если time это историческое значение даты и времени, которое было подвержено предыдущему правилу корректировки.

time Если параметр является неоднозначным временем, метод предполагает, что это стандартное время. (Неоднозначное время — это время, которое может сопоставляться либо со стандартным временем, либо с временем летнего времени в местном часовом поясе.) Если time это недопустимое время, метод просто вычитает локальное время из смещения UTC локального часового пояса, чтобы вернуть UTC. (Недопустимое время — это тот, который не существует из-за применения правил корректировки летнего времени.)

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

Метод ToUniversalTime соответствует перегрузке TimeZoneInfo.ConvertTimeToUtc(DateTime) метода с параметром DateTime , свойство которого Kind не равно DateTimeKind.Utc. По возможности используйте перегрузку TimeZoneInfo.ConvertTimeToUtc(DateTime) метода.

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

• ConvertTimeToUtc(DateTime)