DateTime.ToFileTimeUtc 方法

定义

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

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

返回

Int64

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

例外

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

注解

Windows 文件时间是64位的值,它表示自公元1601年1月1日午夜12:00 以来已过去的100纳秒间隔数 。协调世界时 (UTC)。 Windows 使用文件时间记录应用程序创建、访问或写入文件的时间。

ToFileTimeUtc方法使用 Kind 属性来确定当前 DateTime 对象是本地时间、utc 时间还是被视为 utc 时间的未指定时间类型。 如果它是本地时间,则会在执行到 Windows 文件时间的转换之前将时间转换为 UTC。

调用方说明

ToFileTimeUtc()方法有时用于将本地时间转换为 UTC,然后通过调用方法然后调用方法来还原该时间 FromFileTimeUtc(Int64) ToLocalTime() 。 但是,如果原始时间表示本地时区中的无效时间,则两个本地时间值将不相等。 有关其他信息,请参见 ToLocalTime() 方法。

适用于

另请参阅