1. 概述
1.1 版本
| 报表服务器版本 | 插件版本 | EXCEL 版本 |
|---|---|---|
| 11.0 | V1.0.3 | 仅支持 Microsoft Office，不支持 WPS |
1.2 应用场景
当用户通过「单元格元素 > 格式」或 format 公式设定格式后，导出 Excel 时可能出现格式不一致问题。 例如：
日期显示为正文格式
数值显示为货币格式
此插件可解决部分格式的保留问题，减少手动调整的工作量。
1.3 功能描述
1）不支持新计算引擎。
2）不支持在扩展的控件中使用。
3）不支持在悬浮元素、富文本中使用。
4）在函数中引用其他单元格时，只支持引用其父格所在的单元格。
5）当格式设定为##0.0E+0时，实际效果会保留 2 位小数。
6）如需日期导出后满足m/d/yy格式，需要将系统软件地区设定为日期格式为m/d/yy格式的地区。
7）Excel 中数字精度上限 15 位，超过 15 位时，Excel 会自动将后续的数字转换为 0，例如：输入 1234567890123456789 时，Excel 会将最后的 789 变成 000，显示成 1.23456789012345E+18 。
8）此函数设定的格式，预览与导出时仅部分满足要求的格式生效，支持范围见本文第 3 节。
9）填报预览时不支持导出。
2. 插件介绍
2.1 插件安装
点击下载插件：插件下载
设计器插件安装方法参照：设计器插件管理
服务器安装插件方法参照：服务器插件管理
2.2 函数介绍
ExcelFormat（object， format） 函数用于为 object 设置导出到 Excel 中的格式 （format）。
| 参数 | 类型 | 说明 |
|---|---|---|
| object | 字符串/数字 | 需要被格式化的对象 注：当 object 为字符串时，按照给出的标准格式进行计算，只有 format 设定为 “yyyy/MM/dd” 或 “yyyy-MM-dd” 时生效。 当 object 为整数时，按照 Excel 规则进行计算。 例如，45000 代表从 1900 年 1 月开始的第 45000 天，0.5 代表一天中的中点时间。 导出效果受 Excel 国际化的影响。 |
| format | 字符串 | 格式化的样式 注：仅支持第 3 节中列出的格式。 |
2.3 模板导出
使用 ExcelFormat 函数的模板需要导出时，需在工具栏添加「Excel Format」导出按钮，如下图所示：
3. 支持范围
Excel 中支持的格式导出时生效，预览不一定生效。
预览生效的所有格式均在下表中列出，未列出的其他格式不保证生效。
| 类型 | format | 预览生效 | 导出生效 |
|---|---|---|---|
数字 | #0 | ✔ | ✔ |
#0.00 | ✔ | ✔ | |
#0.0# | ✔ | ✔ | |
#,##0 | ✔ | ✔ | |
#,##0.00 | ✔ | ✔ | |
货币 | ¤#0 | ✔ | ✔ |
¤#0.00 | ✔ | ✔ | |
¤#,##0 | ✔ | ✔ | |
¤#,##0.0 | ✔ | ✔ | |
¤#,##0; ¤-#,##0 | ✔ | ✔ | |
¤#,##0.00; ¤-#,##0.00 | ✔ | ✔ | |
¤#,##0.00; (¤#,##0.00) | ✔ | ✔ | |
百分比 | #0% | ✔ | ✔ |
#0.0% | ✔ | ✔ | |
#0.00% | ✔ | ✔ | |
#0.000% | ✔ | ✔ | |
#0.0000% | ✔ | ✔ | |
千分比 | #0‰ | ✔ | ✔ |
#0.0‰ | ✔ | ✔ | |
#0.00‰ | ✔ | ✔ | |
#0.000‰ | ✔ | ✔ | |
#0.0000‰ | ✔ | ✔ | |
科学计数 | 0.00E00 | ✔ | ✔ |
##0.0E0 | ✔ | ✔ | |
日期 | object为字串时 | ||
yyyy-MM-dd | ✔ | ✔ | |
| yyyy/MM/dd | ✔ | ✔ | |
注：当格式中存在下底线时，下底线后必须有一个空格，例如：#,##0.000_
4. 效果预览
选中了部分格式进行演示，如下图所示：
上一篇：流水号函数
