C# DateTime和TimeSpan的用法 - 日期和时间的精确计算

来源:这里教程网 时间:2026-02-21 17:32:30 作者:

DateTimeTimeSpan 是 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 的分工与边界,时间计算就不再模糊或出错。

相关推荐

热文推荐