Cómo: Aplicar acciones de ida y vuelta a valores de fecha y hora
Actualización: noviembre 2007
En muchas aplicaciones, la finalidad de un valor de fecha y hora consiste en identificar de forma inequívoca un momento único. En este tema se muestra cómo se guarda y se restaura un valor DateTime, un valor DateTimeOffset y un valor de fecha y hora con información de la zona horaria de modo que el valor restaurado identifique el mismo momento que el valor guardado.
Para aplicar un viaje de ida y vuelta (round trip) a un valor DateTime
Convierta el valor DateTime en su representación de cadena; para ello, llame al método DateTime.ToString(String) con el especificador de formato "o".
Guarde la representación de cadena del valor DateTime en un archivo o páselo a través de un proceso, del dominio de aplicación o del límite del equipo.
Recupere la cadena que representa el valor DateTime.
Llame al método DateTime.Parse(String, IFormatProvider, DateTimeStyles) y pase DateTimeStyles.RoundtripKind como valor del parámetro styles.
En el siguiente ejemplo se muestra cómo se aplican viajes de ida y vuelta (round trip) a un valor DateTime.
Const fileName As String = ".\DateFile.txt"
Dim outFile As New StreamWriter(fileName)
' Save DateTime value.
Dim dateToSave As Date = DateTime.SpecifyKind(#06/12/2008 6:45:15 PM#, _
DateTimeKind.Local)
Dim dateString As String = dateToSave.ToString("o")
Console.WriteLine("Converted {0} ({1}) to {2}.", dateToSave.ToString(), _
dateToSave.Kind.ToString(), dateString)
outFile.WriteLine(dateString)
Console.WriteLine("Wrote {0} to {1}.", dateString, fileName)
outFile.Close()
' Restore DateTime value.
Dim restoredDate As Date
Dim inFile As New StreamReader(fileName)
dateString = inFile.ReadLine()
inFile.Close()
restoredDate = DateTime.Parse(dateString, Nothing, DateTimeStyles.RoundTripKind)
Console.WriteLine("Read {0} ({2}) from {1}.", restoredDate.ToString(), _
fileName, restoredDAte.Kind.ToString())
' The example displays the following output:
' Converted 6/12/2008 6:45:15 PM (Local) to 2008-06-12T18:45:15.0000000-05:00.
' Wrote 2008-06-12T18:45:15.0000000-05:00 to .\DateFile.txt.
' Read 6/12/2008 6:45:15 PM (Local) from .\DateFile.txt.
const string fileName = @".\DateFile.txt";
StreamWriter outFile = new StreamWriter(fileName);
// Save DateTime value.
DateTime dateToSave = DateTime.SpecifyKind(new DateTime(2008, 6, 12, 18, 45, 15),
DateTimeKind.Local);
string dateString = dateToSave.ToString("o");
Console.WriteLine("Converted {0} ({1}) to {2}.",
dateToSave.ToString(),
dateToSave.Kind.ToString(),
dateString);
outFile.WriteLine(dateString);
Console.WriteLine("Wrote {0} to {1}.", dateString, fileName);
outFile.Close();
// Restore DateTime value.
DateTime restoredDate;
StreamReader inFile = new StreamReader(fileName);
dateString = inFile.ReadLine();
inFile.Close();
restoredDate = DateTime.Parse(dateString, null, DateTimeStyles.RoundtripKind);
Console.WriteLine("Read {0} ({2}) from {1}.", restoredDate.ToString(),
fileName,
restoredDate.Kind.ToString());
// The example displays the following output:
// Converted 6/12/2008 6:45:15 PM (Local) to 2008-06-12T18:45:15.0000000-05:00.
// Wrote 2008-06-12T18:45:15.0000000-05:00 to .\DateFile.txt.
// Read 6/12/2008 6:45:15 PM (Local) from .\DateFile.txt.
Cuando se aplican viajes de ida y vuelta (round trip) a un valor DateTime, esta técnica mantiene correctamente la hora en todos los horarios locales y universales. Por ejemplo, si un valor DateTime local está guardado en un sistema con la zona horaria estándar del Pacífico de EE.UU. y se restaura en un sistema con la zona horaria estándar central de EE.UU., el valor de fecha y hora restaurado tendrá dos horas de retraso respecto a la hora original, lo que refleja la diferencia que existe entre las dos zonas horarias. Sin embargo, esta técnica no resulta del todo precisa para los horarios no especificados. Todos los valores DateTime cuya propiedad Kind es Unspecified se tratan como si fueran horas locales. Si éste no es el caso, DateTime no identificará correctamente el momento en el tiempo preciso. La solución alternativa para esta limitación consiste en acoplar de forma rigurosa un valor de fecha y hora con su zona horaria al guardar y restaurar.
Para aplicar un viaje de ida y vuelta (round trip) a un valor DateTimeOffset
Convierta el valor DateTimeOffset en su representación de cadena; para ello, llame al método DateTimeOffset.ToString(String) con el especificador de formato "o".
Guarde la representación de cadena del valor DateTimeOffset en un archivo o páselo a través de un proceso, del dominio de aplicación o del límite del equipo.
Recupere la cadena que representa el valor DateTimeOffset.
Llame al método DateTimeOffset.Parse(String, IFormatProvider, DateTimeStyles) y pase DateTimeStyles.RoundtripKind como valor del parámetro styles.
En el siguiente ejemplo se muestra cómo se aplican viajes de ida y vuelta (round trip) a un valor DateTimeOffset.
Const fileName As String = ".\DateOff.txt"
Dim outFile As New StreamWriter(fileName)
' Save DateTime value.
Dim dateToSave As New DateTimeOffset(2008, 6, 12, 18, 45, 15, _
New TimeSpan(7, 0, 0))
Dim dateString As String = dateToSave.ToString("o")
Console.WriteLine("Converted {0} to {1}.", dateToSave.ToString(), dateString)
outFile.WriteLine(dateString)
Console.WriteLine("Wrote {0} to {1}.", dateString, fileName)
outFile.Close()
' Restore DateTime value.
Dim restoredDateOff As DateTimeOffset
Dim inFile As New StreamReader(fileName)
dateString = inFile.ReadLine()
inFile.Close()
restoredDateOff = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.RoundTripKind)
Console.WriteLine("Read {0} from {1}.", restoredDateOff.ToString(), fileName)
' The example displays the following output:
' Converted 6/12/2008 6:45:15 PM +07:00 to 2008-06-12T18:45:15.0000000+07:00.
' Wrote 2008-06-12T18:45:15.0000000+07:00 to .\DateOff.txt.
' Read 6/12/2008 6:45:15 PM +07:00 from .\DateOff.txt.
const string fileName = @".\DateOff.txt";
StreamWriter outFile = new StreamWriter(fileName);
// Save DateTime value.
DateTimeOffset dateToSave = new DateTimeOffset(2008, 6, 12, 18, 45, 15,
new TimeSpan(7, 0, 0));
string dateString = dateToSave.ToString("o");
Console.WriteLine("Converted {0} to {1}.", dateToSave.ToString(),
dateString);
outFile.WriteLine(dateString);
Console.WriteLine("Wrote {0} to {1}.", dateString, fileName);
outFile.Close();
// Restore DateTime value.
DateTimeOffset restoredDateOff;
StreamReader inFile = new StreamReader(fileName);
dateString = inFile.ReadLine();
inFile.Close();
restoredDateOff = DateTimeOffset.Parse(dateString, null,
DateTimeStyles.RoundtripKind);
Console.WriteLine("Read {0} from {1}.", restoredDateOff.ToString(),
fileName);
// The example displays the following output:
// Converted 6/12/2008 6:45:15 PM +07:00 to 2008-06-12T18:45:15.0000000+07:00.
// Wrote 2008-06-12T18:45:15.0000000+07:00 to .\DateOff.txt.
// Read 6/12/2008 6:45:15 PM +07:00 from .\DateOff.txt.
Esta técnica siempre identifica de forma inequívoca un valor DateTimeOffset como un momento único. El valor se puede convertir a continuación a la hora universal coordinada (UTC) llamando al método DateTimeOffset.ToUniversalTime o se puede convertir a la hora de una determinada zona horaria llamando al método DateTimeOffset.ToOffset o TimeZoneInfo.ConvertTime(DateTimeOffset, TimeZoneInfo). La limitación principal de esta técnica es que las operaciones aritméticas de fecha y hora, cuando se realizan sobre un valor DateTimeOffset que representa la hora en una determinada zona horaria, no pueden generar resultados precisos para esa zona horaria. Esto se debe a que cuando se crea una instancia de un valor DateTimeOffset, se desasocia de su zona horaria. Por tanto, estas reglas de ajuste ya no se pueden aplicar cuando se realizan cálculos de fecha y hora. Para evitar este problema, defina un tipo personalizado que incluya un valor de fecha y hora y su zona horaria correspondiente.
Para aplicar viajes de ida y vuelta (round trip) a un valor de fecha y hora con su zona horaria
Defina una clase o una estructura con dos campos. El primer campo es un objeto DateTime o DateTimeOffset y el segundo es un objeto TimeZoneInfo. En el ejemplo siguiente se muestra una versión sencilla de un tipo de estas características.
<Serializable> Public Class DateInTimeZone Private tz As TimeZoneInfo Private thisDate As DateTimeOffset Public Sub New() End Sub Public Sub New(date1 As DateTimeOffset, timeZone As TimeZoneInfo) If timeZone Is Nothing Then Throw New ArgumentNullException("The time zone cannot be null.") End If Me.thisDate = date1 Me.tz = timeZone End Sub Public Property DateAndTime As DateTimeOffset Get Return Me.thisDate End Get Set If Value.Offset <> Me.tz.GetUtcOffset(Value) Then Me.thisDate = TimeZoneInfo.ConvertTime(Value, tz) Else Me.thisDate = Value End If End Set End Property Public ReadOnly Property TimeZone As TimeZoneInfo Get Return tz End Get End Property End Class[Serializable] public class DateInTimeZone { private TimeZoneInfo tz; private DateTimeOffset thisDate; public DateInTimeZone() {} public DateInTimeZone(DateTimeOffset date, TimeZoneInfo timeZone) { if (timeZone == null) throw new ArgumentNullException("The time zone cannot be null."); this.thisDate = date; this.tz = timeZone; } public DateTimeOffset DateAndTime { get { return this.thisDate; } set { if (value.Offset != this.tz.GetUtcOffset(value)) this.thisDate = TimeZoneInfo.ConvertTime(value, tz); else this.thisDate = value; } } public TimeZoneInfo TimeZone { get { return this.tz; } } }Marque la clase con el atributo SerializableAttribute.
Serialice el objeto con el método BinaryFormatter.Serialize.
Restaure el objeto con el método Deserialize.
Convierta el objeto deserializado en un objeto del tipo adecuado.
En el ejemplo siguiente se muestra cómo se aplican viajes de ida y vuelta (round trip) a un objeto que almacena información de fecha y hora e información de la zona horaria.
Const fileName As String = ".\DateWithTz.dat"
Dim tempDate As Date = #9/3/2008 7:00:00 PM#
Dim tempTz As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time")
Dim dateWithTz As New DateInTimeZone(New DateTimeOffset(tempDate, _
tempTz.GetUtcOffset(tempDate)), _
tempTz)
' Store DateInTimeZone value to a file
Dim outFile As New FileStream(fileName, FileMode.Create)
Try
Dim formatter As New BinaryFormatter()
formatter.Serialize(outFile, dateWithTz)
Console.WriteLine("Saving {0} {1} to {2}", dateWithTz.DateAndTime, _
IIf(dateWithTz.TimeZone.IsDaylightSavingTime(dateWithTz.DateAndTime), _
dateWithTz.TimeZone.DaylightName, dateWithTz.TimeZone.DaylightName), _
fileName)
Catch e As SerializationException
Console.WriteLine("Unable to serialize time data to {0}.", fileName)
Finally
outFile.Close()
End Try
' Retrieve DateInTimeZone value
If File.Exists(fileName) Then
Dim inFile As New FileStream(fileName, FileMode.Open)
Dim dateWithTz2 As New DateInTimeZone()
Try
Dim formatter As New BinaryFormatter()
dateWithTz2 = DirectCast(formatter.Deserialize(inFile), DateInTimeZone)
Console.WriteLine("Restored {0} {1} from {2}", dateWithTz2.DateAndTime, _
IIf(dateWithTz2.TimeZone.IsDaylightSavingTime(dateWithTz2.DateAndTime), _
dateWithTz2.TimeZone.DaylightName, dateWithTz2.TimeZone.DaylightName), _
fileName)
Catch e As SerializationException
Console.WriteLine("Unable to retrieve date and time information from {0}", _
fileName)
Finally
inFile.Close
End Try
End If
' This example displays the following output to the console:
' Saving 9/3/2008 7:00:00 PM -05:00 Central Daylight Time to .\DateWithTz.dat
' Restored 9/3/2008 7:00:00 PM -05:00 Central Daylight Time from .\DateWithTz.dat
const string fileName = @".\DateWithTz.dat";
DateTime tempDate = new DateTime(2008, 9, 3, 19, 0, 0);
TimeZoneInfo tempTz = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time");
DateInTimeZone dateWithTz = new DateInTimeZone(new DateTimeOffset(tempDate,
tempTz.GetUtcOffset(tempDate)),
tempTz);
// Store DateInTimeZone value to a file
FileStream outFile = new FileStream(fileName, FileMode.Create);
try
{
BinaryFormatter formatter = new BinaryFormatter();
formatter.Serialize(outFile, dateWithTz);
Console.WriteLine("Saving {0} {1} to {2}", dateWithTz.DateAndTime,
dateWithTz.TimeZone.IsDaylightSavingTime(dateWithTz.DateAndTime) ?
dateWithTz.TimeZone.DaylightName : dateWithTz.TimeZone.DaylightName,
fileName);
}
catch (SerializationException)
{
Console.WriteLine("Unable to serialize time data to {0}.", fileName);
}
finally
{
outFile.Close();
}
// Retrieve DateInTimeZone value
if (File.Exists(fileName))
{
FileStream inFile = new FileStream(fileName, FileMode.Open);
DateInTimeZone dateWithTz2 = new DateInTimeZone();
try
{
BinaryFormatter formatter = new BinaryFormatter();
dateWithTz2 = formatter.Deserialize(inFile) as DateInTimeZone;
Console.WriteLine("Restored {0} {1} from {2}", dateWithTz2.DateAndTime,
dateWithTz2.TimeZone.IsDaylightSavingTime(dateWithTz2.DateAndTime) ?
dateWithTz2.TimeZone.DaylightName : dateWithTz2.TimeZone.DaylightName,
fileName);
}
catch (SerializationException)
{
Console.WriteLine("Unable to retrieve date and time information from {0}",
fileName);
}
finally
{
inFile.Close();
}
}
// This example displays the following output to the console:
// Saving 9/3/2008 7:00:00 PM -05:00 Central Daylight Time to .\DateWithTz.dat
// Restored 9/3/2008 7:00:00 PM -05:00 Central Daylight Time from .\DateWithTz.dat
Esta técnica siempre debería reflejar de forma inequívoca el momento preciso tanto antes como después de que se haya guardado y restaurado, siempre que la implementación del objeto combinado de fecha y hora y zona horaria no permita que el valor de fecha y hora pierda su sincronía con el valor de zona horaria.
Compilar el código
Estos ejemplos necesitan:
Que los espacios de nombres siguientes se importen con instrucciones using en C# o instrucciones Imports en Visual Basic:
Una referencia a System.Core.dll.
Todos los ejemplos de código, excepto la clase DateInTimeZone, deberían estar incluidos en una clase o módulo de Visual Basic, ajustarse a los métodos y llamarse desde el método Main.
Vea también
Conceptos
Temas "Cómo..." sobre formatos