TimeSpan 表示時間間隔,是 DateTime 相減的結果類型。掌握其屬性(Total* vs 整數部分)、建構方式、靜態工廠方法與格式化輸出,是處理時間差、排程、倒數計時的基礎。
TimeSpan.MaxValue // 10675199.02:48:05.4775807
TimeSpan.MinValue // -10675199.02:48:05.4775808
TimeSpan.Zero // 00:00:00
TimeSpan.TicksPerDay // 864,000,000,000
TimeSpan.TicksPerHour // 36,000,000,000
TimeSpan.TicksPerMinute // 600,000,000
TimeSpan.TicksPerSecond // 10,000,000
TimeSpan.TicksPerMillisecond // 10,000
TimeSpan.FromDays(1.5) // 1.12:00:00
TimeSpan.FromHours(25) // 1.01:00:00
TimeSpan.FromMinutes(90) // 01:30:00
TimeSpan.FromSeconds(3661) // 01:01:01
TimeSpan.FromMilliseconds(1500) // 00:00:01.5000000
TimeSpan.FromTicks(864000000000) // 1.00:00:00
TimeSpan.Parse("1.02:30:00") // 解析字串
TimeSpan.ParseExact("01:30", "mm\\:ss", null) // 指定格式解析
new TimeSpan(ticks) // 從 Ticks
new TimeSpan(hours, minutes, seconds) // 時分秒
new TimeSpan(days, hours, minutes, seconds) // 天時分秒
new TimeSpan(days, hours, minutes, seconds, milliseconds) // 含毫秒
| 屬性 | 意義 | 範例 (1.5 天) |
|---|---|---|
| Days | 天數部分(0~) | 1 |
| Hours | 小時部分(0~23) | 12 |
| Minutes | 分鐘部分(0~59) | 0 |
| Seconds | 秒數部分(0~59) | 0 |
| Milliseconds | 毫秒部分(0~999) | 0 |
| Ticks | 總 Ticks (100ns) | 129,600,000,000,000 |
| TotalDays | 總天數 (double) | 1.5 |
| TotalHours | 總小時數 | 36 |
| TotalMinutes | 總分鐘數 | 2160 |
| TotalSeconds | 總秒數 | 129,600 |
| TotalMilliseconds | 總毫秒數 | 129,600,000 |
⚠️ 常見錯誤:用 Hours 以為是總小時數,實際只取餘數部分。需用 TotalHours。
var t1 = TimeSpan.FromHours(2);
var t2 = TimeSpan.FromMinutes(90);
t1.Add(t2) // 加法,回傳新 TimeSpan
t1.Subtract(t2) // 減法
t1.Negate() // 取反
t1.Duration() // 絕對值
t1.CompareTo(t2) // 比較 -1/0/1
t1.Equals(t2) // 相等判斷
t1.ToString() // 預設格式 "1.12:00:00"
t1.ToString(@"hh\:mm") // 自訂格式 (需轉義冒號)
public static string GetRelativeTime(DateTime dt)
{
var span = DateTime.Now - dt;
if (span.TotalDays >= 60) return dt.ToString("yyyy/MM/dd");
if (span.TotalDays >= 30) return "約 1 個月前";
if (span.TotalDays >= 14) return "約 2 週前";
if (span.TotalDays >= 7) return "約 1 週前";
if (span.TotalDays >= 1) return $"{(int)Math.Floor(span.TotalDays)} 天前";
if (span.TotalHours >= 1) return $"{(int)Math.Floor(span.TotalHours)} 小時前";
if (span.TotalMinutes >= 1) return $"{(int)Math.Floor(span.TotalMinutes)} 分鐘前";
if (span.TotalSeconds >= 1) return $"{(int)Math.Floor(span.TotalSeconds)} 秒前";
return "剛剛";
}
DateTime now = DateTime.Now;
TimeSpan ts = TimeSpan.FromHours(2);
DateTime future = now + ts; // 加法
DateTime past = now - ts; // 減法
TimeSpan diff = future - now; // 兩 DateTime 相減得 TimeSpan
TimeOnly:僅時間(無日期),適合營業時間、鬧鐘。DateOnly:僅日期(無時間),適合生日、截止日。TimeSpan,語意更清晰。TimeSpan 核心在於區分 **「部分屬性」**(Days/Hours/Minutes/Seconds)與 **「總計屬性」**(TotalDays/TotalHours...)。計算相對時間、排程間隔、逾時設定時,務必使用 Total* 系列。善用 From* 工廠方法建構,配合自訂 ToString 格式化,輕鬆駕馭時間間隔運算。