C# 如何将 DateTime 转换为 Unix 时间戳_C# DateTime 转 Unix 时间戳指南

使用 DateTimeOffset 转换 DateTime 到 Unix 时间戳最可靠。首先将本地时间转为 UTC,再调用 ToUnixTimeSeconds() 或 ToUnixTimeMilliseconds() 获取秒级或毫秒级时间戳。示例:DateTime now = DateTime.Now; long timestamp = ((DateTimeOffset)now.ToUniversalTime()).ToUnixTimeSeconds(); 对于旧版 .NET Framework,可手动计算与 1970-01-01 UTC 的时间差。注意始终使用 UTC 时间避免时区偏差。

在 C# 中将 DateTime 转换为 Unix 时间戳是一个常见需求,尤其是在处理 API 接口、日志时间或跨平台时间同步时。Unix 时间戳是指自 **1970-01-01 00:00:00 UTC**(又称“Unix 纪元”)以来经过的秒数(或毫秒数)。以下是几种常用且可靠的方法。

使用 DateTimeOffset 获取秒级时间戳

最推荐的方式是利用 DateTimeOffset 类,它能自动处理时区问题,确保转换结果符合 UTC 标准。

  • 将本地时间转换为 UTC 时间
  • 调用 ToUnixTimeSeconds() 方法获取秒级时间戳

示例代码:

DateTime now = DateTime.Now; // 可以是任意 DateTime 实例
long timestamp = ((DateTimeOffset)now).ToUnixTimeSeconds();
Console.WriteLine(timestamp); // 输出类似:1712345678

获取毫秒级时间戳

某些系统(如 JavaScript 或部分 API)需要毫秒级精度的时间戳。此时可使用 ToUnixTimeMilliseconds() 方法。

示例:

DateTime now = DateTime.UtcNow;
long millisecondTimestamp = ((DateTimeOffset)now).ToUnixTimeMilliseconds();
Console.WriteLine(millisecondTimestamp); // 输出类似:1712345678123

手动计算(适用于 .NET Framework 等旧环境)

如果你使用的是较老版本的 .NET Framework(不支持 ToUnixTimeSeconds),可以通过手动减法实现。

核心思路:计算当前时间与 Unix 起始时间之间的差值。

示例代码:

private static long ToUnixTimestamp(DateTime date)
{
var epoch = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
var time = date.ToUniversalTime();
return (long)(time - epoch).TotalSeconds;
}

调用方式:

DateTime now = DateTime.Now;
long timestamp = ToUnixTimestamp(now);
Console.WriteLine(timestamp);

注意事项

转换时需注意以下几点,避免常见错误:

  • 确保时间是 UTC 时间,否则可能因本地时区导致偏差
  • DateTime.Kind 应设置为 DateTimeKind.Utc,或显式转换
  • 如果传入的是本地时间,请先调用 ToUniversalTime()
  • 避免对已为 UTC 的时间重复转换

基本上就这些。只要使用 ((DateTimeOffset)yourDate).ToUnixTimeSeconds(),就能快速准确地完成转换。兼容性好、代码简洁,推荐优先使用。