深入理解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 是处理时间间隔的强大工具，在需要计算时间差或处理时间长度时非常有用。