显示格式

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

数字

语法规范

代码	含义
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(湖北省)

使用场景

产品里针对不同的数据类型内置了一些常见的显示格式供直接选择使用，也可以根据需求添加自定义显示格式。同时，显示格式语法也用于TOSTR函数控制数据输出格式。以下是仪表板中添加和管理自定义显示格式的过程示例，在报表、Superpage中也是类似过程。

添加自定义格式

点击添加自定义格式弹出新增显示格式对话框：

1. 格式编号：自定义该显示格式的格式编号
2. 格式名称：自定义该显示格式的格式名称
3. 格式：输入该显示格式的格式表达式
4. 预览：添加格式后可以预览格式效果

如图为添加显示格式1位小数：

管理自定义格式

点击管理自定义格式弹出管理显示格式对话框：

管理自定义格式中有三个属性：

1. 新增：新增显示格式
2. 修改：修改已有的显示格式
3. 删除：删除已存在的显示格式