Excelize 開源基礎庫 2.8.0 版本正式發(fā)布
Excelize 是 Go 語言編寫的用于操作電子表格辦公文檔的開源基礎庫，基于 ISO/IEC 29500、ECMA-376?國際標準?？梢允褂盟鼇碜x取、寫入由 Microsoft Excel、WPS、Apache OpenOffice、LibreOffice 等辦公軟件創(chuàng)建的電子表格文檔。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多種文檔格式，高度兼容帶有樣式、圖片(表)、透視表、切片器等復雜組件的文檔，并提供流式讀寫支持，用于處理包含大規(guī)模數(shù)據的工作簿?？蓱糜诟黝悎蟊砥脚_、云計算、邊緣計算等系統(tǒng)。自 2016 年開源以來已成為云原生應用尤其是 Go 語言開發(fā)者在處理電子表格辦公文檔時的熱門選擇，正在被廣泛應用于大型互聯(lián)網公司、中小企業(yè)客戶和初創(chuàng)公司。榮獲 2022 年中國開源創(chuàng)新大賽一等獎、入選 2020 Gopher China - Go 領域明星開源項目 (GSP)、2018 年開源中國碼云最有價值開源項目 GVP (Gitee Most Valuable Project)。
開源代碼
github.com/xuri/excelize
中文文檔
xuri.me/excelize/zh-hans
更新摘要
2023年8月28日，社區(qū)正式發(fā)布了 2.8.0 版本，該版本包含了多項新增功能、錯誤修復和兼容性提升優(yōu)化。此版本中最顯著的變化包括：
兼容性提示
將導出變量 ErrTableNameLength 重命名為 ErrNameLength
將導出類型 PaneOptions 重命名為 Selection
將導出類型 Comment 中的 Runs 字段重命名為 Paragraph
移除了 Style 數(shù)據類型中的 Lang 字段
移除了 ChartTitle 數(shù)據類型，使用 RichTextRun 類型代替
更改 DecimalPlaces 字段的數(shù)據類型為指針類型
修改了默認點與像素單位轉換系數(shù)，相關 issue #279 和 #1536
修改了 AddShape 函數(shù)的簽名：將 func (f *File) AddShape(sheet, cell string, opts *Shape) error 改為 func (f *File) AddShape(sheet string, opts *Shape) error
新增功能
新增導出錯誤變量 ErrExistsTableName 和 ErrorFormControlValue
Options 數(shù)據類型中新增 ShortDatePattern, LongDatePattern, LongTimePattern 和 CultureInfo 選項，支持設置長短日期與時間格式代碼，相關 issue #1199
新增用于表示區(qū)域代碼的 CultureName 類型枚舉
新增函數(shù) GetTables 與 DeleteTable 支持獲取與刪除表格，相關 issue #674 和 #1454
新增函數(shù) GetStyle 支持獲取樣式定義，相關 issue #314, #1520 和 #1521
支持為單元格的值應用帶有占位、對齊、舍入、貨幣、會計專用和轉換選項的數(shù)字格式，并支持帶有 812 種語言（位置）時間和日期類型的數(shù)字格式，相關 issue #660
新增 10 項公式函數(shù): ARRAYTOTEXT, FORECAST, FORECAST.LINEAR, FREQUENCY, INTERCEPT, ODDFYIELD, ODDLPRICE, ODDLYIELD, PROB 和 VALUETOTEXT
增加對工作簿保存路徑的檢查，若路徑長度超出限制將返回錯誤提示
新增 GetPanes 函數(shù)，支持獲取窗格和視圖選區(qū)設置
新增 3 項表單控件函數(shù) AddFormControl、GetFormControls 和 DeleteFormControl, 支持添加主要水平和垂直坐標軸標題，相關 issues #301 和 #1169
添加圖表函數(shù) AddChart 支持添加主要水平和垂直坐標軸標題，相關 issue #1553
添加圖表函數(shù) AddChart 支持添加次坐標軸，相關 issue #518
添加圖表函數(shù) AddChart 支持設置圖表富文本標題與圖表標題格式，相關 issue #1588
通過 AddShape 函數(shù)添加形狀時，如果給定的形狀類型不受支持，將返回異常錯誤
支持讀取帶有日本年號數(shù)字格式的單元格，相關 issue #1590
函數(shù) GetPictures 支持讀取帶有單一單元格錨點位置的圖片，相關 issue #1585
函數(shù) NewConditionalStyle 支持創(chuàng)建帶有數(shù)字格式與保護屬性的條件格式樣式，相關 issue #1610
兼容性提升
添加對帶多字節(jié)文本的單元格字符長度檢查，相關 issue #1517
當創(chuàng)建帶有重復名稱的表格或自定義名稱時，將返回錯誤異常
提高單元格批注文本框大小顯示效果在 KingSoft WPS 下的兼容性
支持從自定義工作表屬性設置中讀取列寬度，相關 issue #1536
修改內部工作表 XML 部件名稱為大小寫不敏感以提高兼容性，相關 issue #1591
問題修復
修復因計算帶有轉義 XML 單元格的長度有誤導致的，部分情況流式生成工作簿損壞問題，解決 issue #1518, #1519 和 #1530
修復帶有多行文本的單元格批注文本框大小異常問題
修復了部分情況下，讀取帶有數(shù)字格式的文本單元格時，讀取結果有誤的問題，解決 issue #1523, #1528 和 #1533
修復了并發(fā)安全函數(shù)中存在的競態(tài)問題
修復了部分情況下，對與單元格時間毫秒舍入精度結果有誤的問題
修復了部分情況下，讀取帶有 12 小時制數(shù)字格式的單元格時，時間結果有誤的問題
修復了部分情況下，計算帶有 SUMIFS 和 AVERAGEIFS 函數(shù)的公式結果有誤的問題，解決 issue #1564
修復了公式計算引擎中基本算數(shù)運算符優(yōu)先級問題導致的計算結果有誤問題，解決 issue #1599
修復部分情況下，帶有跨工作表單元格引用公式計算結果有誤的問題
修復部分情況下，刪除行后，工作表中的表格調整結果異常的問題，解決 issue #1539
支持讀取單元格中的多張圖片，解決 issue #1548
修復部分情況下，因讀取圖形對象位置有誤導致的添加圖片結果異常問題，解決 issue #1560
刪除行列時支持調整公式，修復部分情況下導致的文檔損壞問題，解決 issue #1565
修復了部分情況下，計算帶有 CONCAT 和 CONCATENATE 函數(shù)的公式結果有誤的問題，解決 issue #1569
修復部分情況下，帶有嵌套數(shù)字類型參數(shù)公式的計算結果有誤問題，解決 issue #1582
修復因內部圖形對象計數(shù)器有誤導致的部分情況下添加圖片出現(xiàn)重復的問題，解決 issue #1584
修復因部分情況下讀取帶有時間類型數(shù)字格式的單元格時，小時有誤的問題，解決 issue #1587
修復了部分情況下，獲取合并單元格區(qū)域右下角單元格坐標時出現(xiàn)的 panic
性能優(yōu)化
優(yōu)化內部正字表達式的執(zhí)行速度，相關 issue #1532
避免內部字節(jié)數(shù)組與字符串數(shù)據類型變量之間的轉換，相關 issue #1541
其他
Go Modules 依賴模塊更新
簡化了內部變量的聲明與錯誤返回語句
移除了內部帶有 Unicode 編碼的預設語言數(shù)字格式映射表
移除了內部?
xlsxTabColor?數(shù)據類型，使用?xlsxColor?代替?xlsxTabColor?數(shù)據類型單元測試與文檔更新，單元測試行覆蓋度提升 0.24%，達到 98.91%
包含簡體中文、英語、法語、俄語、日語、韓語、阿拉伯語、德語和西班牙語的多國語言文檔網站更新
致謝
感謝 Excelize 的所有貢獻者，以下是為此版本提交代碼的貢獻者列表：
IAkumaI (Valery Ozarnichuk)
sillydong (Chen Zhidong)
fudali113 (fudali)
Juneezee (Eng Zer Jun)
joehan109
yicixin (壹次心)
vb6iscool
chengcxy (chengxinyao)
lidp20
JDavidVR (David)
fsfsx
cnmlgbgithub
