Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

DateTime.ToUniversalTime Method

Converts the value of the current DateTime object to Coordinated Universal Time (UTC).

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

public:
DateTime ToUniversalTime ()
public DateTime ToUniversalTime ()
public function ToUniversalTime () : DateTime

Return Value

A DateTime object whose Kind property is Utc, and whose value is the UTC equivalent to the value of the current DateTime object, or MaxValue if the converted value is too large to be represented by a DateTime object, or MinValue if the converted value is too small to be represented by a DateTime object.

The UTC time is equal to the local time minus the UTC offset. For more information about the UTC offset, see TimeZone.GetUtcOffset. The conversion also takes into account the daylight saving time rule that applies to the time represented by the current DateTime object.

Starting with the .NET Framework version 2.0, the value returned by the ToUniversalTime method is determined by the Kind property of the current DateTime object. The following table describes the possible results.

Kind

Results

Utc

No conversion is performed.

Local

The current DateTime object is converted to UTC.

Unspecified

The current DateTime object is assumed to be a local time, and the conversion is performed as if Kind were Local.

The value returned by this conversion is a DateTime object whose Kind property is Utc. Consequently, a valid result is returned even if ToUniversalTime is applied repeatedly to the same DateTime object.

This method always uses the local time zone when making calculations.

The following code example demonstrates the ToUniversalTime method.

System::Console::WriteLine( "Enter a date and time." );
String^ strDateTime = System::Console::ReadLine();

System::DateTime localDateTime;
try
{
   localDateTime = System::DateTime::Parse( strDateTime );
}
catch ( System::FormatException^ ) 
{
   System::Console::WriteLine( "Invalid format." );
   return;
}

System::DateTime univDateTime = localDateTime.ToUniversalTime();

System::Console::WriteLine( "{0} local time is {1} universal time.",
   localDateTime, univDateTime );

System::Console::WriteLine( "Enter a date and time in universal time." );
strDateTime = System::Console::ReadLine();

try
{
   univDateTime = System::DateTime::Parse( strDateTime );
}
catch ( System::FormatException^ ) 
{
   System::Console::WriteLine( "Invalid format." );
   return;
}

localDateTime = univDateTime.ToLocalTime();

System::Console::WriteLine( "{0} universal time is {1} local time.",
   univDateTime, localDateTime );

System.Console.WriteLine("Enter a date and time.");
String strDateTime = System.Console.ReadLine();

System.DateTime localDateTime;
try {
    localDateTime = System.DateTime.Parse(strDateTime);
}
catch (System.FormatException exp) {
    System.Console.WriteLine("Invalid format.");
    return;
}
System.DateTime univDateTime = localDateTime.ToUniversalTime();
System.Console.WriteLine("{0} local time is {1} universal time.", 
    localDateTime, univDateTime);
System.Console.WriteLine("Enter a date and time in universal time.");
strDateTime = System.Console.ReadLine();
try {
    univDateTime = System.DateTime.Parse(strDateTime);
}
catch (System.FormatException exp) {
    System.Console.WriteLine("Invalid format.");
    return;
}
localDateTime = univDateTime.ToLocalTime();
System.Console.WriteLine("{0} universal time is {1} local time.", 
    univDateTime, localDateTime);

The following code example uses the SpecifyKind method to demonstrate how the Kind property influences the ToLocalTime and ToUniversalTime conversion methods.

No code example is currently available or this language may not be supported.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show:
© 2015 Microsoft