Evaluar y enviar comentarios
Contraer todo/Expandir todo Contraer todo
Esta página es específica de
Microsoft Visual Studio 2005/.NET Framework 2.0

Hay además otras versiones disponibles para:
Biblioteca de clases de .NET Framework
DateTime.ToBinary (Método)

Nota: este método es nuevo en la versión 2.0 de .NET Framework.

Serializa el objeto DateTime actual a un valor binario de 64 bits que se puede utilizar después para volver a crear el objeto DateTime.

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

Visual Basic (Declaración)
Public Function ToBinary As Long
Visual Basic (Uso)
Dim instance As DateTime
Dim returnValue As Long

returnValue = instance.ToBinary
C#
public long ToBinary ()
C++
public:
long long ToBinary ()
J#
public long ToBinary ()
JScript
public function ToBinary () : long

Valor devuelto

Un entero con signo de 64 bits que codifica las propiedades Kind y Ticks.

Utilice el método ToBinary para convertir el valor del objeto DateTime actual en un valor binario. Después, utilice el valor binario y el método FromBinary para volver a crear el objeto DateTime original.

Ajuste de la hora local

Una hora local, que es una hora universal coordinada ajustada a la zona horaria local, se representa mediante una estructura DateTime cuya propiedad Kind tiene el valor de Local. Si se serializa un objeto DateTime local en una zona horaria mediante el método ToBinary y después se deserializa en una zona horaria distinta mediante el método FromBinary, la hora local representada por el objeto DateTime resultante se ajusta automáticamente a la segunda zona horaria.

Por ejemplo, consideremos un objeto DateTime que representa las 15:00 horas en horario local. Una aplicación que se ejecuta en una zona horaria más occidental utiliza el método ToBinary para convertir ese objeto DateTime en un valor binario y, después, otra aplicación que se ejecuta en una zona horaria situada a tres horas hacia el este de la original utiliza el método FromBinary para convertir el valor binario en un nuevo objeto DateTime. El valor del nuevo objeto DateTime serán las 18:00 horas, lo que representa el mismo punto horario que el valor original de 15:00 horas, pero ajustado a la hora local de la zona horaria más oriental.

Consideraciones de versión

A partir de la versión 2.0 de .NET Framework, una estructura DateTime está formada por un campo Kind privado, que indica si el valor de hora especificado se basa en la hora local, la hora universal coordinada (UTC), o ninguna de ellas, y por un campo Ticks privado, que contiene el número de pasos de 100 nanosegundos que especifican la fecha y la hora. Se puede obtener acceso al campo Ticks con la propiedad Ticks y al campo Kind con la propiedad Kind.

Con anterioridad a la versión 2.0 de .NET Framework, cuando se serializaba manualmente un objeto DateTime, en lugar de utilizar una interfaz de serialización como System.Runtime.Serialization.ISerializable, sólo era necesario serializar los datos del campo Ticks de la estructura DateTime. A partir de la versión 2.0, también se deben serializar los datos del campo Kind.

Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0
Contenido de la comunidad   ¿Qué es Community Content?
Agregar contenido nuevo RSS  Anotaciones
Processing
© 2009 Microsoft Corporation. Reservados todos los derechos. Términos de uso | Marcas Registradas | Privacidad
Page view tracker