DateTimeOffset.FromFileTime 方法
2013/3/11
将指定的 Windows 文件时间转换为等效的本地时间。
程序集: mscorlib(位于 mscorlib.dll 中)
参数
- fileTime
- 类型: System.Int64
以计时周期表示的 Windows 文件时间。
| 异常 | 条件 |
|---|---|
| ArgumentOutOfRangeException | filetime 小于零。 - 或 - filetime 大于 DateTimeOffset.MaxValue.Ticks。 |
Windows 文件时间是一个 64 位值,它表示自协调世界时 (UTC) 公元 (C.E.) 1601 年 1 月 1 日午夜 12:00 以来已经过的以 100 纳秒为间隔的间隔数。Windows 使用文件时间记录应用程序创建、访问或写入文件的时间。
通过调用返回 FILETIME 结构的 GetFileTime 函数,可经 Windows API 直接访问 Windows 文件时间。要检索其文件时间信息的文件的句柄是唯一的函数参数。此文件句柄是通过调用 CreateFile 函数检索的。FILETIME 结构的 dwHighDateTime 成员包含文件时间的四个高序位字节,其 dwLowDateTime 成员包含四个低序位字节。下面的示例演示如何检索 Windows 文件时间值并将其转换为 DateTimeOffset 值。
也可以通过以下两种方法来创建 Windows 文件时间值:通过调用 DateTime.ToFileTime 和 DateTime.ToFileTimeUtc 方法利用 DateTime 值来创建,通过调用 DateTimeOffset.ToFileTime 方法利用 DateTimeOffset 值来创建。