深入理解C#中的TimeSpan结构体：创建、访问、计算与格式化

TimeSpan 结构体在 C# 中用于表示两个时间点之间的时间间隔。它可以表示天、小时、分钟、秒以及毫秒的时间长度。TimeSpan 结构体非常适合于处理时间差，比如计算两个 DateTime 对象之间的差异，或者在需要表示一段时间长度时使用。

以下是一些使用 TimeSpan 结构体的基本示例：

1. 创建 TimeSpan 实例

可以通过多种方式创建 TimeSpan 实例：

• 使用构造函数
• 使用静态方法 Parse 或 TryParse（从字符串解析）
• 使用 DateTime 对象之间的差异

TimeSpan span1 = new TimeSpan(1, 2, 3, 4, 500); // 1天, 2小时, 3分钟, 4秒, 500毫秒
TimeSpan span2 = TimeSpan.Parse("01:02:03"); // 从字符串解析，结果为1小时2分钟3秒
TimeSpan span3 = DateTime.Now - DateTime.Today; // 当前时间与当天开始的时间差

2. 访问 TimeSpan 的属性

TimeSpan 结构体提供了多个属性，允许访问时间间隔的各个部分：

TimeSpan span = new TimeSpan(1, 2, 3, 4, 500);
Console.WriteLine($"Days: {span.Days}");
Console.WriteLine($"Hours: {span.Hours}");
Console.WriteLine($"Minutes: {span.Minutes}");
Console.WriteLine($"Seconds: {span.Seconds}");
Console.WriteLine($"Milliseconds: {span.Milliseconds}");
Console.WriteLine($"TotalDays: {span.TotalDays}"); // 总天数，包括小数部分

3. 使用 TimeSpan 进行计算

TimeSpan 支持加、减、比较等操作，使得时间间隔的计算变得简单：

TimeSpan duration = new TimeSpan(0, 1, 30); // 1小时30分钟
TimeSpan extraTime = new TimeSpan(0, 0, 15); // 15分钟

TimeSpan totalDuration = duration + extraTime; // 结果为1小时45分钟

TimeSpan startTime = DateTime.Now;
// 执行一些操作...
TimeSpan elapsedTime = DateTime.Now - startTime; // 计算操作耗时

Console.WriteLine($"Total duration: {totalDuration}");
Console.WriteLine($"Elapsed time: {elapsedTime}");

4. 格式化 TimeSpan

虽然 TimeSpan 没有直接的 ToString 重载来格式化输出，但可以使用自定义格式字符串或者 ToString 的重载来指定格式：

TimeSpan span = new TimeSpan(1, 2, 3, 4, 500);
Console.WriteLine(span.ToString(@"d\.hh\:mm\:ss\.fff")); // 输出类似 "1.02:03:04.500"

或者使用 ToString 的默认格式，它通常会以较短的格式显示时间间隔：

Console.WriteLine(span.ToString()); // 输出可能类似于 "1.02:03:04.5000000"

注意事项

• 当对 TimeSpan 进行算术运算时，如果结果超出了其表示范围（例如，天数超过 Int64.MaxValue 除以每天的总毫秒数），则会抛出 OverflowException。
• 在处理非常大的时间间隔时，要注意性能和精度问题。

TimeSpan 是处理时间间隔的强大工具，在需要计算时间差或处理时间长度时非常有用。