DateTime.FromFileTime メソッド

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

DateTime.FromFileTime メソッド

指定された Windows ファイル時刻を同等の現地時刻に変換します。

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

Visual Basic (宣言)

Public Shared Function FromFileTime
 ( _
    fileTime As Long _
) As DateTime

Visual Basic (使用法)

Dim fileTime As Long
Dim returnValue As DateTime

returnValue = DateTime.FromFileTime(fileTime)

C#

public static DateTime FromFileTime (
    long fileTime
)

C++

public:
static DateTime FromFileTime (
    long long fileTime
)

J#

public static DateTime FromFileTime (
    long fileTime
)

JScript

public static function FromFileTime
 (
    fileTime : long
) : DateTime

パラメータ

fileTime

タイマ刻み単位で表した Windows ファイルの時刻。

戻り値
fileTime パラメータの日時に相当する、現地時刻の DateTime オブジェクト。

例外

例外の種類	条件
ArgumentOutOfRangeException	fileTime が 0 未満か、MaxValue を超える時刻を表しています。

解説

Windows ファイル時刻とは、世界協定時刻 (UTC) の A.D. (西暦紀元) 1601 年 1 月 1 日 午前 00:00 時以降の経過時間を 100 ナノ秒間隔の数値で表す 64 ビット値です。Windows では、アプリケーションによるファイルの作成、アクセス、書き込みの時刻が、ファイル時刻を使用して記録されます。

fileTime パラメータには、100 ナノ秒のタイマ刻みで表したファイル時刻を指定します。

.NET Framework version 2.0 以降では、戻り値は、DateTime になります。この場合、Kind プロパティは Local を返します。

使用例

FromFileTime メソッドのコード例を次に示します。

Visual Basic

Public Function FileAge(ByVal
 fileCreationTime As Long) As
 System.TimeSpan

   Dim now As System.DateTime
   now = System.DateTime.Now

   Try
      Dim fCreationTime As System.DateTime
      Dim fAge As System.TimeSpan
      fCreationTime = System.DateTime.FromFileTime(fileCreationTime)
      fAge = now.Subtract(fCreationTime)
      Return fAge
   Catch exp As ArgumentOutOfRangeException
      ' fileCreationTime is not valid, so re-throw the exception.
      Throw
   End Try
End Function

C#

public System.TimeSpan FileAge(long fileCreationTime) {

    System.DateTime now = System.DateTime.Now;
    try {
        System.DateTime fCreationTime = 
            System.DateTime.FromFileTime(fileCreationTime);
        System.TimeSpan fileAge = now.Subtract(fCreationTime);
        return fileAge;                
    } 
    catch (ArgumentOutOfRangeException) {
        // fileCreationTime is not valid, so re-throw the exception.
        throw;
    }
}

C++

System::TimeSpan FileAge( long fileCreationTime )
{
   System::DateTime now = System::DateTime::Now;
   try
   {
      System::DateTime fCreationTime =
         System::DateTime::FromFileTime( fileCreationTime );
      System::TimeSpan fileAge = now.Subtract( fCreationTime );
      return fileAge;
   }
   catch ( ArgumentOutOfRangeException^ ) 
   {
      // fileCreationTime is not valid, so re-throw the exception.
      throw;
   }
}

J#

public System.TimeSpan FileAge(long fileCreationTime) {

    System.DateTime now = System.DateTime.get_Now();
    try {
        System.DateTime fCreationTime = System.DateTime.
            FromFileTime(fileCreationTime);
        System.TimeSpan fileAge = now.Subtract(fCreationTime);
        return fileAge;
    }
    catch(ArgumentOutOfRangeException exp){
        // fileCreationTime is not valid, so re-throw the exception.
        throw new ArgumentOutOfRangeException()  ;
    }
} //FileAge

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

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