DateTime (Métodos)


Biblioteca de clases de .NET Framework
DateTime.FromBinary (Método)

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

Deserializa un valor binario de 64 bits y vuelve a crear un objeto DateTime serializado original.

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

Sintaxis

Visual Basic (Declaración)
Public Shared Function FromBinary ( _
    dateData As Long _
) As DateTime
Visual Basic (Uso)
Dim dateData As Long
Dim returnValue As DateTime

returnValue = DateTime.FromBinary(dateData)
C#
public static DateTime FromBinary (
    long dateData
)
C++
public:
static DateTime FromBinary (
    long long dateData
)
J#
public static DateTime FromBinary (
    long dateData
)
JScript
public static function FromBinary (
    dateData : long
) : DateTime

Parámetros

dateData

Entero con signo de 64 bits que codifica la propiedad Kind en un campo de 2 bits y la propiedad Ticks en un campo de 62 bits.

Valor devuelto

Objeto DateTime que es equivalente al objeto DateTime que se serializó con el método ToBinary.
Excepciones

Tipo de excepciónCondición

ArgumentException

dateData es menor que MinValue o mayor que MaxValue.

Comentarios

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 la hora especificada es una hora local, una hora universal coordinada (UTC), o ninguna de ellas, concatenado a un campo Ticks, que contiene el número de pasos de 100 nanosegundos que especifican la fecha y la hora. Se puede obtener acceso al número de pasos mediante la propiedad Ticks y al campo Kind mediante 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 del objeto DateTime. A partir de la versión 2.0 de .NET Framework, también se deben serializar los datos del campo Kind.

Plataformas

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.

Información de versión

.NET Framework

Compatible con: 2.0
Vea también

Etiquetas :


Page view tracker