File.GetCreationTime(String) メソッド


指定したファイルまたはディレクトリの作成日時を返します。Returns the creation date and time of the specified file or directory.

 static DateTime GetCreationTime(System::String ^ path);
public static DateTime GetCreationTime (string path);
static member GetCreationTime : string -> DateTime
Public Shared Function GetCreationTime (path As String) As DateTime



作成日時情報を取得する対象のファイルまたはディレクトリ。The file or directory for which to obtain creation date and time information.



指定したファイルまたはディレクトリの作成日時に設定された DateTime 構造体。A DateTime structure set to the creation date and time for the specified file or directory. この値は現地時刻で表示されます。This value is expressed in local time.


呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

path は長さ 0 の文字列であるか、空白のみで構成されるか、または InvalidPathChars で定義される 1 つ以上の使用できない文字を含んでいます。path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

pathnullです。path is null.

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。The specified path, file name, or both exceed the system-defined maximum length.

path の形式が正しくありません。path is in an invalid format.

次の例は、を示して GetCreationTime います。The following example demonstrates GetCreationTime.

Imports System.IO

Module Module1

    Sub Main()
        Dim fileCreatedDate As DateTime = File.GetCreationTime("C:\Example\MyTest.txt")
        Console.WriteLine("file created: " + fileCreatedDate)
    End Sub

End Module



このメソッドは、値がオペレーティングシステムによって継続的に更新されないネイティブ関数を使用するため、不正確な値を返す場合があります。This method may return an inaccurate value, because it uses native functions whose values may not be continuously updated by the operating system.

pathパラメーターで相対パスまたは絶対パス情報を指定できます。The path parameter is permitted to specify relative or absolute path information. 相対パス情報は、現在の作業ディレクトリを基準として解釈されます。Relative path information is interpreted as relative to the current working directory. 現在の作業ディレクトリを取得するには、「」を参照してください GetCurrentDirectoryTo obtain the current working directory, see GetCurrentDirectory.

パラメーターに記述されたファイルが存在しない場合 path 、このメソッドは1601西暦年1月1日午前0時12:00 を返します。If the file described in the path parameter does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. 西暦協定世界時 (UTC)。現地時刻に調整されます。(C.E.) Coordinated Universal Time (UTC), adjusted to local time.

NTFS でフォーマットされたドライブは、ファイル作成時刻などのファイルに関する情報を短時間にキャッシュする場合があります。NTFS-formatted drives may cache information about a file, such as file creation time, for a short period of time. そのため、既存のファイルを上書きまたは置換する場合は、ファイルの作成時間を明示的に設定する必要があります。As a result, it may be necessary to explicitly set the creation time of a file if you are overwriting or replacing an existing file.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.