String.Format(二）

自定義數字格式字符串

格式說明符 名稱 說明
0
零占位符
如果格式化的值在格式字符串中出現“0”的位置有一個數字，則此數字被復制到結果字符串中。小數點前最左邊的“0”的位置和小數點后最右邊的“0”的位置確定總在結果字符串中出現的數字范圍。

“00”說明符使得值被舍入到小數點前最近的數字，其中零位總被舍去。例如，用“00”格式化 34.5 將得到值 35。

#
數字占位符
如果格式化的值在格式字符串中出現“#”的位置有一個數字，則此數字被復制到結果字符串中。否則，結果字符串中的此位置不存儲任何值。

請注意，如果“0”不是有效數字，此說明符永不顯示“0”字符，即使“0”是字符串中唯一的數字。如果“0”是所顯示的數字中的有效數字，則顯示“0”字符。

“##”格式字符串使得值被舍入到小數點前最近的數字，其中零總被舍去。例如，用“##”格式化 34.5 將得到值 35。

.
小數點
格式字符串中的第一個“.”字符確定格式化的值中的小數點分隔符的位置；任何其他“.”字符被忽略。

用作小數點分隔符的實際字符由控制格式化的 NumberFormatInfo 的 NumberDecimalSeparator 屬性確定。

,
千位分隔符和數字比例換算
“,”字符可作為千位分隔符說明符和數字比例換算說明符。

千位分隔符說明符：如果在兩個數字占位符（0 或 #）之間指定一個或多個“,”字符用于設置數字整數位的格式，則在輸出的整數部分中每個數字組之間插入一個組分隔符字符。

當前 NumberFormatInfo 對象的 NumberGroupSeparator 和 NumberGroupSizes 屬性將確定用作數字組分隔符的字符以及每個數字組的大小。例如，如果使用字符串“#,#”和固定區域性對數字 1000 進行格式化，則輸出為“1,000”。

數字比例換算說明符：如果在緊鄰顯式或隱式小數點的左側指定一個或多個“,”字符，則每出現一個數字比例換算說明符便將要格式化的數字除以 1000。例如，如果使用字符串“0,,”對數字 1000000000 進行格式化，則輸出為“100”。

可以在同一格式字符串中使用千位分隔符說明符和數字比例換算說明符。例如，如果使用字符串“#,0,,”和固定區域性對數字 10000000000 進行格式化，則輸出為“1,000”。

%
百分比占位符
在格式字符串中出現“%”字符將導致數字在格式化之前乘以 100。適當的符號插入到數字本身在格式字符串中出現“%”的位置。使用的百分比字符由當前的 NumberFormatInfo 類確定。

E0

E+0

E-0

e0

e+0

e-0
科學記數法
如果“E”、“E+”、“E-”、“e”、“e+”或“e-”中的任何一個字符串出現在格式字符串中，而且后面緊跟至少一個“0”字符，則數字用科學記數法來格式化，在數字和指數之間插入“E”或“e”。跟在科學記數法指示符后面的“0”字符數確定指數輸出的最小位數。“E+”和“e+”格式指示符號字符（正號或負號）應總是置于指數前面。“E”、“E-”、“e”或“e-”格式指示符號字符僅置于負指數前面。

\
轉義符
在 C# 和 C++ 中，反斜杠字符使格式字符串中的下一個字符被解釋為轉義序列。它與傳統的格式化序列一起使用，如“\n”（換行）。

在某些語言中，轉義符本身用作文本時必須跟在轉義符之后。否則，編譯器將該字符理解為轉義符。使用字符串“\\”顯示“\”。

請注意，Visual Basic 中不支持此轉義符，但是 ControlChars 提供相同的功能。

’ABC’

“ABC”
字符串
引在單引號或雙引號中的字符被復制到結果字符串中，而且不影響格式化。

;
部分分隔符
“;”字符用于分隔格式字符串中的正數、負數和零各部分。

其他
所有其他字符
所有其他字符被復制到結果字符串中，而且不影響格式化。

標準 DateTime 格式字符串

格式說明符 名稱 說明
d
短日期模式
表示由當前 ShortDatePattern 屬性定義的自定義 DateTime 格式字符串。

例如，用于固定區域性的自定義格式字符串為“MM/dd/yyyy”。

D
長日期模式
表示由當前 LongDatePattern 屬性定義的自定義 DateTime 格式字符串。

例如，用于固定區域性的自定義格式字符串為“dddd, dd MMMM yyyy”。

f
完整日期/時間模式（短時間）
表示長日期 (D) 和短時間 (t) 模式的組合，由空格分隔。

F
完整日期/時間模式（長時間）
表示由當前 FullDateTimePattern 屬性定義的自定義 DateTime 格式字符串。

例如，用于固定區域性的自定義格式字符串為“dddd, dd MMMM yyyy HH:mm:ss”。

g
常規日期/時間模式（短時間）
表示短日期 (d) 和短時間 (t) 模式的組合，由空格分隔。

G
常規日期/時間模式（長時間）
表示短日期 (d) 和長時間 (T) 模式的組合，由空格分隔。

M 或 m
月日模式
表示由當前 MonthDayPattern 屬性定義的自定義 DateTime 格式字符串。

例如，用于固定區域性的自定義格式字符串為“MMMM dd”。

o
往返日期/時間模式
表示使用保留時區信息的模式的自定義 DateTime 格式字符串。該模式專用于往返 DateTime 格式（包括文本形式的 Kind 屬性）。隨后將 Parse 或 ParseExact 與正確的 Kind 屬性值一起使用可以對格式化的字符串進行反向分析。

自定義格式字符串為“yyyy’-'MM’-'dd’T'HH’:'mm’:’ss.fffffffK”。

用于此說明符的模式是定義的標準。因此，無論所使用的區域性或所提供的格式提供程序是什么，它總是相同的。

R 或 r
RFC1123 模式
表示由當前 RFC1123Pattern 屬性定義的自定義 DateTime 格式字符串。該模式是定義的標準，并且屬性是只讀的。因此，無論所使用的區域性或所提供的格式提供程序是什么，它總是相同的。

定義格式字符串為“ddd, dd MMM yyyy HH’:'mm’:’ss ‘GMT’”。

格式化不會修改正在格式化的 DateTime 對象的值。因此，應用程序在使用此格式說明符之前必須將該值轉換為協調世界時 (UTC)。

s
可排序的日期/時間模式；符合 ISO 8601
表示由當前 SortableDateTimePattern 屬性定義的自定義 DateTime 格式字符串。此模式是定義的標準，并且屬性是只讀的。因此，無論所使用的區域性或所提供的格式提供程序是什么，它總是相同的。

自定義格式字符串為“yyyy’-'MM’-'dd’T'HH’:'mm’:’ss”。

t
短時間模式
表示由當前 ShortTimePattern 屬性定義的自定義 DateTime 格式字符串。

例如，用于固定區域性的自定義格式字符串為“HH:mm”。

T
長時間模式
表示由當前 LongTimePattern 屬性定義的自定義 DateTime 格式字符串。

例如，用于固定區域性的自定義格式字符串為“HH:mm:ss”。

u
通用的可排序日期/時間模式
表示由當前 UniversalSortableDateTimePattern 屬性定義的自定義 DateTime 格式字符串。此模式是定義的標準，并且屬性是只讀的。因此，無論所使用的區域性或所提供的格式提供程序是什么，它總是相同的。

自定義格式字符串為“yyyy’-'MM’-'dd HH’:'mm’:’ss’Z'”。

格式化日期和時間時不進行時區轉換。因此，應用程序在使用此格式說明符之前必須將本地日期和時間轉換為協調世界時 (UTC)。

U
通用的可排序日期/時間模式
表示由當前 FullDateTimePattern 屬性定義的自定義 DateTime 格式字符串。

此模式與完整日期/長時間 (F) 模式相同。但是，格式化將作用于等效于正在格式化的 DateTime 對象的協調世界時 (UTC)。

Y 或 y
年月模式
表示由當前 YearMonthPattern 屬性定義的自定義 DateTime 格式字符串。

例如，用于固定區域性的自定義格式字符串為“yyyy MMMM”。

任何其他單個字符
（未知說明符）
未知說明符將引發運行時格式異常。