String.Format 方法的几种定义:
String.Format (String, Object) 将指定的 String 中的格式项替换为指定的 Object 实例的值的文本等效项。
String.Format (String, Object[]) 将指定 String 中的格式项替换为指定数组中相应 Object 实例的值的文本等效项。
String.Format (IFormatProvider, String, Object[]) 将指定 String 中的格式项替换为指定数组中相应 Object 实例的值的文本等效项。指定的参数提供区域性特定的格式设置信息。
String.Format (String, Object, Object) 将指定的 String 中的格式项替换为两个指定的 Object 实例的值的文本等效项。
String.Format (String, Object, Object, Object) 将指定的 String 中的格式项替换为三个指定的 Object 实例的值的文本等效项。
常用的格式化数值结果表
字符 | 说明 | 示例 | 输出 |
C | 货币 | string.Format("{0:C3}", 2) | $2.000 |
D | 十进制 | string.Format("{0:D3}", 2) | 002 |
E | 科学计数法 | 1.20E+001 | 1.20E+001 |
G | 常规 | string.Format("{0:G}", 2) | 2 |
N | 用分号隔开的数字 | string.Format("{0:N}", 250000) | 250,000.00 |
X | 十六进制 | string.Format("{0:X000}", 12) | C |
string.Format("{0:000.000}", 12.2) | 012.200 |
数字:
指示符 | 类型 | 示例 | 输出(输入1.42) | 输出(输入-12400) |
c | 货币 | {0:c} | $1.42 | -$12,400 |
d | 十进制 | {0:d} | System.FormatException | -12400 |
e | 科学计数法 | {0:e} | 1.420000e+000 | -1.240000e+004 |
f | 浮点数 | {0:f} | 1.42 | -12400.00 |
g | 常规 | {0:g} | 1.42 | -12400 |
n | 数字,用逗号表示“千” | {0:n} | 1.42 | -12,400 |
r | 四舍五入 | {0:r} | 1.42 | System.FormatException |
x | 十六进制 | {0:x4} | System.FormatException | cf90 |
自定义数字格式:
指示符 | 类型 | 示例 | 输出(输入1500.42) | 说明 |
0 | 零占位符 | {0:00.0000} | 1500.4200 | Pads with zeroes. |
# | 数字占位符 | {0:(#).##} | (1500).42 | |
. | 小数点 | {0:0.0} | 1500.4 | |
, | 千位占位符 | {0:0,0} | 1,500 | Must be between two zeroes. |
,. | 数字比例 | {0:0,.} | 2 | Comma adjacent to Period scales by 1000. |
% | 百分比 | {0:0%} | 150042% | Multiplies by 100, adds % sign. |
e | 指数占位符 | {0:00e+0} | 15e+2 | Many exponent formats available. |
; | 分组占位符 | see below |
日期:
指示符 | 类型 | 输出 |
d | 短日期 | 10/12/2002 |
D | 长日期 | December 10, 2002 |
t | 短时间 | 10:11 PM |
T | 长时间 | 10:11:29 PM |
f | 完整日期和时间 | December 10, 2002 10:11 PM |
F | 完整日期和时间(长) | December 10, 2002 10:11:29 PM |
g | 默认日期和时间 | 10/12/2002 10:11 PM |
G | 默认日期和时间(长) | 10/12/2002 10:11:29 PM |
M | 月天模式 | December 10 |
r | RFC1123日期字符串 | Tue, 10 Dec 2002 22:11:29 GMT |
s | Sortable日期字符串 | 2002-12-10T22:11:29 |
u | Universal sortable, local time | 2002-12-10 22:13:50Z |
U | Universal sortable, GMT | December 11, 2002 3:13:50 AM |
Y | 年月模式 | December, 2002 |
自定义日期格式:
指示符 | 类型 | 示例 | 输出 |
dd | 日 | {0:dd} | 10 |
ddd | 星期(缩写) | {0:ddd} | Tue |
dddd | 星期(完整) | {0:dddd} | Tuesday |
f, ff, ... | Second fractions | {0:fff} | 932 |
gg, ... | 公元 | {0:gg} | A.D. |
hh | 小时(2位,12小时) | {0:hh} | 10 |
HH | 小时(2位,24小时) | {0:HH} | 22 |
mm | 分钟(00-59) | {0:mm} | 38 |
MM | 月(01-12) | {0:MM} | 12 |
MMM | 月(缩写) | {0:MMM} | Dec |
MMMM | 月(完整) | {0:MMMM} | December |
ss | 秒(00-59) | {0:ss} | 46 |
tt | 上午或下午 | {0:tt} | PM |
yy | 年(2位) | {0:yy} | 02 |
yyyy | 年(4位) | {0:yyyy} | 2002 |
zz | 时区偏移(2位) | {0:zz} | -05 |
zzz | 时区偏移(完整) | {0:zzz} | -05:00 |
: | 分隔符 | {0:hh:mm:ss} | 10:43:20 |
/ | 分隔符 | {0:dd/MM/yyyy} | 10/12/2002 |
常用的几种实例
1、字符串
1.1 字符串数字格式
string str1 =string.Format("{0:N1}",56789); //结果为:56,789.0 string str2 =string.Format("{0:N2}",56789); //结果为:56,789.00 string str3 =string.Format("{0:N3}",56789); //结果为:56,789.000 string str8 =string.Format("{0:F1}",56789); //结果为:56789.0 string str9 =string.Format("{0:F2}",56789); //结果为:56789.00 string str11 =(56789 / 100.0).ToString("#.##"); //结果为:567.89 string str12 =(56789 / 100).ToString("#.##"); //结果为:567 string str = string.Format("{0:f2}", .2); //结果为:0.20
1.2 字符串对齐
String.Format("->{1,10}<-", "Hello"); //结果为:-> Hello<- String.Format("->{1,-10}<-", "Hello"); //结果为:->Hello <-
2、格式化货币(跟系统的环境有关,中文系统默认格式化人民币,英文系统格式化美元)
string.Format("{0:C}",0.2) //结果为:¥0.20 (英文操作系统结果:$0.20), 默认保留两位小数 string.Format("{0:C1}",23.15) //结果为:¥23.2 (截取会自动四舍五入) string.Format("市场价:{0:C},优惠价{1:C}",23.15,19.82) //格式化多个Object实例
3、格式化十进制的数字(格式化成固定的位数,位数不能少于未格式化前,只支持整形)
string.Format("{0:D3}",23) //结果为:023 string.Format("{0:D2}",1223) //结果为:1223,(精度说明符指示结果字符串中所需的最少数字个数。)
4、用分号隔开的数字,并指定小数点后的位数
string.Format("{0:N}", 14200) //结果为:14,200.00 (默认为小数点后面两位) string.Format("{0:N3}", 14200.2458) //结果为:14,200.246 (自动四舍五入)
5、格式化百分比
string.Format("{0:P}", 0.24583) //结果为:24.58% (默认保留百分的两位小数) string.Format("{0:P1}", 0.24583) //结果为:24.6% (自动四舍五入)
6、零占位符和数字占位符
string.Format("{0:0000.00}", 12394.039) //结果为:12394.04 string.Format("{0:0000.00}", 194.039) //结果为:0194.04 string.Format("{0:###.##}", 12394.039) //结果为:12394.04 string.Format("{0:####.#}", 194.039) //结果为:194
下面的这段说明比较难理解,多测试一下实际的应用就可以明白了。
零占位符: 如果格式化的值在格式字符串中出现“0”的位置有一个数字,则此数字被复制到结果字符串中。小数点前最左边的“0”的位置和小数点后最右边的“0”的位置确定总在结果字符串中出现的数字范围。 “00”说明符使得值被舍入到小数点前最近的数字,其中零位总被舍去。
数字占位符: 如果格式化的值在格式字符串中出现“#”的位置有一个数字,则此数字被复制到结果字符串中。否则,结果字符串中的此位置不存储任何值。
请注意,如果“0”不是有效数字,此说明符永不显示“0”字符,即使“0”是字符串中唯一的数字。如果“0”是所显示的数字中的有效数字,则显示“0”字符。 “##”格式字符串使得值被舍入到小数点前最近的数字,其中零总被舍去。
7、日期格式化
string.Format("{0:d}",System.DateTime.Now) //结果为:2009-3-20 (月份位置不是03) string.Format("{0:D}",System.DateTime.Now) //结果为:2009年3月20日 string.Format("{0:f}",System.DateTime.Now) //结果为:2009年3月20日 15:37 string.Format("{0:F}",System.DateTime.Now) //结果为:2009年3月20日 15:37:52 string.Format("{0:g}",System.DateTime.Now) //结果为:2009-3-20 15:38 string.Format("{0:G}",System.DateTime.Now) //结果为:2009-3-20 15:39:27 string.Format("{0:m}",System.DateTime.Now) //结果为:3月20日 string.Format("{0:t}",System.DateTime.Now) //结果为:15:41 string.Format("{0:T}",System.DateTime.Now) //结果为:15:41:50
详见官方文档:https://docs.microsoft.com/zh-cn/dotnet/api/system.string.format?view=net-5.0