C# 時間操作工具類 DateTimeHelper：相對時間、差值、生日提醒、星期轉換

時間處理是業務系統的高頻需求：顯示「3分鐘前」、計算兩日期相差天數、生日提醒、英文星期轉中文等。本文整理一個静态类 DateTimeHelper，封裝 7 個實用方法，代碼緊湊、邊界處理完善，可直接納入公共庫。

方法速查表

核心代碼實現

public static class DateTimeHelper {
    // 1. 相對時間
    public static string DateStringFromNow(DateTime dt) {
        TimeSpan span = DateTime.Now - dt;
        if (span.TotalDays > 60) return dt.ToShortDateString();
        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 "1秒前";
    }

    // 2. 日期差值 (總天數/整天數)
    public static string DateDiff(DateTime dt1, DateTime dt2, bool isTotal) {
        TimeSpan ts = dt2 - dt1;
        return isTotal ? ts.TotalDays.ToString() : ts.Days.ToString();
    }

    // 3. 詳細差值字符串
    public static string DateDiff(DateTime dt1, DateTime dt2) {
        TimeSpan ts = new TimeSpan(dt1.Ticks).Subtract(new TimeSpan(dt2.Ticks)).Duration();
        return $"{ts.Days}天{ts.Hours}小時{ts.Minutes}分鐘{ts.Seconds}秒";
    }

    // 4. 英文星期轉中文
    public static string WhichDay(string enWeek) {
        return enWeek.Trim() switch {
            "Sunday" => "星期日", "Monday" => "星期一", "Tuesday" => "星期二",
            "Wednesday" => "星期三", "Thursday" => "星期四", "Friday" => "星期五",
            "Saturday" => "星期六", _ => enWeek
        };
    }

    // 5. 日期比較 (當前是否 >= 目標日期+N天)
    public static bool CompareDate(string today, string writeDate, int n) {
        DateTime t = Convert.ToDateTime(today);
        DateTime w = Convert.ToDateTime(writeDate).AddDays(n);
        return t < w; // 未超過返回 true
    }

    // 6. 生日提醒
    public static string GetBirthdayTip(DateTime birthday) {
        DateTime now = DateTime.Now;
        int nowM = now.Month, birM = birthday.Month;

        // 跨年邊界處理
        if (nowM == 12 && birM == 1) return $"下月{birthday.Day}號";
        if (nowM == 1 && birM == 12) return $"上月{birthday.Day}號";

        int diffM = nowM - birM;
        if (diffM == 1) return $"上月{birthday.Day}號";
        if (diffM == -1) return $"下月{birthday.Day}號";
        if (diffM == 0) {
            if (now.Day == birthday.Day) return "今天";
            return $"本月{birthday.Day}號";
        }
        if (diffM > 1) return $"已過{diffM}月";
        return $"{birM}月{birthday.Day}日";
    }
}

使用示例

// 動態流時間
var postTime = DateTime.Now.AddHours(-3);
lblTime.Text = DateTimeHelper.DateStringFromNow(postTime); // "3小時前"

// 會員剩餘天數
string daysLeft = DateTimeHelper.DateDiff(DateTime.Now, vip.ExpireDate, false); // 整天數

// 活動倒計時
string countdown = DateTimeHelper.DateDiff(DateTime.Now, act.EndTime); // "2天5小時30分鐘10秒"

// 星期本地化
string cnWeek = DateTimeHelper.WhichDay(DateTime.Now.DayOfWeek.ToString()); // "星期三"

// 生日營銷短信
string tip = DateTimeHelper.GetBirthdayTip(user.BirthDate); // "下月5號"
SendSms($"親，{tip}就是您的生日啦，提前祝壽！");

避坑指南

• 時區一致性：服務器與數據庫時區必須統一 (建議均用 UTC 存儲，展示層按用戶時區轉換)，否則相對時間會出現負值或偏差。
• 閏年/月末邊界：AddDays、AddMonths 已正確處理，但手動計算月份差 (如 now.Month - birth.Month) 跨年會出錯，代碼中已通過 12↔1 判斷修正。
• 性能：方法均為純計算無 I/O，可高頻調用；若極端高併發 (百萬 QPS) 可考慮緩存當前 DateTime.Now 減少系統調用。
• 本地化擴展：WhichDay 可改用 CultureInfo.CurrentCulture.DateTimeFormat.GetDayName 獲取系統當前語言的星期名，避免硬編碼。

將 DateTimeHelper 引入項目，即可在 Controller、ViewModel、Service 中一行代碼解決 90% 時間顯示需求。