C# DateTime与时间戳转换全攻略
在C#开发中，DateTime与时间戳之间的转换是非常常见的操作。时间戳通常指从1970年1月1日（UTC）开始经过的秒数或毫秒数，广泛应用于日志记录、数据同步、API通信等场景。本文将详细介绍如何在C#中实现DateTime与时间戳的相互转换，并涵盖时区处理、边界情况等关键细节。
什么是时间戳？
时间戳（Timestamp）是一种表示特定时间点的整数值，通常以Unix时间戳为标准。Unix时间戳定义为从1970-01-01 00:00:00 UTC到指定时间点的总秒数（或毫秒数）。在C#中，常见的时间戳类型包括：
秒级时间戳：以秒为单位，取值范围从0到当前时间（约17亿秒）
毫秒级时间戳：以毫秒为单位，精度更高，常用于JavaScript等环境
二、DateTime与时间戳的转换基础
在C#中，转换的核心是理解UTC时间和本地时间的区别，以及正确使用DateTimeOffset或DateTime的ToUniversalTime()方法。以下公式是基础：
// 秒级时间戳转换公式 long timestamp = (long)(dateTime.ToUniversalTime() - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalSeconds; // 毫秒级时间戳 long timestampMs = (long)(dateTime.ToUniversalTime() - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalMilliseconds;
特别注意：基础纪元时间必须指定DateTimeKind.Utc，否则可能因时区差异导致计算错误。
三、常见转换方法实例
1. DateTime转为秒级时间戳
public static long ToTimestamp(DateTime dateTime)
{
return (long)(dateTime.ToUniversalTime() - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalSeconds;
}
// 使用示例
DateTime now = DateTime.Now;
long timestamp = ToTimestamp(now);
Console.WriteLine($"当前时间戳（秒）: {timestamp}");2. 秒级时间戳转为DateTime
public static DateTime FromTimestamp(long timestamp)
{
DateTime epoch = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
return epoch.AddSeconds(timestamp).ToLocalTime();
}
// 使用示例
long timestamp = 1700000000;
DateTime dateTime = FromTimestamp(timestamp);
Console.WriteLine($"转换后的本地时间: {dateTime}");3. 毫秒级时间戳转换
// DateTime转毫秒时间戳
public static long ToTimestampMilliseconds(DateTime dateTime)
{
return (long)(dateTime.ToUniversalTime() - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalMilliseconds;
}
// 毫秒时间戳转DateTime
public static DateTime FromTimestampMilliseconds(long timestampMs)
{
DateTime epoch = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
return epoch.AddMilliseconds(timestampMs).ToLocalTime();
}注意：毫秒时间戳通常用于JavaScript中的Date.now()，其值为13位整数。
四、使用DateTimeOffset进行转换
DateTimeOffset提供了更精确的时区信息，推荐在处理时间戳时使用：
// 使用DateTimeOffset转换
public static long ToTimestampWithOffset(DateTimeOffset dto)
{
return dto.ToUnixTimeSeconds(); // 秒级
// 或者 dto.ToUnixTimeMilliseconds(); // 毫秒级
}
public static DateTimeOffset FromTimestampWithOffset(long timestamp)
{
return DateTimeOffset.FromUnixTimeSeconds(timestamp); // 秒级
// 或者 DateTimeOffset.FromUnixTimeMilliseconds(timestamp);
}使用DateTimeOffset的优点是无需手动进行UTC转换，系统自动处理时区标准。
五、常见问题与注意事项
1. 时区问题
时间戳是UTC时间，而DateTime.Now是本地时间。错误地直接转换本地时间会导致结果偏差。例如：
// 错误示例（可能产生偏差） DateTime wrongTime = DateTime.Now; long wrongTimestamp = (long)(wrongTime - new DateTime(1970, 1, 1)).TotalSeconds; // 缺少ToUniversalTime() // 正确做法 long correctTimestamp = (long)(wrongTime.ToUniversalTime() - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalSeconds;
2. 边界值处理
时间戳可能为负数（表示1970年之前的时间），在C#中需注意：
DateTime.MinValue对应的时间戳约为-62135596800秒（大约公元1年）早于1970年的时间戳在转换时可能超出
long范围，需使用decimal或double存储
3. 精度问题
TotalSeconds和TotalMilliseconds返回的是double类型，直接转换为long会丢失小数部分。对于秒级时间戳，通常不需要毫秒精度，但如果需要高精度，请使用微秒或纳秒转换。
六、完整封装类示例
为了方便复用，可以封装一个工具类：
public static class TimeHelper
{
private static readonly DateTime EpochUtc = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
public static long ToUnixTime(DateTime dateTime)
{
return (long)(dateTime.ToUniversalTime() - EpochUtc).TotalSeconds;
}
public static long ToUnixTimeMilliseconds(DateTime dateTime)
{
return (long)(dateTime.ToUniversalTime() - EpochUtc).TotalMilliseconds;
}
public static DateTime FromUnixTime(long timestamp)
{
return EpochUtc.AddSeconds(timestamp).ToLocalTime();
}
public static DateTime FromUnixTimeMilliseconds(long timestampMs)
{
return EpochUtc.AddMilliseconds(timestampMs).ToLocalTime();
}
}
// 使用示例
DateTime now = DateTime.Now;
long seconds = TimeHelper.ToUnixTime(now);
DateTime restored = TimeHelper.FromUnixTime(seconds);
Console.WriteLine($"原始时间: {now}");
Console.WriteLine($"时间戳: {seconds}");
Console.WriteLine($"还原时间: {restored}");七、实际应用示例：API时间戳处理
假设从API获取了一个JSON数据，其中包含时间戳字段：
// JSON数据示例
string json = @"{""timestamp"": 1700000000, ""name"": ""测试""}";
var obj = JsonConvert.DeserializeAnonymousType(json, new { timestamp = 0L, name = "" });
DateTime dt = TimeHelper.FromUnixTime(obj.timestamp);
Console.WriteLine($"获取的数据时间: {dt:yyyy-MM-dd HH:mm:ss}");通过上述方式，可以轻松将API返回的时间戳转换为本地可读的时间格式。
八、总结
本文详细介绍了C#中DateTime与时间戳之间的转换方法，包括秒级和毫秒级时间戳的处理，以及使用DateTimeOffset的便捷方式。关键点在于：
始终使用UTC时间进行计算
正确处理时区转换
注意边界值和精度问题
掌握这些技巧，可以避免在时间处理中常见的错误，让代码更加健壮和可维护。