C#のDateTime.ToBinary()メソッドの使い方を徹底解説

DateTime.ToBinary()メソッドとは

C#のDateTime.ToBinary()メソッドは、現在のDateTimeオブジェクトを、後から同じオブジェクトとして復元できる64ビットのバイナリ値にシリアル化するためのメソッドです。

戻り値は64ビット符号付き整数（long型）となり、この値を保存しておけば、あとから日付と時刻の情報を正確に再現することが可能です。

構文

このメソッドの構文は以下の通りです。

public long ToBinary ();

引数は取らず、呼び出し元のDateTimeオブジェクトをシリアル化した結果をlong型で返します。

使用例1：固定の日時をシリアル化する

まずは、特定の日時を持つDateTimeオブジェクトに対してToBinary()メソッドを使用する例を見てみましょう。

using System;
public class Demo {
    public static void Main() {
        DateTime d = new DateTime(2019, 10, 10, 8, 10, 40);
        Console.WriteLine("Date = {0}", d);
        long res = d.ToBinary();
        Console.WriteLine("64-bit binary value : {0}", res);
    }
}

出力結果

上記のコードを実行すると、次のような出力が得られます。

Date = 10/10/2019 8:10:40 AM
64-bit binary value : 637062918400000000

使用例2：現在日時をシリアル化する

続いて、DateTime.Nowで取得した現在日時をToBinary()メソッドでシリアル化する例です。

using System;
public class Demo {
    public static void Main() {
        DateTime d = DateTime.Now;
        Console.WriteLine("Date = {0}", d);
        long res = d.ToBinary();
        Console.WriteLine("64-bit binary value : {0}", res);
    }
}

出力結果

実行したタイミングによって値は変わりますが、例えば次のような出力になります。

Date = 10/16/2019 8:15:56 AM
64-bit binary value : -8586303931293472296

ポイント：Kindプロパティも一緒に保持される

ToBinary()メソッドで生成される64ビットの値には、日時の情報だけでなく、DateTimeオブジェクトが持つKindプロパティ（Local・Utc・Unspecified）の情報もエンコードされています。これにより、ローカル時刻とUTC（協定世界時）の区別を保ったままシリアル化できるのが特徴です。

補足：FromBinary()メソッドで復元する

シリアル化された値から元のDateTimeオブジェクトを復元したい場合は、静的メソッドであるDateTime.FromBinary(long)を使用します。ファイルやデータベースに日時情報を保存し、後から読み込んで再利用するようなシナリオで、ToBinary()とFromBinary()はセットで活用されます。