C# TimeSpan完全指南

一、什麼是C# TimeSpan

C# TimeSpan是一個結構體，表示一段時間。它可以表示一段時間間隔，也可以表示一天內的時間。

TimeSpan結構體包含三個屬性：Days，Hours和Minutes。每個屬性都是一個整數，表示時間間隔的天數、小時數和分鐘數。

二、創建和初始化TimeSpan

我們可以使用多種方式來創建和初始化TimeSpan對象：

1、通過構造函數（傳遞小時、分鐘和秒）：

TimeSpan ts1 = new TimeSpan(2, 14, 30);

這將創建一個TimeSpan對象，表示2小時、14分鐘和30秒。

2、通過靜態方法FromDays、FromHours、FromMinutes和FromSeconds：

TimeSpan ts2 = TimeSpan.FromDays(1.5);
TimeSpan ts3 = TimeSpan.FromHours(3);
TimeSpan ts4 = TimeSpan.FromMinutes(45);
TimeSpan ts5 = TimeSpan.FromSeconds(30);

這些方法使用一個double型參數來創建一個TimeSpan對象，表示相應的時間間隔。

3、通過常量字元串：

TimeSpan ts6 = TimeSpan.Parse("1.02:30:05.123");
TimeSpan ts7 = TimeSpan.ParseExact("1:02:30:05.123", "d\\:hh\\:mm\\:ss\\.fff", CultureInfo.InvariantCulture);

Parse和ParseExact靜態方法用於將字元串解析為TimeSpan對象。

三、TimeSpan數學運算

我們可以對TimeSpan對象進行數學運算，例如加法、減法和乘法。

1、加法：

TimeSpan ts1 = new TimeSpan(2, 30, 0);
TimeSpan ts2 = new TimeSpan(1, 15, 0);
TimeSpan ts3 = ts1 + ts2;

這會將ts1和ts2相加。

2、減法：

TimeSpan ts1 = new TimeSpan(2, 30, 0);
TimeSpan ts2 = new TimeSpan(1, 15, 0);
TimeSpan ts3 = ts1 - ts2;

這會將ts2從ts1中減去。

3、乘法：

TimeSpan ts1 = new TimeSpan(0, 30, 0);
TimeSpan ts2 = ts1 * 2;

這會將ts1乘以2。

四、TimeSpan屬性和方法

TimeSpan結構體還提供了許多有用的屬性和方法。

1、總時間數（Total）：

TimeSpan ts1 = new TimeSpan(2, 30, 0);
double totalMinutes = ts1.TotalMinutes;
double totalSeconds = ts1.TotalSeconds;

TotalMinutes和TotalSeconds屬性返回TimeSpan對象的總分鐘數和總秒數。

2、最大值和最小值：

TimeSpan maxTimeSpan = TimeSpan.MaxValue;
TimeSpan minTimeSpan = TimeSpan.MinValue;

MaxValue和MinValue屬性返回TimeSpan結構的最大和最小值。

3、ToString和Parse：

TimeSpan ts1 = new TimeSpan(2, 30, 0);
string ts1Str = ts1.ToString();
TimeSpan ts2 = TimeSpan.Parse(ts1Str);

ToString方法將TimeSpan對象轉換為字元串，而Parse方法則將字元串解析為TimeSpan對象。

五、TimeSpan應用場景

TimeSpan廣泛應用於各種計算任務，例如：

1、計算程序的運行時間。

DateTime start = DateTime.Now;
// 程序的主要代碼
DateTime end = DateTime.Now;
TimeSpan ts1 = end - start;

2、分析日誌文件中的時間戳。

string logLine = "2022-01-01 10:30:00 Some log message";
DateTime logTime = DateTime.ParseExact(logLine.Substring(0, 19), "yyyy-MM-dd HH:mm:ss", CultureInfo.InvariantCulture);

這將從日誌行中提取日期和時間部分，然後將其解析為DateTime對象。

3、處理和管理日期和時間。

TimeSpan可以輕鬆處理一些常見的日期和時間操作，例如計算時間間隔、截取日期和時間部分等。

六、總結

在本文中，我們介紹了C# TimeSpan結構體的基本概念、創建和初始化、數學運算、屬性和方法以及應用場景。學習TimeSpan可以幫助我們更輕鬆地處理日期和時間，提高程序的可讀性和可維護性。