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.ToLocalTime ()

 

Publicado: octubre de 2016

Convierte el valor del objeto DateTime actual a la hora local.

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

public DateTime ToLocalTime()

Valor devuelto

Type: System.DateTime

Objeto cuya propiedad Kind es Local, y cuyo valor es la hora local 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 local es igual a la hora de la hora Universal coordinada (UTC) más 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 ToLocalTime método reconoce sólo la regla de ajuste actual al convertir a la hora UTC a la hora local. 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 UTC y la hora local.

A partir de .NET Framework versión 2.0, el valor devuelto por la ToLocalTime 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

Esta instancia de DateTime se convierte a la hora local.

Local

Se realiza ninguna conversión.

Unspecified

Esta instancia de DateTime se supone que es una hora UTC, y la conversión se realiza como si Kind estaban Utc.

System_CAPS_noteNota

El ToLocalTime método convierte un DateTime valor a la hora UTC a la hora local. Para convertir la hora de cualquier zona horaria designada en la hora local, utilice el TimeZoneInfo.ConvertTime método.

El valor devuelto por la conversión es un DateTime cuyo Kind propiedad siempre devuelve Local. Por lo tanto, se devuelve un resultado válido aunque ToLocalTime se aplique varias veces al mismo DateTime.

Notas para llamadores:

Puede usar el ToLocalTime método para restaurar un valor de tiempo que se convirtió a UTC por y fecha local el ToUniversalTime o FromFileTimeUtc método. Sin embargo, si el tiempo original representa una hora no válida en la zona horaria local, no coincidirán el valor restaurado. Cuando el ToLocalTime método convierte una hora a la hora UTC en la zona horaria local, también ajusta la hora para que sea válida en la zona horaria local.

Por ejemplo, se produce la transición desde el horario estándar al horario de verano de la zona horaria del Pacífico Zona horaria del Pacífico en 14 de marzo de 2010, a las 2:00 A.M., cuando la hora se adelanta una hora, a las 3:00 A.M. Este intervalo de hora es una hora no válida, es decir, un intervalo de tiempo que no existe en esta zona horaria. En el ejemplo siguiente se muestra que cuando una hora que pertenece a este intervalo se convierte a UTC mediante la ToUniversalTime método y, a continuación, se restaura por la ToLocalTime método, el valor original se ajusta para ser una hora válida. Puede determinar si una fecha determinada y un valor de tiempo pueden estar sujetos a modificación pasándolo al TimeZoneInfo.IsInvalidTime método, como en el ejemplo se ilustra.

using System;

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(2010, 3, 14, 2, 30, 0, DateTimeKind.Local);
      Console.WriteLine("Invalid time: {0}", 
                        TimeZoneInfo.Local.IsInvalidTime(date1));
      DateTime utcDate1 = date1.ToUniversalTime();
      DateTime date2 = utcDate1.ToLocalTime();
      Console.WriteLine("{0} --> {1}", date1, date2);      
   }
}
// The example displays the following output:
//       Invalid time: True
//       3/14/2010 2:30:00 AM --> 3/14/2010 3:30:00 AM

En el ejemplo siguiente se muestra el ToLocalTime método. Tenga en cuenta que el resultado exacto depende de la referencia cultural actual y la zona horaria local del sistema en el que se ejecuta.

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: