格式說(shuō)明符

---

立即下載DevExpress WPF

本主題描述可用于格式化數(shù)字和 Date-Time的最常用標(biāo)準(zhǔn)和自定義格式說(shuō)明符。

若要將自定義文本添加到輸出字符串，請(qǐng)使用如下所述的自定義格式說(shuō)明符(在格式化數(shù)字或 Date-Time時(shí))或復(fù)合格式特性(在格式化任何值時(shí))。

標(biāo)準(zhǔn)格式字符串?dāng)?shù)值

數(shù)值的標(biāo)準(zhǔn)格式字符串用Axx格式指定，這里A是一個(gè)稱為格式說(shuō)明符的字符，Xx是一個(gè)稱為精度說(shuō)明符的數(shù)字序列。格式說(shuō)明符表示值是否應(yīng)該轉(zhuǎn)換為貨幣格式、科學(xué)符號(hào)等，此說(shuō)明符必須設(shè)置為標(biāo)準(zhǔn)數(shù)字格式字符串主題中列出的預(yù)定義字符之一。下表給出了一些常用值。

格式說(shuō)明符	描述	格式字符串示例	樣本輸出
c or C	該數(shù)字被轉(zhuǎn)換為表示貨幣金額的字符串，精度說(shuō)明符指示所需的小數(shù)位數(shù)，如果省略精度說(shuō)明符，則使用當(dāng)前區(qū)域選項(xiàng)中的默認(rèn)貨幣精度。	c2	$1,234.00
e or E	該數(shù)字被轉(zhuǎn)換為“-ddddE+ddd”或“-ddddE+ddd”形式的字符串，其中每個(gè)“d”表示一個(gè)數(shù)字(0-9)。如果數(shù)字是負(fù)數(shù)，則字符串用負(fù)號(hào)開頭，小數(shù)點(diǎn)前總是有一位數(shù)字，精度說(shuō)明符指示小數(shù)點(diǎn)后所需的位數(shù)，如果省略精度說(shuō)明符，則默認(rèn)使用小數(shù)點(diǎn)后的六位數(shù)字。格式說(shuō)明符的大小寫指示是用' E '還是' E '作為指數(shù)的前綴，指數(shù)總是由一個(gè)正負(fù)號(hào)和至少三位數(shù)字組成。如果需要，指數(shù)用零填充來(lái)滿足這個(gè)最小值。	E1	1.2E+003
n or N	該數(shù)字被轉(zhuǎn)換為“-d,ddd,ddd.ddd…”形式的字符串，其中每個(gè)“d”表示一個(gè)數(shù)字(0-9)。如果數(shù)字是負(fù)數(shù)，則字符串負(fù)號(hào)開頭，在小數(shù)點(diǎn)左邊的每組三位數(shù)字之間插入千位分隔符，精度說(shuō)明符指示所需的小數(shù)位數(shù)。如果省略精度說(shuō)明符，則使用當(dāng)前區(qū)域選項(xiàng)中的默認(rèn)貨幣精度。	n0	1,234
x or X	將該數(shù)字轉(zhuǎn)換為十六進(jìn)制數(shù)字字符串，格式說(shuō)明符的大小寫指示大于9的十六進(jìn)制數(shù)字是使用大寫字符還是小寫字符，精度說(shuō)明符指示結(jié)果字符串中的最小位數(shù)。如果需要，該數(shù)字在其左側(cè)填充零，來(lái)產(chǎn)生精度說(shuō)明符給出的位數(shù)，此格式僅支持整型類型。	X8	000004D2
p or P	該數(shù)字乘以100，然后轉(zhuǎn)換為字符串，結(jié)果用作編輯器的值。例如，如果編輯器的值為0.15，則顯示“15%”字符串，精度說(shuō)明符指示所需的小數(shù)位數(shù)。如果省略精度說(shuō)明符，則使用在NumberFormat對(duì)象中聲明的默認(rèn)數(shù)字精度。	P1	123,400.0%

 Date-Time的標(biāo)準(zhǔn)格式字符串

標(biāo)準(zhǔn)日期和時(shí)間格式字符串包含單個(gè)字符，該字符定義用于表示值的模式(是否以及如何顯示年份、月份等)。下表列出了最常用的格式字符。

格式說(shuō)明符	描述	樣本輸出
d	短日期模式	3/12/2003
D	長(zhǎng)日期模式	Wednesday, March 12, 2003
t	短時(shí)間模式	12:00 AM
T	長(zhǎng)時(shí)間模式	12:00:00 AM
f	完整日期/時(shí)間模式(短時(shí)間)	Wednesday, March 12, 2003 12:00 AM
F	完整的日期/時(shí)間模式(全職)	Wednesday, March 12, 2003 12:00:00 AM
g	一般日期/時(shí)間模式(短時(shí)間)	3/12/2003 12:00 AM
G	一般日期/時(shí)間模式(全職)	3/12/2003 12:00:00 AM

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

自定義格式字符串用于手動(dòng)構(gòu)造格式模式，只有當(dāng)標(biāo)準(zhǔn)格式字符串不滿足您的要求時(shí)，才需要使用它們。所有文字字符后跟一個(gè)或兩個(gè)數(shù)字表示的格式字符串都被視為標(biāo)準(zhǔn)格式字符串，因此所有其他字符串都被解釋為自定義格式字符串。下表列出了可以構(gòu)造自定義格式字符串的最常用字符。

字符	意義
0	數(shù)字始終顯示。
#	該數(shù)字僅在需要時(shí)顯示(即用于抑制前導(dǎo)零)。
.	指定小數(shù)點(diǎn)的位置。點(diǎn)的外觀取決于區(qū)域設(shè)置。
,	指定逗號(hào)的位置。逗號(hào)的出現(xiàn)取決于區(qū)域設(shè)置。

自定義格式字符串也可以包含其他字符，它們將被復(fù)制到格式化字符串中，這可用于向值添加解釋性文本。如果需要顯示其中一個(gè)保留字符，則必須在其前面加上“”符號(hào)。

在格式化數(shù)值時(shí)，可以對(duì)正、負(fù)和零值應(yīng)用不同的格式，為此，格式字符串必須包含用分號(hào)分隔的三個(gè)部分。第一部分設(shè)置正值格式，第二部分應(yīng)用于負(fù)值，第三部分表示零值。

自定義Date-Time的格式字符串

要為 Date-Time創(chuàng)建格式模式，需要組合下表中列出的字符串。這些字符串用不同的格式表示年、月、日、數(shù)字等。

下表列出了可用于格式化日期的最常用字符串。(示例假設(shè)格式化日期為9/2/2003)。

下一個(gè)表列出了用于格式化時(shí)間值的字符串。

提示：上面的表格只列出了最常用的格式字符串部分。