格式说明符
本主题描述可用于格式化数字和 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)。
下一个表列出了用于格式化时间值的字符串。
提示:上面的表格只列出了最常用的格式字符串部分。