1. 概述
1.1 版本
| 報表伺服器版本 | 插件版本 | EXCEL版本 |
|---|---|---|
| 11.0 | V1.0.2 | 只支援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節。
2. 插件介紹
2.1 插件安裝
點選下載插件：XXXXX
設計器插件安裝方法參照：設計器插件管理
伺服器安裝插件方法參照：伺服器插件管理
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節 中列出的格式。 |
3. 支援范圍
注：生效的所有格式均在下表中列出，未列出的其他格式不保證生效。
| 類型 | format | 預覽生效 | 匯出生效 |
|---|---|---|---|
數字 | #0 | ✔ | ✔ |
#0.00 | ✔ | ✔ | |
#0.0# | ✔ | ✔ | |
#,##0 | ✔ | ✔ | |
#,##0.00 | ✔ | ✔ | |
0 | ✔ | ||
0.00 | ✔ | ||
#,##0.000_ | ✔ | ||
#,##0.00_ | ✔ | ||
#,##0_ ;(#,##0) | ✔ | ||
#,##0_ ;[Red](#,##0) | ✔ | ||
#,##0.00_ ;(#,##0.00) | ✔ | ||
#,##0.00_ ;[Red](#,##0.00) | ✔ | ||
# ?/? | ✔ | ||
# ??/?? | ✔ | ||
貨幣 | ¤#0 | ✔ | ✔ |
¤#0.00 | ✔ | ✔ | |
¤#,##0 | ✔ | ✔ | |
¤#,##0.0 | ✔ | ✔ | |
¤#,##0;¤-#,##0 | ✔ | ✔ | |
¤#,##0.00;¤-#,##0.00 | ✔ | ✔ | |
¤#,##0.00;(¤#,##0.00) | ✔ | ✔ | |
✔ | |||
¤0.00_);(¤0.00) | ✔ | ||
¤#,##0_);(¤#,##0) | ✔ | ||
¤#,##0_);[Red](¤#,##0) | ✔ | ||
¤#,##0.0_);(¤#,##0.0) | ✔ | ||
¤#,##0.00_);(¤#,##0.00) | ✔ | ||
¤#,##0.00_);[Red](¤#,##0.00) | ✔ | ||
百分比 | #0% | ✔ | ✔ |
#0.0% | ✔ | ✔ | |
#0.00% | ✔ | ✔ | |
#0.000% | ✔ | ✔ | |
#0.0000% | ✔ | ✔ | |
0% | ✔ | ||
0.0% | ✔ | ||
0.00% | ✔ | ||
0.000% | ✔ | ||
0.0000% | ✔ | ||
千分比 | #0‰ | ✔ | ✔ |
#0.0‰ | ✔ | ✔ | |
#0.00‰ | ✔ | ✔ | |
#0.000‰ | ✔ | ✔ | |
#0.0000‰ | ✔ | ✔ | |
0‰ | ✔ | ||
0.0‰ | ✔ | ||
0.00‰ | ✔ | ||
0.000‰ | ✔ | ||
0.0000‰ | ✔ | ||
科學計數 | 0.00E00 | ✔ | ✔ |
##0.0E0 | ✔ | ✔ | |
0.00E+00 | ✔ | ||
##0.0E+0 | ✔ | ||
0.00E+00 | ✔ | ||
##0.0E+0 | ✔ | ||
0.00E00 | ✔ | ||
##0.0E0 | ✔ | ||
日期 | object為字串時 | ||
yyyy-MM-dd | ✔ | ✔ | |
yyyy/MM/dd | ✔ | ✔ | |
object為整數時 | |||
m/d/yy | ✔ | ||
d-mmm-yy | ✔ | ||
h:mm AM/PM | ✔ | ||
h:mm:ss AM/PM | ✔ | ||
m/d/yy h:mm | ✔ | ||
4. 效果預覽
選取了部分格式進行展示，如下圖所示：
5. 範本下載
點選下載範本：EXCELFORMAT.cpt
