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

C#のDateTimeOffset.FromFileTime()メソッドは、指定されたWindowsファイル時刻を、それと等価なローカル時刻（DateTimeOffset型）に変換するための静的メソッドです。

なお、Windowsファイル時刻とは、1601年1月1日午前0時（UTC）を起点とした経過時間を、100ナノ秒単位（タイマーティック）で表現した値のことです。Windows OSが内部的にファイルの作成日時や更新日時などを管理する際に使用されている形式です。

構文

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

public static DateTimeOffset FromFileTime (long time);

引数のtimeには、変換対象となるWindowsファイル時刻をタイマーティック単位のlong型で指定します。戻り値としては、変換後のローカル時刻を表すDateTimeOffsetオブジェクトが返されます。

使用例1：ファイル時刻に「0」を指定した場合

まずは、基本的な使用例を見てみましょう。ここでは、起点となる時刻そのものを表す「0」を引数に渡しています。

using System;
public class Demo {
   public static void Main() {
      DateTimeOffset offset = DateTimeOffset.FromFileTime(0);
      Console.WriteLine("DateTimeOffset = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ",offset);
   }
}

実行結果

DateTimeOffset = 01 January 1601, 12:00:00

このように、ファイル時刻として「0」を指定すると、Windowsファイル時刻の基準点である1601年1月1日が返されることが確認できます。

使用例2：ティック数を指定した場合

次に、具体的なティック数を指定した例を見てみましょう。ここでは「200000000」を引数として渡しています。

using System;
public class Demo {
   public static void Main() {
      DateTimeOffset offset = DateTimeOffset.FromFileTime(200000000);
      Console.WriteLine("DateTimeOffset = {0:dd} {0:y}, {0:hh}:{0:mm}:{0:ss} ",offset);
   }
}

実行結果

DateTimeOffset = 01 January 1601, 12:00:20

200000000ティックは200000000 × 100ナノ秒 ＝ 20秒に相当するため、基準時刻から20秒経過した「1601年1月1日 12:00:20」が出力されました。

まとめ

DateTimeOffset.FromFileTime()メソッドを使うことで、Windows APIなどから取得したファイル時刻（FILETIME構造体の値）を、扱いやすいDateTimeOffset型のローカル時刻へ簡単に変換できます。ファイルシステムのタイムスタンプを処理するアプリケーションを開発する際に非常に便利なメソッドなので、ぜひ活用してみてください。