C#怎么获取当前时间戳_C# DateTime与Unix时间戳转换【基础】

C# 没有内置的“时间戳”类型，这是一个大多数开发者刚接触时容易困惑的地方。所谓“获取当前时间戳”，本质上就是把 DateTime.UtcNow 转换成 Unix 时间戳——也就是一个代表秒数或毫秒数的整数。整个过程的核心就两个变量：时区和精度。用错 DateTime.Now，或者漏掉 .Ticks 除法时的细节，都会直接拿到错误值。先把这个结论记牢，后面展开说就容易理解了。

为什么 DateTime.Now 不能直接当 Unix 时间戳用

Unix 时间戳的定义很明确：自 1970-01-01 00:00:00 UTC 起经过的秒数。而 DateTime.Now 返回的是本地时区的时间，它的 .Ticks 属性是从 0001-01-01 开始计数的。如果你直接用 DateTime.Now 减去 Unix 起始时间再除以 TicksPerSecond，结果会带上本地时区的偏移量。比如东八区，你会发现多出来 28800 秒。这不是 bug，而是忽略了时区。

• 错误示例：DateTime.Now.Subtract(new DateTime(1970, 1, 1)).TotalSeconds → 结果包含本地时区偏移，东八区会多 +28800 秒
• 正确前提：必须用 DateTime.UtcNow，确保基准统一为 UTC
• 容易被忽略的 DateTimeKind：即使两个 DateTime 实例的数值一模一样，如果 Kind 属性是 Unspecified，调用 ToUniversalTime() 时可能会按照本地时区误转，造成偏差

获取当前秒级/毫秒级 Unix 时间戳的可靠写法

实际项目中，推荐使用 DateTimeOffset。它天生自带 UTC 意识，比手动折腾 DateTime 安全得多：

// 秒级时间戳（long）
long timestampSec = DateTimeOffset.UtcNow.ToUnixTimeSeconds();

// 毫秒级时间戳（long）
long timestampMs = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();

// 兼容 .NET Core 2.1+ / .NET 5+；旧版本需手动计算

• 如果你的项目还在用 .NET Framework 4.7.2 或更早版本，没有 ToUnixTimeSeconds 方法，那就手动计算：(long)(DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalSeconds
• 手动计算时，一定要用 DateTimeKind.Utc 显式指定起始时间的种类，防止隐式转换给你挖坑
• 别用 TotalMilliseconds 再取整——浮点数转 long 可能因为精度丢失导致毫秒值偏差 1，这种小毛病排查起来最烦人

DateTime 与时间戳互转时的典型坑

反向转换——从时间戳回到 DateTime——同样要注意时区和精度截断的问题：

• 从秒级时间戳转 DateTime：用 DateTimeOffset.FromUnixTimeSeconds(timestampSec).UtcDateTime，这样得到的是 DateTimeKind.Utc 实例；如果偷懒用 .DateTime，返回的是本地时区时间，后续逻辑很容易混淆
• 毫秒级时间戳转 DateTime 时，FromUnixTimeMilliseconds 返回精确到毫秒的 DateTimeOffset，而 DateTime 的最小单位是 100 纳秒（即 0.1 微秒），所以不会丢精度，放心用
• 警惕这类写法：DateTime.Parse("1609459200") ——字符串无法被识别为时间戳，会直接抛 FormatException。很多新手在这上面卡过
• 数据库存储场景：SQL Server 的 DATETIME2 支持纳秒级精度，但 Unix 时间戳本身不携带时区信息。存之前务必确认业务逻辑是否需要保留原始的 UTC 意图，否则取出来时可能因为时区转换造成数据歧义

说到底，真正的难点不是换算公式有多复杂——公式本身初中生都能写。麻烦的是每次调用时，大脑下意识选 Now 还是 UtcNow、忽略 Kind 属性、或者在跨系统传时间戳时没有约定好单位（秒还是毫秒）。这些地方一旦出错，排查时往往要翻三四个服务的日志，逐一比对时间输出才能定位。所以，养成习惯：碰到时间戳操作，第一反应就是 DateTimeOffset.UtcNow，然后用 .ToUnixTimeSeconds() 或 .ToUnixTimeMilliseconds()。这个组合最稳，也最省心。