DateTime.ToFileTimeUtc 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将当前 DateTime 对象的值转换为 Windows 文件时间。
public:
long ToFileTimeUtc();
public long ToFileTimeUtc ();
member this.ToFileTimeUtc : unit -> int64
Public Function ToFileTimeUtc () As Long
返回
表示为 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() 方法。