# 显示格式

显示格式用于控制不同类型数据（包括数字、日期等）的格式化显示，通过设置合适的显示格式可以使页面的数据更加清晰易懂。产品提供了贴近Excel的显示格式语法。

# 语法规范

# 数字

代码	含义	格式代码	原值	显示结果
0	如果数字的位数少于格式中的0会补0。但此数字占位符显示的0是没有意义的	00.00	8.9	08.90
#	此数字占位符遵循与 0（零）相同的规则。但是，当键入的数字在小数的两侧位数少于格式中的 # 符号时，不会显示额外的0	#.##	8.9	8.9
?	此数字占位符遵循与 0（零）相同的规则。但不是补0而是补空格，以便小数点在列中对齐	??.??	`8.90`	`(空格)8.90`，8前面会多出一个空格
,	千位分隔符：逗号（,）。逗号位于显示格式最右侧时，数字按1000缩小。如果最右侧有两个，则缩小1000*1000	#,###	12000	12,000
e或E	科学计数法，如：E-、E+、e-、e+	0.00E+00	12,200,000	1.22E+07
[DBNum1]	小写数字	[DBNum1]	0123456789	〇、一、二、三、四、五、六、七、八、九
[DBNum2]	大写数字	[DBNum2]	0123456789	零、壹、貮、參、肆、伍、陸、柒、捌、玖
！	表示其后的是一个字符，和千位符等结合使用可以实现万元的效果	0!.0,	11000	1.1
rmb	格式化人民币（大写）,SuccBI特有的，等价于`金山文档：[dbnum1][$RMB]`,`Excel：[>0][dbnum2]G/通用格式元;;;`	rmb	1234.56	一千二百三十四元五角六分

# 日期

代码	含义	显示结果
yyyy	将年显示为四位数字	1900 – 9999
yy	将年显示为两位数字	00-99
m	将月显示为不带前导零的数字	1 - 12
mm	根据需要将月显示为带前导零的数字	01 – 12
mmm	将月显示为缩写形式（Jan 到 Dec）	Jan - Dec
mmmm	将月显示为全称（从一月到十二月）	January - December
mmmmm	将月显示为单个字母（从 J 到 D）	J - D
d	将日显示为不带前导零的数字	1 – 31
dd	根据需要将日显示为带前导零的数字	01 – 31
ddd	将日显示为缩写形式（Sun 到 Sat）	Sun - Sat
dddd	将日显示为完整名称（Sunday 到 Saturday）	Sunday - Saturday

# 时间

代码	含义	显示结果
h	将小时显示为不带前导零的数字	0 – 23
hh	根据需要将日显示为带前导零的数字。如果格式包含 AM 或 PM，则时间采用 12 小时制。否则，时间将采用24小时制	00 – 23
m	将分钟显示为不带前导零的数字。注意: m 或mm 代码必须紧跟在 h 或 hh 代码之后，或后面紧接 ss 代码；否则，Excel 将显示月份而不是分钟数。	0 – 59
mm	根据需要将分钟显示为带前导零的数字	00 – 59
s	将秒显示为不带前导零的数字	0 – 59
ss	根据需要将分钟显示为带前导零的数字	00 – 59
AM/PM	使用 12 小时制显示小时	AM、PM
am/pm	使用 12 小时制显示小时	am、pm
A/P、a/p	使用 12 小时制显示小时	A、P，a、p
000	秒的小数位，Excel只能精确到毫秒，有的数据库可以到微秒	000-999

# 其他

格式代码	含义
@	当前值
@txt	维文本
@ @txt	原值维文本

# 语法示例

# 常用

格式代码	含义	原值	显示结果
#,###,	单位换算，实际值为1000，显示为1	1000	1
#,##	千位分隔符	1000	1,000
#,	单位换算，实际值为12000，显示为12	12000	12
#,###	千位分隔符	12000	12,000
0.000	三位小数	1000.12	1000.120
#,##0.000	千位分隔符且保留3位小数	1000.12	1,000.120
####.#	四舍五入保留一位小数	1234.59	1234.6
#.000	显示三位小数	8.9	8.900
0.#	四舍五入保留一位小数	.631	0.6
0.0,,	单位换算，实际值为12200000，显示为12.2	12200000	12.2
0.000%	百分比保留3位小数	10.12%	10.120%
0%	百分比不保留小数位	10.12%	10%
[DBNum1]	中文小写数字	1000.12	一千.一二
[DBNum2]	中文大写数字	1000.12	壹仟.壹贰
YYYY/MM/DD HH:mm:SS	日期	1970-01-01	1970/01/01 08:00:01
yyyy年q季度	季度	1970-01-01	1970年1季度
0.00"元"	数值末尾加单位，如加“元”	1000.12	1000.12元
$@"美元"	数值末尾加单位，如加“美元”	2300	$2300美元
#,###,0.00,"千元"	单位换算为千且保留两位小数，实际值为1000，显示1.00千元	1000	1.00千元
1!.0,"万元"	单位换算为万元，实际值为11000，显示为1.1万元	11000	1.1万元
0.00!"元\"	输出双引号"	1000.12	1000.12"元"
$@	引用当前值，如果需要添加显示其他普通文本，则用""括起来	2300	$2300
rmb	格式化人民币（大写）,SuccBI特有的,`金山文档：[dbnum1][$RMB]`,`Excel：[>0][dbnum2]G/通用格式元;;;`	1234.56	一千二百三十四元五角六分
00.00	如果数字的位数少于格式中的0会补0。但此数字占位符显示的0是没有意义的	8.9	08.90
#.##	此数字占位符遵循与 0（零）相同的规则。但是，当键入的数字在小数的两侧位数少于格式中的 # 符号时，不会显示额外的0	8.9	8.9
???.???	此数字占位符遵循与 0（零）相同的规则。但不是补0而是补空格，以便小数点在列中对齐	8.9	8.9
0.00E+00	科学计数法，如：E-、E+、e-、e+	12,200,000	1.22E+07
0.00E-00	科学计数法，如：E-、E+、e-、e+	12,200,000	1.22E07
#0.0E+0	科学计数法，如：E-、E+、e-、e+	12,200,000	12.2E+6

# 分数

格式代码	含义	原值	显示结果
# ?/?	分母为一位数	0.23	2/9
# ??/??	分母为两位数	0.23	3/13
# ???/???	分母为三位数	0.23	23/100
# ?/2	以2为分母	0.23	0
# ?/4	以4为分母	0.23	1/4
# ?/8	以8为分母	0.23	2/8