C#怎么获取当前时间戳_C# DateTime与Unix时间戳转换【基础】
C#获取Unix时间戳可将DateTime.UtcNow转为整数,但推荐使用DateTimeOffset.UtcNow的ToUnixTimeSeconds或ToUnixTimeMilliseconds方法。手动计算需指定DateTimeKind.Utc,互转时注意时区与精度截断。
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()。这个组合最稳,也最省心。


































