萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET TimeSpan 完整使用指南:屬性、方法、建構、格式化與實用範例

前言

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)

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) // 含毫秒

四、屬性:整數部分 vs 總計

屬性意義範例 (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") // 自訂格式 (需轉義冒號)

六、實用範例:人性化相對時間(如「3分鐘前」)

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 與 TimeSpan 互轉速查

DateTime now = DateTime.Now;
TimeSpan ts = TimeSpan.FromHours(2);

DateTime future = now + ts;      // 加法
DateTime past = now - ts;        // 減法
TimeSpan diff = future - now;    // 兩 DateTime 相減得 TimeSpan

八、.NET 6+ 新功能:TimeOnly / DateOnly

  • TimeOnly:僅時間(無日期),適合營業時間、鬧鐘。
  • DateOnly:僅日期(無時間),適合生日、截止日。
  • 它們可直接加減 TimeSpan,語意更清晰。

結語

TimeSpan 核心在於區分 **「部分屬性」**(Days/Hours/Minutes/Seconds)與 **「總計屬性」**(TotalDays/TotalHours...)。計算相對時間、排程間隔、逾時設定時,務必使用 Total* 系列。善用 From* 工廠方法建構,配合自訂 ToString 格式化,輕鬆駕馭時間間隔運算。

copyright © 萬盛學電腦網 all rights reserved