DateTimeOffset.ToUniversalTime Метод

Определение

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

System

Сборки:

netstandard.dll, System.Runtime.dll

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

DateTimeOffset.cs

Преобразует текущий объект DateTimeOffset в значение DateTimeOffset, представляющее время в формате UTC.

C#

public DateTimeOffset ToUniversalTime();

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

DateTimeOffset

Объект, представляющий дату и время текущего объекта DateTimeOffset, преобразованную во время в формате UTC.

Примеры

В следующем примере вызывается ToUniversalTime метод для преобразования местного времени и нескольких других раз в время в формате UTC.

C#

DateTimeOffset localTime, otherTime, universalTime;

// Define local time in local time zone
localTime = new DateTimeOffset(new DateTime(2007, 6, 15, 12, 0, 0));
Console.WriteLine("Local time: {0}", localTime);
Console.WriteLine();

// Convert local time to offset 0 and assign to otherTime
otherTime = localTime.ToOffset(TimeSpan.Zero);
Console.WriteLine("Other time: {0}", otherTime);
Console.WriteLine("{0} = {1}: {2}",
                  localTime, otherTime,
                  localTime.Equals(otherTime));
Console.WriteLine("{0} exactly equals {1}: {2}",
                  localTime, otherTime,
                  localTime.EqualsExact(otherTime));
Console.WriteLine();

// Convert other time to UTC
universalTime = localTime.ToUniversalTime();
Console.WriteLine("Universal time: {0}", universalTime);
Console.WriteLine("{0} = {1}: {2}",
                  otherTime, universalTime,
                  universalTime.Equals(otherTime));
Console.WriteLine("{0} exactly equals {1}: {2}",
                  otherTime, universalTime,
                  universalTime.EqualsExact(otherTime));
Console.WriteLine();
// The example produces the following output to the console:
//    Local time: 6/15/2007 12:00:00 PM -07:00
//
//    Other time: 6/15/2007 7:00:00 PM +00:00
//    6/15/2007 12:00:00 PM -07:00 = 6/15/2007 7:00:00 PM +00:00: True
//    6/15/2007 12:00:00 PM -07:00 exactly equals 6/15/2007 7:00:00 PM +00:00: False
//
//    Universal time: 6/15/2007 7:00:00 PM +00:00
//    6/15/2007 7:00:00 PM +00:00 = 6/15/2007 7:00:00 PM +00:00: True
//    6/15/2007 7:00:00 PM +00:00 exactly equals 6/15/2007 7:00:00 PM +00:00: True

Комментарии

Этот метод возвращает объект, DateTimeOffset свойство которого Offset равно нулю.

И значение текущего DateTimeOffset объекта, и значение объекта, DateTimeOffset возвращаемого вызовом метода, представляют одну и ту же точку во времени. То есть, если в метод передаются DateTimeOffset.Equals(DateTimeOffset, DateTimeOffset) оба метода, метод вернет true.

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

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

• ToLocalTime()
• ToOffset(TimeSpan)