C#中的TimeSpan详解（从基础运算到高级格式化技巧）

什么是TimeSpan？

TimeSpan 是 .NET 中表示时间间隔（持续时间）的结构体。它不表示某个具体的时间点（那是 DateTime 的工作），而是表示一段“长度”，比如“2小时30分钟”或“5天”。

创建TimeSpan对象

你可以通过多种方式创建 TimeSpan 对象：

// 1. 使用构造函数（天, 小时, 分钟, 秒, 毫秒）TimeSpan ts1 = new TimeSpan(1, 2, 30, 45, 500); // 1天2小时30分45秒500毫秒// 2. 使用静态方法TimeSpan ts2 = TimeSpan.FromHours(2.5);     // 2.5小时TimeSpan ts3 = TimeSpan.FromMinutes(90);    // 90分钟TimeSpan ts4 = TimeSpan.FromSeconds(3661);  // 3661秒（即1小时1分1秒）// 3. 通过两个DateTime相减得到DateTime start = new DateTime(2023, 1, 1, 10, 0, 0);DateTime end = new DateTime(2023, 1, 1, 12, 30, 0);TimeSpan duration = end - start; // 结果为2小时30分钟

TimeSpan的基本运算

TimeSpan支持加法、减法、比较等运算，非常直观：

TimeSpan t1 = TimeSpan.FromHours(2);TimeSpan t2 = TimeSpan.FromMinutes(30);// 加法TimeSpan total = t1 + t2; // 2小时30分钟// 减法TimeSpan diff = t1 - t2; // 1小时30分钟// 比较bool isLonger = t1 > t2; // true// 乘法和除法（需注意：结果可能不是整数）TimeSpan doubled = t1.Multiply(2); // .NET 6+ 支持TimeSpan halved = t1.Divide(2);    // .NET 6+ 支持// 在旧版本中，可先转为Ticks再运算TimeSpan oldDoubled = TimeSpan.FromTicks(t1.Ticks * 2);

TimeSpan的格式化输出

将 TimeSpan 转换为人类可读的字符串是开发中的高频操作。C# TimeSpan格式化 提供了多种方式：

1. 默认 ToString()

TimeSpan ts = new TimeSpan(1, 14, 30, 45);Console.WriteLine(ts.ToString()); // 输出: 1.14:30:45 （格式：d.hh:mm:ss）

2. 自定义格式字符串

使用标准或自定义格式说明符：

TimeSpan ts = new TimeSpan(2, 5, 30, 15, 500);// 标准格式Console.WriteLine(ts.ToString("g")); // 短格式: 2:5:30:15.5Console.WriteLine(ts.ToString("G")); // 长格式: 2:05:30:15.5000000// 自定义格式（注意：需用引号包裹格式字符串）Console.WriteLine(ts.ToString(@"dd\:hh\:mm\:ss")); // 02:05:30:15Console.WriteLine(ts.ToString(@"hh\ 天\ hh\ 小时\ mm\ 分钟")); // 05 天 05 小时 30 分钟

⚠️ 注意：在自定义格式中，冒号 : 和点 . 是特殊字符，需要用反斜杠 \ 转义，或者像上面一样使用原生字符串（@"..."）。

实用技巧：处理负时间与总单位数

有时你会遇到负的 TimeSpan（比如结束时间早于开始时间），或者需要获取总小时数、总分钟数等：

TimeSpan negativeTs = TimeSpan.FromHours(-1.5);Console.WriteLine(negativeTs); // -01:30:00TimeSpan longTs = TimeSpan.FromHours(25.5);Console.WriteLine(longTs.TotalHours);   // 25.5（总小时数，double类型）Console.WriteLine(longTs.TotalMinutes); // 1530（总分钟数）Console.WriteLine(longTs.Hours);        // 1（仅小时部分，不包括天）Console.WriteLine(longTs.Days);         // 1（天数部分）

总结

通过本教程，你已经掌握了 C# TimeSpan 的核心用法，包括如何创建、进行 TimeSpan运算 以及灵活地进行 TimeSpan格式化。这些知识将帮助你在实际项目中高效处理时间间隔相关逻辑。

记住，熟练运用 TimeSpan 不仅能提升代码可读性，还能避免许多与时间计算相关的潜在错误。快去你的项目中试试吧！