格式說明符

---

立即下載DevExpress WPF

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

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

標準格式字符串數值

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

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

自定義格式字符串的數值

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

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

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

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

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

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

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

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

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