语言

DateTime.ToFileTime 方法

定义

将当前 DateTime 对象的值转换为 Windows 文件时间。

public:
 long ToFileTime();
public long ToFileTime();
member this.ToFileTime : unit -> int64
Public Function ToFileTime () As Long

返回

表示为 Windows 文件时间的当前 DateTime 对象的值。

例外

生成的文件时间表示 1601 年 1 月 1 日午夜 12:00 之前的日期和时间。

示例

以下示例演示了该方法 ToFileTime 。

open System.IO

printfn "Enter the file path:"
let filePath = stdin.ReadLine()

if File.Exists filePath then
    let fileCreationDateTime =
        File.GetCreationTime filePath

    let fileCreationFileTime = fileCreationDateTime.ToFileTime()

    printfn $"{fileCreationDateTime} in file time is {fileCreationFileTime}."

else
    printfn $"{filePath} is an invalid file"
static void Main(string[] args)
{
    System.Console.WriteLine("Enter the file path:");
    string filePath = System.Console.ReadLine();

    if (System.IO.File.Exists(filePath)) {
        System.DateTime fileCreationDateTime =
            System.IO.File.GetCreationTime(filePath);

        long fileCreationFileTime = fileCreationDateTime.ToFileTime();

        System.Console.WriteLine("{0} in file time is {1}.",
                                 fileCreationDateTime,
                                 fileCreationFileTime);
    }
    else {
        System.Console.WriteLine("{0} is an invalid file", filePath);
    }
}
Public Shared Sub Main()

   System.Console.WriteLine("Enter the file path:")
   Dim filePath As String
   filePath = System.Console.ReadLine()

   If System.IO.File.Exists(filePath) Then
      Dim fileCreationDateTime As System.DateTime
      fileCreationDateTime = System.IO.File.GetCreationTime(filePath)

      Dim fileCreationFileTime As Long
      fileCreationFileTime = fileCreationDateTime.ToFileTime()

      System.Console.WriteLine("{0} in file time is {1}.", _
                               fileCreationDateTime, _
                               fileCreationFileTime)
   Else
      System.Console.WriteLine("{0} is an invalid file", filePath)
   End If
End Sub

注解

Windows 文件时间是一个 64 位值,表示自 1601 年 1 月 1 日午夜 1601 年 1 月 1 日午夜以来经过的 100 纳秒间隔数(C.E.)协调世界时(UTC)。 Windows 使用文件时间记录应用程序创建、访问或写入文件时。

该方法 ToFileTime 使用 Kind 属性来确定当前 DateTime 对象是本地时间、UTC 时间还是未指定的时间类型,该时间被视为本地时间。

调用方说明

通常,该方法 FromFileTime(Int64) 将还原 DateTime 方法 ToFileTime() 保存的值。 但是,这两个值在以下条件下可能有所不同:

  • 如果值的序列化和反序列化 DateTime 发生在不同的时区中。 例如,如果 DateTime 美国东部时区中时间为 12:30 的值为 12:30,然后在美国太平洋时区反序列化,则原始值为 12:30 P.M. 将调整为上午 9:30,以反映两个时区之间的差异。

  • DateTime如果序列化的值表示本地时区中的无效时间。 在这种情况下,该方法 ToFileTime() 调整还原 DateTime 的值,使其表示本地时区中的有效时间。

例如,从标准时间到夏令时转换发生在 2010 年 3 月 14 日美国太平洋时区,时间在上午 2:00(时间提前一小时)到凌晨 3:00。此小时间隔是无效的时间,即此时区中不存在的时间间隔。 以下示例显示,当属于此范围内的某个时间由 ToFileTime() 该方法转换为长整数值,然后由 FromFileTime(Int64) 该方法还原时,将调整原始值,使之成为有效时间。 如示例所示,可以通过将 IsInvalidTime(DateTime) 特定日期和时间值传递给方法来确定特定日期和时间值是否可能受到修改。

using System;

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(2010, 3, 14, 2, 30, 00);
      Console.WriteLine("Invalid Time: {0}",
                        TimeZoneInfo.Local.IsInvalidTime(date1));
      long ft = date1.ToFileTime();
      DateTime date2 = DateTime.FromFileTime(ft);
      Console.WriteLine("{0} -> {1}", date1, date2);
   }
}
// The example displays the following output:
//       Invalid Time: True
//       3/14/2010 2:30:00 AM -> 3/14/2010 3:30:00 AM
open System

let date1 = DateTime(2010, 3, 14, 2, 30, 00)
printfn $"Invalid Time: {TimeZoneInfo.Local.IsInvalidTime date1}"

let ft = date1.ToFileTime()
let date2 = DateTime.FromFileTime ft
printfn $"{date1} -> {date2}"

// The example displays the following output:
//       Invalid Time: True
//       3/14/2010 2:30:00 AM -> 3/14/2010 3:30:00 AM
Module Example
   Public Sub Main()
      Dim date1 As New DateTime(2010, 3, 14, 2, 30, 00)
      Console.WriteLine("Invalid Time: {0}", TimeZoneInfo.Local.IsInvalidTime(date1))
      Dim ft As Long = date1.ToFileTime()
      Dim date2 As DateTime = DateTime.FromFileTime(ft)
      Console.WriteLine("{0} -> {1}", date1, date2) 
   End Sub
End Module
' The example displays the following output:
'       Invalid Time: True
'       3/14/2010 2:30:00 AM -> 3/14/2010 3:30:00 AM

适用于

另请参阅