C# DateTime 與 TimeSpan 時間處理完整指南：建立、格式化、運算、時區與效能

一、DateTime 核心建構與取得當前時間

二、格式化輸出：標準與自訂格式字串

DateTime now = DateTime.Now;

// 標準格式
Console.WriteLine(now.ToString("d")); // 短日期
Console.WriteLine(now.ToString("D")); // 長日期
Console.WriteLine(now.ToString("t")); // 短時間
Console.WriteLine(now.ToString("T")); // 長時間
Console.WriteLine(now.ToString("f")); // 完整日期時間（短時間）
Console.WriteLine(now.ToString("F")); // 完整日期時間（長時間）
Console.WriteLine(now.ToString("g")); // 一般（短日期+短時間）
Console.WriteLine(now.ToString("G")); // 一般（短日期+長時間）
Console.WriteLine(now.ToString("u")); // 通用可排序 yyyy-MM-dd HH:mm:ssZ
Console.WriteLine(now.ToString("o")); // 往返格式 yyyy-MM-ddTHH:mm:ss.fffffffK

// 自訂格式
string custom = now.ToString("yyyy-MM-dd HH:mm:ss.fff");
Console.WriteLine(custom); // 2024-01-15 14:30:45.123

三、TimeSpan：時間間隔運算

建立 TimeSpan

// 從時間單位建構
TimeSpan ts1 = new TimeSpan(4, 12, 0, 0); // 4天12小時
TimeSpan ts2 = new TimeSpan(2, 12, 0, 0); // 2天12小時
TimeSpan total = ts1 + ts2; // 7天

// 從 DateTime 相減得到
DateTime start = DateTime.Now;
DateTime end = start.AddHours(2.5);
TimeSpan diff = end - start; // 2.5小時

常用屬性

格式化輸出

TimeSpan ts = new TimeSpan(7, 12, 30, 15, 500);
Console.WriteLine(ts.ToString());        // 7.12:30:15.5000000
Console.WriteLine(ts.ToString(@"dd\.hh\:mm\:ss")); // 07.12:30:15

四、DateTime 日期時間運算：不可變模式

所有運算方法回傳新實例，原物件不變：

五、時區與 Kind 屬性：避開常見陷阱

關鍵轉換方法

DateTime local = DateTime.Now;
DateTime utc = local.ToUniversalTime(); // Local → Utc
DateTime local2 = utc.ToLocalTime();    // Utc → Local

DateTime unspecified = new DateTime(2024, 1, 1, 12, 0, 0); // Kind=Unspecified
DateTime asUtc = DateTime.SpecifyKind(unspecified, DateTimeKind.Utc);
DateTime asLocal = DateTime.SpecifyKind(unspecified, DateTimeKind.Local);

TimeZoneInfo 進階時區轉換

TimeZoneInfo taipei = TimeZoneInfo.FindSystemTimeZoneById("Taipei Standard Time");
DateTime utc = DateTime.UtcNow;
DateTime taipeiTime = TimeZoneInfo.ConvertTimeFromUtc(utc, taipei);

六、高效能與最佳實務

1. 大量運算用 DateTime.UtcNow：避免本地時區查詢開銷
2. 資料庫儲存統一用 UTC：應用層轉換顯示
3. 避免在迴圈中重複呼叫 DateTime.Now：快取當前時間
4. 序列化指定 DateTimeKind.Utc：防止反序列化時區錯位
5. NodaTime 套件：企業級專案建議引入，提供 Instant、ZonedDateTime、LocalDateTime 等更嚴謹型別