C#中利用DateTime.ToFileTime生成时间戳作为唯一文件名

纸上星河

发布时间：2026-10-14| 6人浏览过

原创

在C#开发中，经常需要根据当前时间生成唯一的文件名，以防止重复覆盖。通过调用DateTime.Now.ToFileTime()方法，可以获取一个高精度的Windows文件时间戳（Int64类型），将其转为字符串即可作为极具辨识度的文件名基础。

核心原理与返回值

ToFileTime方法将当前的DateTime对象转换为Windows文件时间格式。其返回值为System.Int64类型的长整数。

这个数值表示自协调世界时(UTC)1601年1月1日午夜以来经过的间隔数，每个间隔为100纳秒。由于精度极高且基数固定，它能确保生成的文件名随时间单调递增，非常适合用于日志记录、临时文件命名等场景。

直接获取当前时间的文件时间戳并转换为字符串，是生成基于时间文件名的关键步骤。

string fileNameBase = DateTime.Now.ToFileTime().ToString();Console.WriteLine(fileNameBase);

运行上述代码，你将得到一个类似如下的长字符串：

130308237880937500

你可以将此字符串拼接上文件扩展名（如.txt、.jpg），即构成完整的文件名。例如：130308237880937500.log。

在使用此方法时，需注意.NET Framework版本对时间解析逻辑的影响：

.NET Framework 2.0及之后：ToFileTime方法会检查DateTime.Kind属性，自动判断当前时间是本地时间还是UTC时间，并进行相应转换。这是推荐的行为，能保证跨时区环境的准确性。
旧版本环境：早期版本默认假设DateTime对象为本地时间进行转换，可能导致UTC时间与本地时间的混淆。在现代开发中，确保使用较新的Framework版本以避免此类歧义。

若需显式控制时区，建议先通过DateTime.SpecifyKind指定DateTime的Kind属性为DateTimeKind.Utc或DateTimeKind.Local后再调用此方法。