String.Format(二）

自定義數(shù)字格式字符串

格式說明符 名稱 說明
0
零占位符
如果格式化的值在格式字符串中出現(xiàn)“0”的位置有一個(gè)數(shù)字，則此數(shù)字被復(fù)制到結(jié)果字符串中。小數(shù)點(diǎn)前最左邊的“0”的位置和小數(shù)點(diǎn)后最右邊的“0”的位置確定總在結(jié)果字符串中出現(xiàn)的數(shù)字范圍。

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

#
數(shù)字占位符
如果格式化的值在格式字符串中出現(xiàn)“#”的位置有一個(gè)數(shù)字，則此數(shù)字被復(fù)制到結(jié)果字符串中。否則，結(jié)果字符串中的此位置不存儲(chǔ)任何值。

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

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

.
小數(shù)點(diǎn)
格式字符串中的第一個(gè)“.”字符確定格式化的值中的小數(shù)點(diǎn)分隔符的位置；任何其他“.”字符被忽略。

用作小數(shù)點(diǎn)分隔符的實(shí)際字符由控制格式化的 NumberFormatInfo 的 NumberDecimalSeparator 屬性確定。

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

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

當(dāng)前 NumberFormatInfo 對(duì)象的 NumberGroupSeparator 和 NumberGroupSizes 屬性將確定用作數(shù)字組分隔符的字符以及每個(gè)數(shù)字組的大小。例如，如果使用字符串“#,#”和固定區(qū)域性對(duì)數(shù)字 1000 進(jìn)行格式化，則輸出為“1,000”。

數(shù)字比例換算說明符：如果在緊鄰顯式或隱式小數(shù)點(diǎn)的左側(cè)指定一個(gè)或多個(gè)“,”字符，則每出現(xiàn)一個(gè)數(shù)字比例換算說明符便將要格式化的數(shù)字除以 1000。例如，如果使用字符串“0,,”對(duì)數(shù)字 1000000000 進(jìn)行格式化，則輸出為“100”。

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

%
百分比占位符
在格式字符串中出現(xiàn)“%”字符將導(dǎo)致數(shù)字在格式化之前乘以 100。適當(dāng)?shù)姆?hào)插入到數(shù)字本身在格式字符串中出現(xiàn)“%”的位置。使用的百分比字符由當(dāng)前的 NumberFormatInfo 類確定。

E0

E+0

E-0

e0

e+0

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

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

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

請(qǐng)注意，Visual Basic 中不支持此轉(zhuǎn)義符，但是 ControlChars 提供相同的功能。

’ABC’

“ABC”
字符串
引在單引號(hào)或雙引號(hào)中的字符被復(fù)制到結(jié)果字符串中，而且不影響格式化。

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

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

標(biāo)準(zhǔn) DateTime 格式字符串

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

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

D
長(zhǎng)日期模式
表示由當(dāng)前 LongDatePattern 屬性定義的自定義 DateTime 格式字符串。

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

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

F
完整日期/時(shí)間模式（長(zhǎng)時(shí)間）
表示由當(dāng)前 FullDateTimePattern 屬性定義的自定義 DateTime 格式字符串。

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

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

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

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

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

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

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

用于此說明符的模式是定義的標(biāo)準(zhǔn)。因此，無論所使用的區(qū)域性或所提供的格式提供程序是什么，它總是相同的。

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

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

格式化不會(huì)修改正在格式化的 DateTime 對(duì)象的值。因此，應(yīng)用程序在使用此格式說明符之前必須將該值轉(zhuǎn)換為協(xié)調(diào)世界時(shí) (UTC)。

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

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

t
短時(shí)間模式
表示由當(dāng)前 ShortTimePattern 屬性定義的自定義 DateTime 格式字符串。

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

T
長(zhǎng)時(shí)間模式
表示由當(dāng)前 LongTimePattern 屬性定義的自定義 DateTime 格式字符串。

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

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

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

格式化日期和時(shí)間時(shí)不進(jìn)行時(shí)區(qū)轉(zhuǎn)換。因此，應(yīng)用程序在使用此格式說明符之前必須將本地日期和時(shí)間轉(zhuǎn)換為協(xié)調(diào)世界時(shí) (UTC)。

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

此模式與完整日期/長(zhǎng)時(shí)間 (F) 模式相同。但是，格式化將作用于等效于正在格式化的 DateTime 對(duì)象的協(xié)調(diào)世界時(shí) (UTC)。

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

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

任何其他單個(gè)字符
（未知說明符）
未知說明符將引發(fā)運(yùn)行時(shí)格式異常。