目录简介概念与特性创建 TimeSpan构造函数静态工厂方法解析字符串常用属性运算操作加减乘除比较取绝对值取负值与 DateTime 配合格式化输出默认格式标准格式自定义格式常用静态字段典型使用场景定时任务/超时控制统计程序耗时实际应用示例高级用法自定义 TimeSpan 扩展方注意事项和最佳实践简介TimeSpan是.NET中用于表示时间间隔或持续时间的重要结构体。它提供了丰富的方法和属性来处理时间跨度，从几毫秒到几百万天都可以精确表示。
概念与特性TimeSpan表示一个时间间隔（时间段），而不是具体的时间点。
特性说明命名空间System结构类型struct（值类型）
表示范围约 ±10,675,199 天（≈29,000 年）
精度1 Tick = 100 纳秒单位表示可用天、小时、分钟、秒、毫秒、Ticks与DateTime
区别：
DateTime表示一个具体的时间点（例如：2025-09-18 08:00）。
TimeSpan表示一个时间间隔（例如：2 小时 30 分钟）。
创建 TimeSpan构造函数// 构造函数：TimeSpan(days, hours, minutes, seconds) var span1 = new TimeSpan(1, 2, 30, 0); // 1天2小时30分0秒
// 构造函数：TimeSpan(hours, minutes, seconds) var span2 = new TimeSpan(2, 30, 0); // 2小时30分静态工厂方法推荐使用静态方法，可读性更高：TimeSpan ts1 = TimeSpan.FromDays(1.5); // 1.5天TimeSpan ts2 = TimeSpan.FromHours(2.5); // 2.5小时TimeSpan ts3 = TimeSpan.FromMinutes(90); // 90分钟TimeSpan ts4 = TimeSpan.FromSeconds(45); // 45秒TimeSpan ts5 = TimeSpan.FromMilliseconds(500); // 500毫秒TimeSpan ts6 = TimeSpan.FromTicks(5000); // 5000 Ticks解析字符串TimeSpan ts = TimeSpan.Parse("1.02:30:00");// 格式：d.hh:mm:ss -> 1天2小时30分
或安全解析：
if (TimeSpan.TryParse("02:15", out var result)) Console.WriteLine(result); // 02:15:00常用属性属性说明示例Days总天数(整数部分) ts.Days Hours小时(0–23) ts.Hours Minutes分钟(0–59) ts.Minutes Seconds秒(0–59) ts.Seconds Milliseconds毫秒(0–999) ts.Milliseconds Ticks以 Tick（100ns）为单位ts.Ticks TotalDays总天数(含小数) ts.TotalDays TotalHours总小时数(含小数) ts.TotalHours TotalMinutes总分钟数(含小数) ts.TotalMinutes TotalSeconds总秒数(含小数) ts.TotalSeconds TotalMilliseconds总毫秒数ts.TotalMilliseconds区别Days、Hours等返回整数部分（对应分量）。
TotalDays、TotalHours等返回完整总量。
示例：
var ts = new TimeSpan(1, 2, 30, 0);Console.WriteLine(ts.Days); // 1 Console.WriteLine(ts.TotalHours); // 26.5运算操作加减var t1 = TimeSpan.FromHours(3);var t2 = TimeSpan.FromMinutes(30);
TimeSpan sum = t1 + t2; // 3:30:00 TimeSpan diff = t1 - t2; // 2:30:00乘除TimeSpan doubleTime = TimeSpan.FromMinutes(45) * 2; // 1:30:00 TimeSpan halfTime = TimeSpan.FromHours(4) / 2; // 2:00:00C# 11 之前不支持直接乘除，需要用 TimeSpan.FromTicks() 手动计算。 （.NET 7 / C# 11 起支持 * / 运算符）
比较TimeSpan ts1 = TimeSpan.FromHours(2);TimeSpan ts2 = TimeSpan.FromMinutes(120); // 也是2小时
// 比较bool isEqual = ts1 == ts2; // true bool isNotEqual = ts1 != ts2; // false bool isGreater = ts1 > TimeSpan.FromHours(1); // true bool isLess = ts1 < TimeSpan.FromHours(3); // true
// 比较方法int compareResult = ts1.CompareTo(ts2); // 0 (相等) bool equals = ts1.Equals(ts2); // true取绝对值var negative = TimeSpan.FromHours(-5);var positive = negative.Duration(); // 05:00:00取负值var neg = -TimeSpan.FromMinutes(30); // -00:30:00与 DateTime 配合TimeSpan常用于计算两个时间点的差值：DateTime start = DateTime.Now;// 模拟一些操作System.Threading.Thread.Sleep(1500);DateTime end = DateTime.Now;
TimeSpan elapsed = end - start;Console.WriteLine($"执行耗时: {elapsed.TotalMilliseconds} ms");
也可以用来加减时间：
DateTime tomorrow = DateTime.Now + TimeSpan.FromDays(1);格式化输出默认格式Console.WriteLine(ts.ToString()); // "1.02:30:00" (d.hh:mm:ss)标准格式Console.WriteLine(ts.ToString("c")); // 同上 (常数格式) Console.WriteLine(ts.ToString("g")); // 1:2:30:45.5 (常规短格式) Console.WriteLine(ts.ToString("G")); // 1:02:30:45.5000000 (常规长格式)自定义格式ToString
支持标准和自定义格式：
var ts = new TimeSpan(1, 2, 30, 45, 500);Console.WriteLine(ts.ToString(@"hh\:mm\:ss")); // 02:30:45 Console.WriteLine(ts.ToString(@"d\.hh\:mm\:ss\.fff")); // 1.02:30:45.500需要转义 : 和 .
常用静态字段字段说明TimeSpan.Zero表示 0 TimeSpan.MaxValue最大可表示值TimeSpan.MinValue最小可表示值典型使用场景定时任务/超时控制var timeout = TimeSpan.FromSeconds(30);var cts = new CancellationTokenSource(timeout);统计程序耗时var watch = System.Diagnostics.Stopwatch.StartNew();// do work watch.Stop();Console.WriteLine(watch.Elapsed); // TimeSpan实际应用示例using System;
class Program{static void Main(){DateTime start = DateTime.Now;
// 模拟任务System.Threading.Thread.Sleep(1200);
DateTime end = DateTime.Now;TimeSpan span = end - start;
Console.WriteLine($"耗时: {span.TotalMilliseconds} 毫秒");Console.WriteLine($"格式化: {span.ToString(@"hh\:mm\:ss\.fff")}");Console.WriteLine($"天: {span.Days}, 小时: {span.Hours}, 总小时: {span.TotalHours:F2}");}}
输出示例：
耗时: 1203.45 毫秒
格式化: 00:00:01.203
天: 0, 小时: 0, 总小时: 0.00高级用法自定义 TimeSpan 扩展方public static class TimeSpanExtensions{public static string ToHumanReadableString(this TimeSpan timeSpan){if (timeSpan.TotalDays >= 1) return $"{(int)timeSpan.TotalDays} 天 {timeSpan.Hours} 小时";
if (timeSpan.TotalHours >= 1) return $"{(int)timeSpan.TotalHours} 小时 {timeSpan.Minutes} 分钟";
if (timeSpan.TotalMinutes >= 1) return $"{(int)timeSpan.TotalMinutes} 分钟 {timeSpan.Seconds} 秒";
if (timeSpan.TotalSeconds >= 1) return $"{(int)timeSpan.TotalSeconds} 秒";
return $"{timeSpan.Milliseconds} 毫秒";}}
// 使用扩展方法TimeSpan ts = TimeSpan.FromHours(2.5);Console.WriteLine(ts.ToHumanReadableString()); // 输出: 2 小时 30 分钟注意事项和最佳实践
不可变性：
TimeSpan是值类型且不可变，所有操作都返回新的TimeSpan实例
精度考虑：
TimeSpan使用ticks（100 纳秒）作为内部存储，提供高精度但需要注意浮点运算的精度问题文化敏感性：解析和格式化TimeSpan时，注意当前线程的文化设置性能考虑：对于高性能场景，考虑使用Stopwatch而不是DateTime减法来计算时间间隔到此这篇关于C# TimeSpan计算时间差的操作完整指南的文章就介绍到这了,更多相关C# TimeSpan时间差内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
您可能感兴趣的文章:C#使用TimeSpan对象实现获取时间间隔C#日期时间类的使用方法(DateTime类、TimeSpan类与DateTimeOffset类) C#的TimeSpan案例详解C#使用TimeSpan时间计算的简单实现详解C# TimeSpan 计算时间差(时间间隔) C#基于TimeSpan实现倒计时效果的方法