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

C#のDateTime.FromFileTimeUtc()メソッドは、指定されたWindowsファイル時刻を、それに相当するUTC（協定世界時）の日付と時刻に変換する静的メソッドです。

Windowsファイル時刻は、1601年1月1日午前0時0分0秒（UTC）を起点として、100ナノ秒単位（タイマーティック）で経過時間を表す形式です。ファイルシステムが保持する作成日時や更新日時などの情報は、この形式で記録されているため、通常のDateTime型として扱う際には本メソッドによる変換が必要になります。

構文

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

public static DateTime FromFileTimeUtc (long time);

パラメータ time には、Windowsファイル時刻を100ナノ秒単位のタイマーティックで表したlong型の値を指定します。戻り値は、変換後のUTC日時を表すDateTimeオブジェクトです。

使用例1：基本的な変換

まずは基本的な使い方を見てみましょう。以下の例では、特定のファイル時刻の値をUTC日時に変換して表示しています。

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

出力結果

DateTime = 08 January 1601, 12:33:20

このように、指定したティック数に対応するUTC日時が出力されます。エポック（起点）が1601年1月1日であるため、比較的小さな値でも1601年前後の日付が得られます。

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

次に、異なる2つのファイル時刻の値を変換する例を紹介します。

using System;
public class Demo {
   public static void Main() {
      DateTime d1 = DateTime.FromFileTimeUtc(0);
      DateTime d2 = DateTime.FromFileTimeUtc(850000000000000);
      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 = 01 January 1601, 12:00:00
New DateTime = 11 September 1603, 07:06:40

注目すべき点として、引数に 0 を渡すと「1601年1月1日 12:00:00」が返されます。これはWindowsファイル時刻の基準となるエポックそのものです。このことから、本メソッドがティック数をエポックからの経過時間として解釈していることが分かります。

まとめ

• DateTime.FromFileTimeUtc()は、Windowsファイル時刻（100ナノ秒単位のティック）をUTC日時に変換する静的メソッドである
• エポックは1601年1月1日（UTC）で、0を渡すとその日時が返される
• ローカル時刻ではなく常にUTCで結果が得られるため、ローカル時刻が必要な場合はToLocalTime()などを併用する