.NET FormatString 格式化字串完整速查表：日期、數字、自訂格式

前言

ToString("format")、string.Format、Console.WriteLine、插值字串 $"{value:format}" 都依賴 **.NET 格式化字串**。本文整理標準日期/時間、數字格式代碼、自訂格式字元、文化特性影響與實用範例，供快速查閱。

一、標準日期/時間格式 (單一字元)

所有標準格式受 CultureInfo.CurrentCulture 影響。指定文化：dt.ToString("D", new CultureInfo("en-US"))。

二、標準數字格式

預設精度對照 (G 格式)

三、自訂日期/時間格式字元

常用自訂格式範例

DateTime now = DateTime.Now; // 2023-06-15 15:45:30.123
now.ToString("yyyy-MM-dd")           // 2023-06-15
now.ToString("yyyy/MM/dd HH:mm:ss")  // 2023/06/15 15:45:30
now.ToString("yyyy年MM月dd日")        // 2023年06月15日
now.ToString("HH:mm:ss.fff")         // 15:45:30.123
now.ToString("yyyy-MM-ddTHH:mm:ssK") // 2023-06-15T15:45:30+08:00 (ISO 8601 含時區)

四、自訂數字格式字元

區隔符進階：正數;負數;零

double pos = 123, neg = -45, zero = 0;
string fmt = "+0.00;-0.00;[Zero]";
pos.ToString(fmt)  // +123.00
neg.ToString(fmt)  // -45.00
zero.ToString(fmt) // [Zero]

五、文化特性與 IFormatProvider

var dt = DateTime.Now;
var num = 1234.56;

dt.ToString("D", new CultureInfo("en-US"));   // Thursday, June 15, 2023
dt.ToString("D", new CultureInfo("zh-TW"));   // 2023年6月15日
dt.ToString("D", CultureInfo.InvariantCulture); // 固定美式格式

num.ToString("C", new CultureInfo("zh-TW"));  // NT$1,234.56
num.ToString("C", new CultureInfo("en-US"));  // $1,234.56
num.ToString("C", CultureInfo.InvariantCulture); // ¤1,234.56 (通用貨幣符號)

六、實用組合範例

// Log 時間戳
$"{DateTime.Now:yyyy-MM-dd HH:mm:ss.fff} [INFO] Service started"

// 檔案名稱安全時間
$"backup_{DateTime.Now:yyyyMMdd_HHmmss}.bak"

// 金額顯示 (台幣)
$"{amount:N0} 元"           // 1,234 元
$"{amount:C0}"              // NT$1,234

// 百分比進度
$"{progress:P1}"            // 56.7%

// 十六進位位址
$"0x{address:X8}"           // 0x00401000

// 固定寬度對齊 (配合 PadLeft)
$"{id:D5}"                  // 00123

七、常見錯誤

總結

掌握 **標準格式 (單一字元)** 解決 80% 需求，**自訂格式字元** 處理剩餘 20% 精細控制。記住：yyyy-MM-dd、HH:mm:ss、N2、C2、P1、X8 是最常用組合。指定 CultureInfo 確保跨環境一致性。