TimeZone.ToUniversalTime(DateTime) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает всеобщее скоординированное время (UTC), соответствующее указанному местному времени.
public:
virtual DateTime ToUniversalTime(DateTime time);public virtual DateTime ToUniversalTime (DateTime time);abstract member ToUniversalTime : DateTime -> DateTime
override this.ToUniversalTime : DateTime -> DateTimePublic Overridable Function ToUniversalTime (time As DateTime) As DateTimeПараметры
- time
- DateTime
Дата и время.
Возвращаемое значение
Объект DateTime, значением которого является время UTC, соответствующее time.
Комментарии
Если в местном часовом поясе наблюдается летнее время, ToUniversalTime при выполнении преобразования применяется текущее правило корректировки к time параметру.
Примечание
Этот ToUniversalTime метод распознает только текущее правило корректировки летнего времени для местного часового пояса. В результате гарантированно возвращается точное универсальное время в формате UTC, соответствующее определенному местному времени только в течение периода, в течение которого действует последнее правило корректировки. Он может возвращать неточные результаты, если time это историческое значение даты и времени, на которое распространяется предыдущее правило корректировки.
time Если параметр является неоднозначным временем, метод предполагает, что это стандартное время. (Неоднозначное время — это время, которое может сопоставляться либо со стандартным временем, либо с летнего времени в местном часовом поясе.) Если time это недопустимое время, метод просто вычитает местное время из смещения utc местного часового пояса для возврата UTC. (Недопустимое время не существует из-за применения правил корректировки летнего времени.)
Поскольку time интерпретируется относительно текущего часового пояса в текущей системе, дата и время, возвращаемые этим методом, могут отличаться, если приложение выполняется на разных компьютерах или на одном компьютере с разными часовыми поясами. В случаях, когда значение даты и времени должно представлять один, однозначно определенный момент времени, используйте DateTimeOffset значение для представления местного времени.
Метод ToUniversalTime соответствует перегрузке TimeZoneInfo.ConvertTimeToUtc(DateTime) метода с параметром DateTime , свойство которого Kind не равно DateTimeKind.Utc. По возможности используйте перегрузку TimeZoneInfo.ConvertTimeToUtc(DateTime) метода.