OStack程序员社区-中国程序员成长平台 › 门户 › 编程› C++›C++教程

C#String.Format格式化

原作者: [db:作者] 来自: [db:来源] 收藏邀请

下表描述了标准 DateTime 格式说明符。有关各格式说明符所产生输出的示例，请参见标准 DateTime 格式字符串输出示例。

格式说明符	名称	说明
d	短日期模式	表示由当前 DateTime 格式字符串。例如，用于固定区域性的自定义格式字符串为“MM/dd/yyyy”。
D	长日期模式	表示由当前 DateTime 格式字符串。例如，用于固定区域性的自定义格式字符串为“dddd, dd MMMM yyyy”。
f	完整日期/时间模式（短时间）	表示长日期 (D) 和短时间 (t) 模式的组合，由空格分隔。
F	完整日期/时间模式（长时间）	表示由当前 DateTime 格式字符串。例如，用于固定区域性的自定义格式字符串为“dddd, dd MMMM yyyy HH:mm:ss”。
g	常规日期/时间模式（短时间）	表示短日期 (d) 和短时间 (t) 模式的组合，由空格分隔。
G	常规日期/时间模式（长时间）	表示短日期 (d) 和长时间 (T) 模式的组合，由空格分隔。
M 或 m	月日模式	表示由当前 DateTime 格式字符串。例如，用于固定区域性的自定义格式字符串为“MMMM dd”。
o	往返日期/时间模式	表示使用保留时区信息的模式的自定义 DateTime 格式字符串。该模式专用于往返 DateTime 格式（包括文本形式的 Kind 属性）。随后将 Kind属性值一起使用可以对格式化的字符串进行反向分析。自定义格式字符串为“yyyy'-'MM'-'dd'T'HH':'mm':'ss.fffffffK”。用于此说明符的模式是定义的标准。因此，无论所使用的区域性或所提供的格式提供程序是什么，它总是相同的。
R 或 r	RFC1123 模式	表示由当前 DateTime 格式字符串。该模式是定义的标准，并且属性是只读的。因此，无论所使用的区域性或所提供的格式提供程序是什么，它总是相同的。定义格式字符串为“ddd, dd MMM yyyy HH':'mm':'ss 'GMT'”。格式化不会修改正在格式化的 DateTime 对象的值。因此，应用程序在使用此格式说明符之前必须将该值转换为协调世界时 (UTC)。
s	可排序的日期/时间模式；符合 ISO 8601	表示由当前 DateTime 格式字符串。此模式是定义的标准，并且属性是只读的。因此，无论所使用的区域性或所提供的格式提供程序是什么，它总是相同的。自定义格式字符串为“yyyy'-'MM'-'dd'T'HH':'mm':'ss”。
t	短时间模式	表示由当前 DateTime 格式字符串。例如，用于固定区域性的自定义格式字符串为“HH:mm”。
T	长时间模式	表示由当前 DateTime 格式字符串。例如，用于固定区域性的自定义格式字符串为“HH:mm:ss”。
u	通用的可排序日期/时间模式	表示由当前 DateTime 格式字符串。此模式是定义的标准，并且属性是只读的。因此，无论所使用的区域性或所提供的格式提供程序是什么，它总是相同的。自定义格式字符串为“yyyy'-'MM'-'dd HH':'mm':'ss'Z'”。格式化日期和时间时不进行时区转换。因此，应用程序在使用此格式说明符之前必须将本地日期和时间转换为协调世界时 (UTC)。
U	通用的可排序日期/时间模式	表示由当前 FullDateTimePattern 属性定义的自定义 DateTime 格式字符串。此模式与完整日期/长时间 (F) 模式相同。但是，格式化将作用于等效于正在格式化的 DateTime 对象的协调世界时 (UTC)。
Y 或 y	年月模式	表示由当前 DateTime 格式字符串。例如，用于固定区域性的自定义格式字符串为“yyyy MMMM”。
任何其他单个字符	（未知说明符）	未知说明符将引发运行时格式异常。

控制面板设置

DateTimeFormatInfo 对象，当前线程区域性将提供用于控制格式设置的值。使用不同设置的计算机会生成不同的结果字符串。

DateTimeFormatInfo 属性

格式化受当前 DateTimeFormatInfo 对象的属性影响，其由当前线程区域性隐式提供或由调用格式化的方法的 DateTimeFormatInfo 对象。

许多标准 DateTime 格式说明符是由当前 DateTimeFormatInfo 对象的属性定义的格式化模式的别名。因此，应用程序通过更改相应的 DateTimeFormatInfo 属性可以改变由某些标准 DateTime 格式说明符产生的结果。

标准数字格式字符串

标准数字格式字符串用于格式化通用数值类型。标准数字格式字符串采用 Axx 的形式，其中 A 是称为格式说明符的字母型字符，xx 是称为精度说明符的可选整数。精度说明符的范围从 0 到 99，并且影响结果中的位数。任何包含一个以上字母字符（包括空白）的数字格式字符串都被解释为自定义数字格式字符串。

下表描述了标准数字格式说明符。有关各格式说明符所产生输出的示例，请参见备注。

格式说明符	名称	说明
C 或 c	货币	数字转换为表示货币金额的字符串。转换由当前 NumberFormatInfo 对象的货币格式信息控制。精度说明符指示所需的小数位数。如果省略精度说明符，则使用当前 NumberFormatInfo 对象给定的默认货币精度。
D 或 d	十进制数	只有整型才支持此格式。数字转换为十进制数字 (0-9) 的字符串，如果数字为负，则前面加负号。精度说明符指示结果字符串中所需的最少数字个数。如果需要的话，则用零填充该数字的左侧，以产生精度说明符给定的数字个数。
E 或 e	科学记数法（指数）	数字转换为“-d.ddd…E+ddd”或“-d.ddd…e+ddd”形式的字符串，其中每个“d”表示一个数字 (0-9)。如果该数字为负，则该字符串以减号开头。小数点前总有一个数字。精度说明符指示小数点后所需的位数。如果省略精度说明符，则使用默认值，即小数点后六位数字。格式说明符的大小写指示在指数前加前缀“E”还是“e”。指数总是由正号或负号以及最少三位数字组成。如果需要，用零填充指数以满足最少三位数字的要求。
F 或 f	定点	数字转换为“-ddd.ddd…”形式的字符串，其中每个“d”表示一个数字 (0-9)。如果该数字为负，则该字符串以减号开头。精度说明符指示所需的小数位数。如果忽略精度说明符，则使用当前 NumberFormatInfo 对象给定的默认数值精度。
G 或 g	常规	根据数字类型以及是否存在精度说明符，数字会转换为定点或科学记数法的最紧凑形式。如果精度说明符被省略或为零，则数字的类型决定默认精度，如下表所示。 Byte 或 SByte：3 Int16 或 UInt16：5 Int32 或 UInt32：10 Int64 或 UInt64：19 Single：7 Double：15 Decimal：29 如果用科学记数法表示数字时指数大于 -5 而且小于精度说明符，则使用定点表示法；否则使用科学记数法。如果要求有小数点，并且忽略尾部零，则结果包含小数点。如果精度说明符存在，并且结果的有效数字位数超过指定精度，则通过舍入删除多余的尾部数字。上述规则有一个例外：如果数字是 Decimal 而且省略精度说明符时。在这种情况下总使用定点表示法并保留尾部零。使用科学记数法时，如果格式说明符是“G”，结果的指数带前缀“E”；如果格式说明符是“g”，结果的指数带前缀“e”。
N 或 n	数字	数字转换为“-d,ddd,ddd.ddd…”形式的字符串，其中“-”表示负数符号（如果需要），“d”表示数字 (0-9)，“,”表示数字组之间的千位分隔符，“.”表示小数点符号。实际的负数模式、数字组大小、千位分隔符以及十进制分隔符由当前 NumberFormatInfo 对象指定。精度说明符指示所需的小数位数。如果忽略精度说明符，则使用当前 NumberFormatInfo 对象给定的默认数值精度。
P 或 p	百分比	数字转换为由 NumberFormatInfo.PercentPositivePattern 属性定义的、表示百分比的字符串，前者用于数字为负的情况，后者用于数字为正的情况。已转换的数字乘以 100 以表示为百分比。精度说明符指示所需的小数位数。如果忽略精度说明符，则使用当前 NumberFormatInfo 对象给定的默认数值精度。
R 或 r	往返过程	只有 Single 使用 9 位精度。虽然此处可以存在精度说明符，但它将被忽略。使用此说明符时，往返过程优先于精度。
X 或 x	十六进制数	只有整型才支持此格式。数字转换为十六进制数字的字符串。格式说明符的大小写指示对大于 9 的十六进制数字使用大写字符还是小写字符。例如，使用“X”产生“ABCDEF”，使用“x”产生“abcdef”。精度说明符指示结果字符串中所需的最少数字个数。如果需要的话，则用零填充该数字的左侧，以产生精度说明符给定的数字个数。
任何其他单个字符	（未知说明符）	（未知说明符将引发运行库格式异常。）

备注