C#日期和時間：DateTime轉字符串全面指南

在 C# 開發中，DateTime類型的時間格式化是高頻操作場景。無論是日志記錄、數據持久化，還是接口數據交互，合理的時間字符串格式都能顯著提升系統的可讀性和兼容性。本文將通過 20 + 實戰示例，全面解析DateTime轉換為字符串的核心方法與最佳實踐。

一、基礎轉換方法：快速獲取常用格式

1. 無參 ToString ()：本地化默認格式

DateTime.Now.ToString(); // 2023-10-25 14:30:45（依賴系統區域設置）

該方法返回基于當前系統文化設置的默認格式，適用于快速調試，但不建議用于跨環境交互。

2. 系統時間相關方法

方法	示例輸出	用途說明
ToFileTime()	133756416859912816	獲取 Windows 文件時間（長整型）
ToFileTimeUtc()	133756704859912816	UTC 格式的文件時間
ToLocalTime()	2023-10-25 22:30:45	轉換為本地時區時間
ToUniversalTime()	2023-10-25 06:30:45	轉換為 UTC 時間

3. 預定義格式方法

DateTime.Now.ToLongDateString(); // "2023年10月25日"（中文環境）
DateTime.Now.ToShortDateString(); // "2023-10-25"
DateTime.Now.ToLongTimeString(); // "14:30:45"
DateTime.Now.ToShortTimeString(); // "14:30"

這些方法提供了日期和時間的粗細粒度劃分，適用于需要快速生成特定格式的場景。

二、自定義格式字符串：精準控制輸出

1. 標準格式說明符（單個字符）

通過ToString(string format)或string.Format使用格式字符：

格式符	示例（2023-10-25 14:30:45）	說明
d	2023-10-25	短日期格式
D	2023 年 10 月 25 日	長日期格式
t	14:30	短時間格式
T	14:30:45	長時間格式
f	2023 年 10 月 25 日 14:30	完整日期 + 短時間
F	2023 年 10 月 25 日 14:30:45	完整日期 + 長時間
s	2023-10-25T14:30:45	ISO 8601 排序日期格式
u	2023-10-25 14:30:45Z	UTC 通用排序格式
r	Wed, 25 Oct 2023 14:30:45 GMT	RFC 1123 標準格式

示例代碼：

DateTime.Now.ToString("s"); // "2023-10-25T14:30:45"（適合API返回）
string.Format("{0:u}", DateTime.Now); // "2023-10-25 14:30:45Z"（UTC標準化）

2. 自定義格式符（組合字符）

通過組合yyyy/MM/dd HH:mm:ss等字符實現任意格式：

字符	說明	示例（2023-10-25 14:30:45）
yyyy	四位數年份	2023
MM	兩位數月份（01-12）	10
dd	兩位數日期	25
HH	24 小時制小時（00-23）	14
mm	分鐘（00-59）	30
ss	秒（00-59）	45
fff	毫秒（000-999）	450

復雜示例：

// 生成帶毫秒的日志時間戳
DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss.fff"); // "2023-10-25 14:30:45.450"// 生成Excel兼容的日期時間
DateTime.Now.ToString("yyyy/mm/dd hh:mm:ss tt"); // "2023/10/25 02:30:45 下午"（帶AM/PM標識）

三、高級時間操作與格式處理

1. 時間偏移與計算

通過Add系列方法實現時間加減后格式化：

// 增加1.5天（36小時）
DateTime.Now.AddDays(1.5).ToString("yyyy-MM-dd HH:mm"); // "2023-10-27 02:30"// 增加10000 ticks（1毫秒=10000 ticks）
DateTime.Now.AddTicks(10000).ToString("yyyy-MM-dd HH:mm:ss.fff"); // 精確到毫秒級增量

2. 多文化格式支持

通過CultureInfo指定非默認文化格式：

using System.Globalization;// 生成法語格式日期
DateTime.Now.ToString("D", CultureInfo.CreateSpecificCulture("fr-FR")); // "25 octobre 2023"// 生成日本格式時間
DateTime.Now.ToString("t", CultureInfo.GetCultureInfo("ja-JP")); // "14:30"

3. 特殊格式處理

需求場景	實現代碼	輸出示例
生成 ISO 8601 完整格式	DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mm:ssZ")	“2023-10-25T06:30:45+08:00”
去除時間部分	DateTime.Now.Date.ToString("yyyy-MM-dd")	“2023-10-25”
生成時間戳（秒級）	((DateTimeOffset)DateTime.Now).ToUnixTimeSeconds().ToString()	“1698220245”
生成時間戳（毫秒級）	((DateTimeOffset)DateTime.Now).ToUnixTimeMilliseconds().ToString()	“1698220245450”

四、常見問題與最佳實踐

1. 時區轉換陷阱

• UTC 與本地時間：始終明確時間的時區屬性，避免混合使用ToLocalTime()和ToUniversalTime()
• 跨平臺兼容性：優先使用ISO 8601格式（如s/u/r），避免依賴系統區域設置

2. 性能優化

• 高頻轉換場景使用StringBuilder而非字符串拼接
• 預定義格式字符串可緩存重用，避免重復解析

3. 空值處理

DateTime? nullableDate = null;
string result = nullableDate?.ToString("yyyy-MM-dd") ?? "未指定時間"; // 安全轉換

4. 單元測試建議

對關鍵格式進行斷言測試：

var date = new DateTime(2023, 10, 25, 14, 30, 45);
Assert.AreEqual("2023-10-25", date.ToString("d"));
Assert.AreEqual("25 octobre 2023", date.ToString("D", CultureInfo.French));

五、總結：選擇合適的格式化方案

場景分類	推薦方法	示例代碼	優勢特點
快速調試	ToString()	DateTime.Now.ToString()	無需參數，快速查看
標準化輸出	標準格式符（如 “s”/“u”）	date.ToString("s")	跨平臺兼容
自定義格式	自定義格式字符串	date.ToString("yyyy/MM/dd HH:mm")	靈活控制輸出樣式
跨文化支持	帶CultureInfo的 ToString	date.ToString("D", fr-FR)	多語言環境適配
時間戳生成	ToUnixTimeSeconds/ToFileTime	((DateTimeOffset)date).ToUnixTimeSeconds()	數值化時間表示

掌握DateTime的格式化技巧，能有效提升系統在數據交互、日志記錄、報表生成等場景的健壯性。建議在實際開發中根據具體需求（如目標系統格式要求、性能敏感度、文化兼容性）選擇最合適的轉換方案，并通過單元測試確保格式的一致性。