# 显示格式

显示格式用于控制不同类型数据（包括数字、日期等）的格式化显示，通过设置合适的显示格式可以使页面的数据更加清晰易懂。产品支持页面级别、应用级别、项目级别和系统全局的设置，详细内容参考文档显示格式。本文将重点解析显示格式的语法规范，包括数字、日期、时间等的语法规范与语法示例。

# 数字

# 语法规范

代码	含义
0	如果数字的位数少于格式中的0会补0，如显示格式设置为00.00，原值是8.9时，显示值为08.90
#	如果数字在小数的两侧位数少于格式中的#符号时，不会补0
?	如果数字的位数少于格式中的?会补空格，以便小数点在列中对齐
,	千位分隔符：逗号（,）。在数字中每隔三位插入一个分隔符，以便快速识别数字的位数和数量级
e或E	科学计数法，如：E-、E+、e-、e+
[DBNum1]	中文小写数字
[DBNum2]	中文大写数字
！	表示其后的是一个字符，和千位分隔符等结合使用可以实现万元的效果
rmb	格式化人民币（大写）,SuccBI特有的，等价于`金山文档：[dbnum1][$RMB]`,`Excel：[>0][dbnum2]G/通用格式元;;;`
正数;负数;0;字符串	由`;`隔开，从左至右依次表示正数、负数、0、字符串的显示格式

# 语法示例

格式代码	含义	原值	显示结果
00.00	如果数字的位数少于格式中的0会补0	8.9	08.90
#.##	如果数字在小数的两侧位数少于格式中的#符号时，不会补0	8.9	8.9
??.??	如果数字的位数少于格式中的?会补空格	8.9	`(空格)8.9(空格)`
#,	单位换算，实际值为12000，显示为12	12000	12
#,###,	单位换算，实际值为1000，显示为1	1000	1
#,##	千位分隔符	1000	1,000
#,###	千位分隔符	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%
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	1.2E+7
[DBNum1]	中文小写数字	1000.12	一千.一二
[DBNum2]	中文大写数字	1000.12	壹仟.壹贰
0.00"元"	数值末尾加单位，如加“元”	1000.12	1000.12元
$@"美元"	数值末尾加单位，如加“美元”	2300	$2300美元
#,###,0.00,"千元"	单位换算为千且保留两位小数，实际值为1000，显示1.00千元	1000	1.00千元
0!.0,"万元"	单位换算为万元，实际值为11000，显示为1.1万元	11000	1.1万元
0!.00,,"亿元"	单位换算为亿元且保留两位小数，实际值为110000000，显示为1.10亿元	110000000	1.10亿元
0.00!"元\"	输出双引号"	1000.12	1000.12"元"
rmb	格式化人民币（大写）,SuccBI特有的,`金山文档：[dbnum1][$RMB]`,`Excel：[>0][dbnum2]G/通用格式元;;;`	1234.56	壹仟贰佰叁拾肆元伍角陆分
0.00;-0.00;#	0显示为空，数值显示值保留两位小数，如实际值为0，显示值为空；实际值为-1.1，显示值为-1.10；实际值为2.2233，实际值为2.22	-1.1	-1.10
0.00;-0.00;0;"0"	0和字符串（包括空）都显示为0，数值显示值保留两位小数，如实际值为空，显示值为0；实际值为0，显示值为0；实际值为`abc`，显示值为0；实际值为2.2233，实际值为2.22	（空）	0

# 日期

# 语法规范

代码	含义
yyyy	将年显示为四位数字
yy	将年显示为两位数字
q	将日期显示为季度
m	将月显示为不带前导零的数字
d	将日显示为不带前导零的数字
dd	根据需要将日显示为带前导零的数字
ddd	将日显示为缩写形式（Sun 到 Sat）
dddd	将日显示为完整名称（Sunday 到 Saturday）

# 语法示例

格式代码	含义	原值	显示结果
yyyy/mm/dd	日期	19700101	1970/01/01
yyyy年q季度	年份与季度	19700101	1970年1季度
ddd	星期缩写	19700101	Thu
dddd	星期	19700101	Thursday

# 时间

# 语法规范

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

# 语法示例

格式代码	含义	原值	显示结果
yyyy/mm/dd hh:mm:ss	日期	now()	2025/08/18 14:47:56
`h:m:s`	获取时分秒，无需补0	09:03:06	9:3:6
hh:mm:ss	获取时分秒，每个部分用两位数字显示，不足两位时在前面补0	09:03:06	09:03:06
hh:mm:ss AM/PM	使用 12 小时制显示小时	13:03:33	01:03:33 PM
hh:mm:ss am/pm	使用 12 小时制显示小时	13:03:33	01:03:33 PM
hh:mm:ss.000	显示时刻，精确到毫秒	now()	14:47:56.845

# 转义

# 语法规范

代码	含义
"字符"	双引号内的字符原样显示，如设置显示格式为"#\n"#,###，原值是1000时，显示值为#\n1,000
\单个字符	\右侧单个字符原样显示，如设置显示格式为`\#\\n#,###`，原值是1000，显示值为#\n1,000

# 语法示例

格式代码	含义	原值	显示结果
"#\n"#,###	使用千分符隔开数字并在开头加#\n	1000	#\n1,000
`\#\\n#,###`	使用千分符隔开数字并在开头加#\n	1000	#\n1,000
`\"@\"`	单元格内容的开头和结尾分别加上`"`	HelloWorld!	"HelloWorld!"

# 维项

# 语法规范

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

# 语法示例

格式代码	含义	原值	显示结果
@(@txt)	原值(维文本)，如展示行政区划代码字段，该字段关联行政区划维表，维表主键设置文字字段为行政区划名称，则显示内容为行政区划代码(行政区划名称)	420000	420000(湖北省)