Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método DateTime.ToUniversalTime ()

 

Publicado: octubre de 2016

Convierte el valor del objeto DateTime actual a la hora universal coordinada (UTC).

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)

public DateTime ToUniversalTime()

Valor devuelto

Type: System.DateTime

Objeto cuya propiedad Kind es Utc, y cuyo valor es la hora UTC equivalente al valor del objeto DateTime actual, o MaxValue si el valor convertido es demasiado grande para representarlo mediante un objeto DateTime, o MinValue si el valor convertido es demasiado pequeño para representarlo mediante un objeto DateTime.

La hora Universal coordinada (UTC) es igual a la hora local menos el desplazamiento de UTC. Para obtener más información sobre el desplazamiento de UTC, consulte TimeZone.GetUtcOffset. La conversión también tiene en cuenta la regla de horario de verano que se aplica a la hora representada por el actual DateTime objeto.

System_CAPS_importantImportante

En Windows XP sistemas, la ToUniversalTime método reconoce sólo la regla de ajuste actual al convertir de hora local a UTC. Como resultado, las conversiones para períodos anteriores a la regla de ajuste actual entrada en vigor pueden no reflejar exactamente la diferencia entre la hora local y la hora UTC. 

A partir de .NET Framework versión 2.0, el valor devuelto por la ToUniversalTime método viene determinado por la Kind propiedad del elemento actual DateTime objeto. En la tabla siguiente se describe los posibles resultados.

Kind

Resultados

Utc

Se realiza ninguna conversión.

Local

Actual DateTime objeto se convierte a UTC.

Unspecified

Actual DateTime objeto se supone que es una hora local y la conversión se realiza como si Kind estaban Local.

System_CAPS_noteNota

El ToUniversalTime método convierte un DateTime valor de la hora local a UTC. Para convertir la hora en una zona horaria no local a UTC, use la TimeZoneInfo.ConvertTimeToUtc(DateTime, TimeZoneInfo) método. Para convertir una hora cuyo desplazamiento de UTC se conoce, utilice la ToUniversalTime método.

Si el valor de instancia de fecha y hora es una hora ambigua, este método supone que es una hora estándar. (Una hora ambigua es aquella que se puede asignar a una hora estándar o a un horario de verano en la zona horaria local) Si el valor de instancia de fecha y hora es una hora no válida, este método simplemente resta la hora local a la hora UTC de la zona horaria local de desplazamiento para devolver la hora UTC. (Una hora no válida es aquella que no existe debido a la aplicación de reglas de ajuste del horario de verano).

Notas para llamadores:

El ToUniversalTime método a veces se utiliza para convertir una hora local a UTC. El ToLocalTime , a continuación, se llama el método para restaurar la hora local original. Sin embargo, si el tiempo original representa una hora no válida en la zona horaria local, los dos valores de hora local no será iguales. Para obtener información adicional y un ejemplo, vea el ToLocalTime método.

En Windows XP sistemas, la ToUniversalTime método reconoce sólo la regla de ajuste actual para la zona horaria local, que se aplica a todas las fechas, incluidas las fechas de nivel inferior (es decir, las fechas anteriores a la fecha de inicio de la regla de ajuste actual). Aplicaciones que se ejecutan Windows XP que requieren históricamente precisa fecha local y cálculos de tiempo deben solucionar este comportamiento mediante la FindSystemTimeZoneById método para recuperar un TimeZoneInfo que corresponde a la zona horaria local del objeto y llamar a su TimeZoneInfo.ConvertTimeToUtc(DateTime, TimeZoneInfo) método.

En el ejemplo siguiente se muestra la diferencia entre el ToUniversalTime y TimeZoneInfo.ConvertTimeToUtc(DateTime, TimeZoneInfo) métodos en un Windows XP sistema la zona horaria del Pacífico de EE. UU. El primer dos llamadas al método aplican la regla de ajuste de zona horaria actual (que entró en vigor en 2007) a una fecha en el año 2006. La regla de ajuste actual proporciona la transición al horario de verano en el segundo domingo de marzo; la regla anterior, que estaba en efecto proporcionado para la transición al horario de verano para que tenga lugar el primer domingo de abril de 2006. La tercera llamada de método con precisión realiza esta fecha histórico y conversión de tiempo.

using System;

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(2006, 3, 21, 2, 0, 0);

      Console.WriteLine(date1.ToUniversalTime());
      Console.WriteLine(TimeZoneInfo.ConvertTimeToUtc(date1));

      TimeZoneInfo tz = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time");  
      Console.WriteLine(TimeZoneInfo.ConvertTimeToUtc(date1, tz));     
   }
}
// The example displays the following output on Windows XP systems:
//       3/21/2006 9:00:00 AM
//       3/21/2006 9:00:00 AM
//       3/21/2006 10:00:00 AM

En el ejemplo siguiente se muestra el método ToUniversalTime.

using System;

class Example
{
	static void Main()
	{
		DateTime localDateTime, univDateTime;

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

		try {
			localDateTime = DateTime.Parse(strDateTime);
    		univDateTime = localDateTime.ToUniversalTime();

    		Console.WriteLine("{0} local time is {1} universal time.",
   								localDateTime,
    								univDateTime); 
		}
		catch (FormatException) {
			Console.WriteLine("Invalid format.");
			return;
		}

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

		try {
			univDateTime = DateTime.Parse(strDateTime);
    		localDateTime = univDateTime.ToLocalTime();

    		Console.WriteLine("{0} universal time is {1} local time.",
    								 univDateTime,
    								 localDateTime); 
		}
		catch (FormatException) {
			Console.WriteLine("Invalid format.");
			return;
		}

	}
}
// The example displays output like the following when run on a 
// computer whose culture is en-US in the Pacific Standard Time zone:
//     Enter a date and time.
//     12/10/2015 6:18 AM
//     12/10/2015 6:18:00 AM local time is 12/10/2015 2:18:00 PM universal time.
//     Enter a date and time in universal time.
//     12/20/2015 6:42:00
//     12/20/2015 6:42:00 AM universal time is 12/19/2015 10:42:00 PM local time.

En el ejemplo siguiente se usa el SpecifyKind método para mostrar cómo la Kind influye en la propiedad del ToLocalTime y ToUniversalTime métodos de conversión.

// This code example demonstrates the DateTime Kind, Now, and
// UtcNow properties, and the SpecifyKind(), ToLocalTime(), 
// and ToUniversalTime() methods.

using System;

class Sample 
{
    public static void Main() 
    {
// Get the date and time for the current moment, adjusted 
// to the local time zone.

    DateTime saveNow = DateTime.Now;

// Get the date and time for the current moment expressed 
// as coordinated universal time (UTC).

    DateTime saveUtcNow = DateTime.UtcNow;
    DateTime myDt;

// Display the value and Kind property of the current moment 
// expressed as UTC and local time.

    DisplayNow("UtcNow: ..........", saveUtcNow);
    DisplayNow("Now: .............", saveNow);
    Console.WriteLine();

// Change the Kind property of the current moment to 
// DateTimeKind.Utc and display the result.

    myDt = DateTime.SpecifyKind(saveNow, DateTimeKind.Utc);
    Display("Utc: .............", myDt);

// Change the Kind property of the current moment to 
// DateTimeKind.Local and display the result.

    myDt = DateTime.SpecifyKind(saveNow, DateTimeKind.Local);
    Display("Local: ...........", myDt);

// Change the Kind property of the current moment to 
// DateTimeKind.Unspecified and display the result.

    myDt = DateTime.SpecifyKind(saveNow, DateTimeKind.Unspecified);
    Display("Unspecified: .....", myDt);
    }

// Display the value and Kind property of a DateTime structure, the 
// DateTime structure converted to local time, and the DateTime 
// structure converted to universal time. 

    public static string datePatt = @"M/d/yyyy hh:mm:ss tt";
    public static void Display(string title, DateTime inputDt)
    {
    DateTime dispDt = inputDt;
    string dtString;

// Display the original DateTime.

    dtString = dispDt.ToString(datePatt);
    Console.WriteLine("{0} {1}, Kind = {2}", 
                      title, dtString, dispDt.Kind);

// Convert inputDt to local time and display the result. 
// If inputDt.Kind is DateTimeKind.Utc, the conversion is performed.
// If inputDt.Kind is DateTimeKind.Local, the conversion is not performed.
// If inputDt.Kind is DateTimeKind.Unspecified, the conversion is 
// performed as if inputDt was universal time.

    dispDt = inputDt.ToLocalTime();
    dtString = dispDt.ToString(datePatt);
    Console.WriteLine("  ToLocalTime:     {0}, Kind = {1}", 
                      dtString, dispDt.Kind);

// Convert inputDt to universal time and display the result. 
// If inputDt.Kind is DateTimeKind.Utc, the conversion is not performed.
// If inputDt.Kind is DateTimeKind.Local, the conversion is performed.
// If inputDt.Kind is DateTimeKind.Unspecified, the conversion is 
// performed as if inputDt was local time.

    dispDt = inputDt.ToUniversalTime();
    dtString = dispDt.ToString(datePatt);
    Console.WriteLine("  ToUniversalTime: {0}, Kind = {1}", 
                      dtString, dispDt.Kind);
    Console.WriteLine();
    }

// Display the value and Kind property for DateTime.Now and DateTime.UtcNow.

    public static void DisplayNow(string title, DateTime inputDt)
    {
    string dtString = inputDt.ToString(datePatt);
    Console.WriteLine("{0} {1}, Kind = {2}", 
                      title, dtString, inputDt.Kind);
    }
}

/*
This code example produces the following results:

UtcNow: .......... 5/6/2005 09:34:42 PM, Kind = Utc
Now: ............. 5/6/2005 02:34:42 PM, Kind = Local

Utc: ............. 5/6/2005 02:34:42 PM, Kind = Utc
  ToLocalTime:     5/6/2005 07:34:42 AM, Kind = Local
  ToUniversalTime: 5/6/2005 02:34:42 PM, Kind = Utc

Local: ........... 5/6/2005 02:34:42 PM, Kind = Local
  ToLocalTime:     5/6/2005 02:34:42 PM, Kind = Local
  ToUniversalTime: 5/6/2005 09:34:42 PM, Kind = Utc

Unspecified: ..... 5/6/2005 02:34:42 PM, Kind = Unspecified
  ToLocalTime:     5/6/2005 07:34:42 AM, Kind = Local
  ToUniversalTime: 5/6/2005 09:34:42 PM, Kind = Utc

*/

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: