C# DateTime 格式化大全：標準/自訂格式字串、常用屬性與 Parse 技巧完整速查表

DateTime 格式化是 C# 開發中最高頻操作之一。本文整理**標準格式字串**、**自訂格式字串**、**常用屬性/方法**、**Parse/TryParse 最佳實務**與**時區/文化特性陷阱**，做成一張可離線備查的完整速查表。

一、標準格式字串 (Standard Format Strings)

單一字元，輸出固定模式，**受 CultureInfo.CurrentCulture 影響**。

二、自訂格式字串 (Custom Format Strings)

組合格式字元，**區分大小寫**，不受文化特性影響 (除非用 DateTimeFormatInfo)。

常用自訂格式範例

var dt = new DateTime(2023, 10, 31, 14, 30, 15, 123);
dt.ToString("yyyyMMddHHmmss");        // 20231031143015 (檔名/Log 常用)
dt.ToString("yyyy-MM-dd HH:mm:ss");   // 2023-10-31 14:30:15 (資料庫/顯示)
dt.ToString("yyyy/MM/dd HH:mm:ss.fff"); // 2023/10/31 14:30:15.123 (高精度)
dt.ToString("yyyy年MM月dd日 HH:mm");  // 2023年10月31日 14:30 (中文報表)
dt.ToString("ddd, dd MMM yyyy HH':'mm':'ss 'GMT'", CultureInfo.InvariantCulture); // RFC1123 手刻

三、常用屬性與方法

四、Parse / TryParse 最佳實務

// 1. 嚴格格式解析 (推薦)
DateTime dt;
bool ok = DateTime.TryParseExact(
    input, 
    "yyyy-MM-dd HH:mm:ss", 
    CultureInfo.InvariantCulture, // 固定文化特性，避免伺服器設定影響
    DateTimeStyles.None, 
    out dt);

// 2. 多格式嘗試
string[] formats = { "yyyy-MM-dd", "yyyy/MM/dd", "yyyy.MM.dd" };
ok = DateTime.TryParseExact(input, formats, CultureInfo.InvariantCulture, DateTimeStyles.None, out dt);

// 3. 解析含時區字串 (ISO 8601 / RFC3339)
ok = DateTimeOffset.TryParseExact(input, "O", CultureInfo.InvariantCulture, DateTimeStyles.RoundtripKind, out DateTimeOffset dto);
// DateTimeOffset 保留時區資訊，比 DateTime 更安全

// 4. 避免直接用 DateTime.Parse(input) — 依賴 CurrentCulture，部署環境不同會出錯

五、時區與文化特性陷阱

• DateTime.Kind：Unspecified (預設)、Utc、Local。ToLocalTime() 僅對 Utc 生效；Unspecified 視同 Local 轉換，**極易產生 Bug**。
• 跨時區儲存：資料庫**永遠存 UTC** (DateTime.UtcNow 或 DateTimeOffset.UtcNow)，顯示時再轉使用者時區。
• 文化特性：ToString("D") 等標準格式**受 Thread.CurrentThread.CurrentCulture 影響**。Log/儲存/傳輸**務必指定 CultureInfo.InvariantCulture**。
• .NET 6+ 建議：使用 DateOnly、TimeOnly (無時區、無日期/時間混淆)、TimeZoneInfo、TimeProvider (可測試時間)。

六、速查小抄 (列印貼螢幕)

// 檔名安全
DateTime.Now.ToString("yyyyMMdd_HHmmss_ffff")

// 資料庫 DateTime 欄位
DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss.fff", CultureInfo.InvariantCulture)

// ISO 8601 / JSON 標準
DateTime.UtcNow.ToString("O") // 往返格式
DateTimeOffset.UtcNow.ToString("O") // 含時區

// RFC1123 / HTTP Header
DateTime.UtcNow.ToString("r", CultureInfo.InvariantCulture)

// 中文顯示
DateTime.Now.ToString("yyyy年MM月dd日 HH:mm:ss", new CultureInfo("zh-TW"))

// 週幾
DateTime.Now.ToString("dddd", new CultureInfo("zh-TW")) // 星期二

結語

掌握 DateTime 格式化三大核心：**標準格式速度快、自訂格式彈性大、文化特性/時區必須顯式指定**。養成「儲存用 UTC + InvariantCulture、顯示才套用使用者文化特性」的習慣，能消除 90% 的日期時間 Bug。