格式說明符

---

立即下載DevExpress WPF

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

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

標準格式字符串數(shù)值

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

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

 Date-Time的標準格式字符串

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

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

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

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

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

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

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

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

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

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

下一個表列出了用于格式化時間值的字符串。

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