自学内容网 自学内容网

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

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

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

1. 创建 TimeSpan 实例

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

  • 使用构造函数
  • 使用静态方法 ParseTryParse(从字符串解析)
  • 使用 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 是处理时间间隔的强大工具,在需要计算时间差或处理时间长度时非常有用。


原文地址:https://blog.csdn.net/x1234w4321/article/details/142180211

免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!