DateTime.FromBinary メソッド

.NET Framework クラス ライブラリ リファレンス

DateTime.FromBinary メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

64 ビットのバイナリ値を逆シリアル化し、元のシリアル化 DateTime オブジェクトを再構築します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function FromBinary
 ( _
    dateData As Long _
) As DateTime

Visual Basic (使用法)

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

パラメータ

dateData

2 ビット フィールドの Kind プロパティおよび 62 ビット フィールドの Ticks プロパティをエンコードする 64 ビット符号付き整数。

戻り値
ToBinary メソッドによってシリアル化された DateTime オブジェクトと等価な DateTime オブジェクト。

例外

例外の種類	条件
ArgumentException	dateData が MinValue より小さい値か、MaxValue より大きい値です。

解説

現在の DateTime オブジェクトの値をバイナリ値に変換するには、ToBinary メソッドを使用します。以後、このバイナリ値と FromBinary メソッドを使用することにより、元の DateTime オブジェクトを再構築できます。

現地時刻の調整

世界協定時刻を現地のタイム ゾーンで調整することによって得られる現地時刻は、Kind プロパティに Local 値が割り当てられた DateTime 構造体によって表されます。現地時刻を表す DateTime オブジェクトを ToBinary メソッドを使って特定のタイム ゾーンでシリアル化した場合、それを異なるタイム ゾーンで逆シリアル化するには、FromBinary メソッドを使用します。その結果得られる DateTime オブジェクトの現地時刻は、自動的に 2 つ目のタイム ゾーンに合わせて調整されます。

たとえば、現地時刻の午後 3:00 を表す DateTime オブジェクトがあるとします。ここに東寄りと西寄りのタイム ゾーンで実行される 2 つのアプリケーションがあり、西寄りのタイム ゾーンで実行されているアプリケーションが ToBinary メソッドを使って、この DateTime オブジェクトをバイナリ値に変換し、その後、それよりも 3 時間早い東寄りのタイムゾーンで実行されている別のアプリケーションが FromBinary メソッドを使って、このバイナリ値を新しい DateTime オブジェクトに変換したとします。この場合、新しい DateTime オブジェクトの値は午後 6:00 になります。これは、午後 3:00 という元の値と同じ時点を表していますが、東寄りのタイム ゾーンの現地時刻に合わせて調整されています。

バージョンの考慮事項

.NET Framework Version 2.0 以降の DateTime 構造体には、プライベートの Kind フィールド (指定された時刻が "現地時刻"、"世界協定時刻 (UTC)"、"そのいずれでもない" を表す) と、プライベートの Ticks フィールド (日付と時刻を指定する、100 ナノ秒間隔のタイマ刻み数を保持) とが連結されたデータが格納されます。タイマ刻み数と Kind フィールドには、それぞれ Ticks プロパティおよび Kind プロパティでアクセスできます。

以前のバージョンの .NET Framework では、System.Runtime.Serialization.ISerializable などのシリアル化インターフェイスを使わずに、DateTime オブジェクトを直接シリアル化する場合は、DateTime 内の Ticks データだけをシリアル化する必要がありました。.NET Framework 2.0 以降では、これに加えて Kind データもシリアル化する必要があります。

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DateTime 構造体
DateTime メンバ
System 名前空間
ToBinary