DateTime 表示具体时刻,TimeSpan 表示时间间隔;前者基于 UTC 起始刻度,需注意 Kind 属性,推荐用 UtcNow;后者用于计算差值,支持加减但不支持年月运算,二者协作可完成倒计时、工期计算等常见任务。

DateTime 和 TimeSpan 是 C# 中处理日期时间的核心类型,一个表示“某个时刻”,一个表示“一段时间间隔”。它们配合使用,能完成绝大多数时间计算需求,比如倒计时、工期计算、时间差分析、定时任务调度等。
DateTime:代表具体的时间点
DateTime 存储的是从公元 0001 年 1 月 1 日 00:00:00(UTC)起经过的刻度数(ticks),精度达 100 纳秒。它自带时区信息(Kind 属性),但默认是 Unspecified,容易引发隐式转换问题。
- 常用创建方式:
DateTime.Now(本地时区)、DateTime.UtcNow(推荐用于存储和计算)、new DateTime(2024, 6, 15, 14, 30, 0) - 避免直接用
DateTime.Now做跨系统或持久化计算,优先用DateTime.UtcNow防止夏令时或本地时区偏移干扰 -
格式化输出用
ToString("yyyy-MM-dd HH:mm:ss"),解析字符串用DateTime.TryParse()更安全
TimeSpan:表示两个时间点之间的差值
TimeSpan 不是“某一天的某个时间”,而是纯粹的时长,比如“3天2小时15分”或“-45秒”。它可正可负,支持加减乘除(仅除以数字),但不能直接和 DateTime 相加减以外的操作。
- 生成方式:
DateTime later - DateTime earlier(最常用)、TimeSpan.FromHours(2.5)、new TimeSpan(1, 2, 30, 0)(天、时、分、秒) - 访问属性:
ts.TotalDays、ts.TotalMinutes、ts.Hours(仅当前小时部分,不累计)、ts.Days(仅整数天数)——注意区分TotalXxx和Xxx - 负的 TimeSpan 表示 earlier > later,可用于判断超时、提前等逻辑
DateTime 和 TimeSpan 的典型组合操作
它们的协作让时间计算变得直观可靠:
-
未来/过去时间推算:
DateTime future = DateTime.UtcNow.Add(new TimeSpan(7, 0, 0, 0)); // 7天后 -
剩余时间计算:
TimeSpan remaining = deadline - DateTime.UtcNow;,再用remaining.TotalSeconds > 0判断是否未超时 -
精确到毫秒的耗时测量:用
Stopwatch更准,但简单场景也可var start = DateTime.UtcNow; DoWork(); var elapsed = DateTime.UtcNow - start; -
按天/小时截断时间:如取当天零点
dt.Date,或向上取整到整点new DateTime(dt.Year, dt.Month, dt.Day, dt.Hour, 0, 0).AddHours(1)
常见陷阱与建议
看似简单,实际容易踩坑:
- DateTime.Kind 不匹配导致隐式转换:比如
DateTime.Now + TimeSpan.FromHours(1)结果仍是本地时间,但若和 UTC 时间混用,可能偏差一整天 - TimeSpan 不支持年/月运算(因长度不固定),需用
DateTime.AddMonths()或AddYears()替代 - 比较两个 DateTime 前,确保 Kind 一致,或统一转成 UTC:
dt1.ToUniversalTime() == dt2.ToUniversalTime() - 数据库存时间尽量用 UTC,显示时再转本地时区,避免逻辑混乱
基本上就这些。掌握 DateTime 和 TimeSpan 的分工与边界,时间计算就不再模糊或出错。










