C#のDateTime.FromOADate()メソッドの使い方をわかりやすく解説

DateTime.FromOADate()メソッドとは

C#のDateTime.FromOADate()メソッドは、指定されたOLEオートメーション日付（OLE Automation Date）に対応するDateTime値を返す静的メソッドです。

OLEオートメーション日付は、ExcelなどのMicrosoft Office製品やCOMコンポーネントで使われる日付形式で、1899年12月30日を基準日（値0）として、そこからの経過日数をdouble型の数値で表します。整数部分が日数、小数部分が時刻（1日に対する割合）を表します。

構文

DateTime.FromOADate()メソッドの構文は以下の通りです。

public static DateTime FromOADate (double val);

パラメータ「val」には、変換対象となるOLEオートメーション日付の値（double型）を指定します。戻り値としては、その値に対応するDateTimeオブジェクトが返されます。

使用例1：基本的な使い方

まずは、DateTime.FromOADate()メソッドの基本的な実装例を見てみましょう。

using System;
public class Demo {
    public static void Main() {
        DateTime d1 = DateTime.FromOADate(1.0);
        Console.WriteLine("DateTime = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ", d1);
    }
}

出力結果

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

DateTime = 31 December 1899, 12:00:00

この例では、OLEオートメーション日付として「1.0」を渡しているため、基準日である1899年12月30日の翌日にあたる1899年12月31日が返されます。

使用例2：複数の値を変換する

続いて、異なる値を指定した場合の動作を確認してみましょう。

using System;
public class Demo {
    public static void Main() {
        DateTime d1 = DateTime.FromOADate(375765.0);
        DateTime d2 = DateTime.FromOADate(0.0);
        Console.WriteLine("DateTime = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ", d1);
        Console.WriteLine("New DateTime = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ", d2);
    }
}

出力結果

このプログラムを実行すると、以下の出力が得られます。

DateTime = 21 October 2928, 12:00:00
New DateTime = 30 December 1899, 12:00:00

「375765.0」を指定した場合は2928年10月21日、「0.0」を指定した場合は基準日の1899年12月30日が出力されます。

まとめ

DateTime.FromOADate()メソッドを使えば、Excelのセルから取得したシリアル値などを、C#のDateTime型へ簡単かつ正確に変換できます。Office連携アプリケーションの開発では頻繁に活用される重要なメソッドなので、ぜひ覚えておきましょう。