我们很高兴地宣布发布 2.8.1 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 Release Notes。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
golang.org/x/net
HeaderFooterOptions
中的字段 AlignWithMargins
和 ScaleWithDoc
修改为指针类型ShapeColor
SetCellUint
支持设置无符号整型数GetPictureCells
支持获取图片单元格坐标GetConditionalStyle
支持获取条件格式样式定义GetHeaderFooter
支持获取工作表页眉页脚控制字符设置AddSlicer
支持为表格和数据透视表添加切片器GetPivotTables
支持获取数据透视表DeletePivotTable
支持删除数据透视表PivotTableOptions
中添加了新的字段 Name
以支持创建数据透视表时指定自定义数据透视表名称ChartLineType
枚举类型,以支持设置图表区域边框线型Chart
中添加了新的字段 Border
以支持设置图表区域边框类型ChartLine
中添加了新的字段 Type
以支持设置图表线型NameSpaceSpreadSheetXR10
、ContentTypeSlicer
、ContentTypeSlicerCache
和 SourceRelationshipSlicer
ExtURIPivotCacheDefinition
SetRowHeight
支持通过指定行高度为 -1
移除自定义行高度设置SetRowHeight
将返回错误提示信息AddChart
支持设置图表中的数据标签位置AddChart
支持设置图表区域、绘图区域和数据标记的填充色和透明填充,在 Chart
、ChartPlotArea
和 ChartMarker
数据类型中添加了 Fill
选项AddChart
支持设置图表坐标轴文字字体、字号和删除线格式ChartSeries
中新增了 DataLabelPosition
字段,用于指定图表中各数据系列数据标签的位置Chart
中新增了 BubbleSize
字段,用于设置气泡图和三维气泡图的气泡大小ChartDataLabelPositionType
GetPictureCells
和获取图片函数 GetPictures
支持读取由 Kingsoft WPS™ Office 创建的嵌入单元格图片SetConditionalFormat
支持批量为多个单元格区域设置条件格式GetBaseColor
函数,支持读取首选十六进制颜色代码OpenReader
函数打开文档时所指定的 Options
选项设置tabRatio
属性值工作簿部件的兼容性AutoFilter
函数添加自动过滤器时出现的 panicr
属性的行元素导致的 panic 问题GetCellRichText
在获取内联富文本时返回错误的问题GetConditionalFormats
读取带有“高于平均值”条件格式规则时 panic 的问题SetConditionalFormat
函数在创建带有多规则条件格式时,规则优先级有误的问题GetConditionalFormats
函数无法读取带有渐变填充格式数据条的问题GetStyle
或获取条件格式样式函数 GetConditionalStyle
所返回的小数位数 DecimalPlaces
字段值有误问题CalcCellValue
函数时,开启 RawCellValue
选项失效的问题感谢 Excelize 的所有贡献者,以下是为此版本提交代码的贡献者列表:
fnickels (Francis Nickels III)
m12r (Matthias Endler)
Abdelaziz-Ouhammou
Juneezee (Eng Zer Jun)
yicixin (壹次心)
TeeRenJing (rjtee)
phperic (magicrabbit)
kjushka (Anton Petrov)
krstak (Marko Krstic)
lpxxn (Nick)
ByteFlyCoding
yangliyl (Yang Li)
15535382838
TajangSec (Tajang)
lujin1 (lujin)
parkoo (Tian)
ZhangXiao1024 (ZX)
zcgly
bramvbilsen (Bram Vanbilsen)
user65536
tianaiyouqing (天爱有情)
cuishuang (cui fliter)
CooolNv (Xuesong)
yuegu520
oneweek20169902 (li)
3zmx
327674413
melf-xyzh (MELF晓宇)
L4nn15ter
rememberher (Jerry)
ooooooobh (cherry)
xxxwang1983
funa12
coolbit
taitaking (zhukewen)
kewenof
ivekkairi (Vivek Kairi)
edwardfward (Ed)
技术交流群
DingTalk Group ID: 30047129
QQ ID: 1302058237
我们很高兴地宣布发布 2.8.0 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 Release Notes。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
ErrTableNameLength
重命名为 ErrNameLength
PaneOptions
重命名为 Selection
Comment
中的 Runs
字段重命名为 Paragraph
Style
数据类型中的 Lang
字段ChartTitle
数据类型,使用 RichTextRun
类型代替DecimalPlaces
字段的数据类型为指针类型AddShape
函数的签名:将 func (f *File) AddShape(sheet, cell string, opts *Shape) error
改为 func (f *File) AddShape(sheet string, opts *Shape) error
ErrExistsTableName
和 ErrorFormControlValue
Options
数据类型中新增 ShortDatePattern
, LongDatePattern
, LongTimePattern
和 CultureInfo
选项,支持设置长短日期与时间格式代码,相关 issue #1199
CultureName
类型枚举GetTables
与 DeleteTable
支持获取与删除表格,相关 issue #674 和 #1454
GetStyle
支持获取样式定义,相关 issue #314, #1520 和 #1521
GetPanes
函数,支持获取窗格和视图选区设置AddFormControl
、GetFormControls
和 DeleteFormControl
,相关 issues #301 和 #1169
AddChart
支持添加主要水平和垂直坐标轴标题,相关 issue #1553
AddChart
支持添加次坐标轴,相关 issue #518
AddChart
支持设置图表富文本标题与图表标题格式,相关 issue #1588
AddShape
函数添加形状时,如果给定的形状类型不受支持,将返回异常错误GetPictures
支持读取带有单一单元格锚点位置的图片,相关 issue #1585
NewConditionalStyle
支持创建带有数字格式与保护属性的条件格式样式,相关 issue #1610
xlsxTabColor
数据类型,使用 xlsxColor
代替 xlsxTabColor
数据类型感谢 Excelize 的所有贡献者,以下是为此版本提交代码的贡献者列表:
IAkumaI (Valery Ozarnichuk)
sillydong (Chen Zhidong)
fudali113 (fudali)
Juneezee (Eng Zer Jun)
joehan109
yicixin (壹次心)
vb6iscool
chengcxy (chengxinyao)
lidp20
JDavidVR (David)
fsfsx
cnmlgbgithub
技术交流群
DingTalk Group ID: 30047129
QQ ID: 1302058237
我们很高兴地宣布发布 2.7.1 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 Release Notes。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
ChartLine
数据类型中的 Color
字段RichTextRun
数据类型代替 ShapeParagraph
Fill
代替 Shape
数据类型中的 Color
字段AutoFilterListOptions
TableOptions
重命名为 Table
AddChart
改为使用 ChartType
类型枚举值指定图表类型func (f *File) AutoFilter(sheet, rangeRef string, opts *AutoFilterOptions) error
修改为 func (f *File) AutoFilter(sheet, rangeRef string, opts []AutoFilterOptions) error
func (f *File) AddPictureFromBytes(sheet, cell, name, extension string, file []byte, opts *GraphicOptions) error
修改为 func (f *File) AddPictureFromBytes(sheet, cell string, pic *Picture) error
func (f *File) GetPicture(sheet, cell string) (string, []byte, error)
修改为 func (f *File) GetPictures(sheet, cell string) ([]Picture, error)
func (f *File) AddVBAProject(bin string) error
修改为 func (f *File) AddVBAProject(file []byte) error
func (f *File) GetComments() (map[string][]Comment, error)
修改为 func (f *File) GetComments(sheet string) ([]Comment, error)
func (f *File) AddTable(sheet, rangeRef string, opts *TableOptions) error
修改为 func (f *File) AddTable(sheet string, table *Table) error
func (sw *StreamWriter) AddTable(rangeRef string, opts *TableOptions) error
修改为 func (sw *StreamWriter) AddTable(table *Table) error
SetSheetDimension
与 GetSheetDimension
以支持设置与获取工作表已用区域,相关 issue #1463
NewStyle
现已支持 17 种渐变填充样式AddPicture
添加图片时,现已允许插入 BMP 格式图片GetPictures
支持读取被添加至同一单元格中的多张图片SetConditionalFormat
支持设置带有“如果为真则停止”和“图标集”条件的条件格式规则SetConditionalFormat
支持设置在条件格式中使用带有纯色填充样式的数据条,并支持指定数据条的颜色,相关 issue #1462
AddChart
支持设置图表中各个数据系列使用自定义填充颜色,相关 issue #1474
AddChart
支持设置气泡图图表中各个系列气泡的大小AddChart
支持设置子母饼图和复合条饼图中第二绘图区域的数据系列AddChart
支持为图表中数据标签设置自定义数字格式,相关 issue #1499
AddTable
支持在创建表格时指定是否包含标题行AddTable
创建表格时增加对表格名称的校验,并导出了错误常量 ErrTableNameLength
,相关 issue #1468
AutoFilter
支持为筛选范围内的多个列设置筛选条件CalcCellValue
现已支持指定是否为公式计算结果应用数字格式CalcCellValue
对于以下公式函数加入了双字节字符的支持:LEFT, LEN, LENB, MID, MIDB, RIGHT 和 RIGHTB,相关 issue #1476
CalcCellValue
函数对于存在错误的公式将在计算结果中返回公式错误代码,并将详细错误信息在 error 数据类型的返回值中返回,相关 issue #1490
GetCellHyperLink
函数支持读取合并单元格中的超链接ChartType
以表示图表类型枚举感谢 Excelize 的所有贡献者,以下是为此版本提交代码的贡献者列表:
liron-l (Liron Levin)
nathj07 (Nathan Davies)
Josh-Weston (Josh Weston)
jaby
FlowingSPDG (Shugo Kawamura)
barismar (Baris Mar Aziz)
doingNobb (张涛)
rpoetrap (Rizki Putra)
huangshaokun
CHANTXU64 (ChantXu64)
playGitboy
技术交流群
我们很高兴地宣布发布 2.7.0 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 Release Notes。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
ioutil
GetCellStyle
函数不再返回合并单元格区域左上角单元格的样式PivotTableOption
重命名为 PivotTableOptions
FormatHeaderFooter
重命名为 HeaderFooterOptions
FormatSheetProtection
重命名为 SheetProtectionOptions
SparklineOption
重命名为 SparklineOptions
ErrExistsWorksheet
重命名为 ErrExistsSheet
AutoPageBreaks
, BaseColWidth
, BlackAndWhite
, CodeName
, CustomHeight
, Date1904
, DefaultColWidth
, DefaultGridColor
, DefaultRowHeight
, EnableFormatConditionsCalculation
, FilterPrivacy
, FirstPageNumber
, FitToHeight
, FitToPage
, FitToWidth
, OutlineSummaryBelow
, PageLayoutOption
, PageLayoutOptionPtr
, PageLayoutOrientation
, PageLayoutPaperSize
, PageLayoutScale
, PageMarginBottom
, PageMarginFooter
, PageMarginHeader
, PageMarginLeft
, PageMarginRight
, PageMarginsOptions
, PageMarginsOptionsPtr
, PageMarginTop
, Published
, RightToLeft
, SheetFormatPrOptions
, SheetFormatPrOptionsPtr
, SheetPrOption
, SheetPrOptionPtr
, SheetViewOption
, SheetViewOptionPtr
, ShowFormulas
, ShowGridLines
, ShowRowColHeaders
, ShowRuler
, ShowZeros
, TabColorIndexed
, TabColorRGB
, TabColorTheme
, TabColorTint
, ThickBottom
, ThickTop
, TopLeftCell
, View
, WorkbookPrOption
, WorkbookPrOptionPtr
, ZeroHeight
和 ZoomScale
OrientationPortrait
和 OrientationLandscape
func (f *File) SetPageLayout(sheet string, opts ...PageLayoutOption) error
修改为 func (f *File) SetPageLayout(sheet string, opts *PageLayoutOptions) error
func (f *File) GetPageLayout(sheet string, opts ...PageLayoutOptionPtr) error
修改为 func (f *File) GetPageLayout(sheet string) (PageLayoutOptions, error)
func (f *File) SetPageMargins(sheet string, opts ...PageMarginsOptions) error
修改为 func (f *File) SetPageMargins(sheet string, opts *PageLayoutMarginsOptions) error
func (f *File) GetPageMargins(sheet string, opts ...PageMarginsOptionsPtr) error
修改为 func (f *File) GetPageMargins(sheet string) (PageLayoutMarginsOptions, error)
func (f *File) GetSheetIndex(sheet string) int
修改为 func (f *File) GetSheetIndex(sheet string) (int, error)
func (f *File) SetSheetName(source, target string)
修改为 func (f *File) SetSheetName(source, target string) error
func (f *File) GetSheetVisible(sheet string) bool
修改为 func (f *File) GetSheetVisible(sheet string) (bool, error)
func (f *File) DeleteSheet(sheet string)
修改为 func (f *File) DeleteSheet(sheet string) error
func (f *File) NewSheet(sheet string) int
修改为 func (f *File) NewSheet(sheet string) (int, error)
func (f *File) NewConditionalStyle(style string) (int, error)
修改为 func (f *File) NewConditionalStyle(style *Style) (int, error)
func (f *File) NewStyle(style interface{}) (int, error)
修改为 func (f *File) NewStyle(style *Style) (int, error)
func (f *File) AddChart(sheet, cell, opts string, combo ...string) error
修改为 func (f *File) AddChart(sheet, cell string, chart *ChartOptions, combo ...*ChartOptions) error
func (f *File) AddChartSheet(sheet, opts string, combo ...string) error
修改为 func (f *File) AddChartSheet(sheet string, chart *ChartOptions, combo ...*ChartOptions) error
func (f *File) AddShape(sheet, cell, opts string) error
修改为 func (f *File) AddShape(sheet, cell string, opts *Shape) error
func (f *File) AddPicture(sheet, cell, picture, format string) error
修改为 func (f *File) AddPicture(sheet, cell, picture string, opts *GraphicOptions) error
func (f *File) AddPictureFromBytes(sheet, cell, opts, name, extension string, file []byte) error
修改为 func (f *File) AddPictureFromBytes(sheet, cell, name, extension string, file []byte, opts *GraphicOptions) error
func (f *File) AddTable(sheet, hCell, vCell, opts string) error
修改为 func (f *File) AddTable(sheet, rangeRef string, opts *TableOptions) error
func (sw *StreamWriter) AddTable(hCell, vCell, opts string) error
修改为 func (sw *StreamWriter) AddTable(rangeRef string, opts *TableOptions) error
func (f *File) AutoFilter(sheet, hCell, vCell, opts string) error
修改为 func (f *File) AutoFilter(sheet, rangeRef string, opts *AutoFilterOptions) error
func (f *File) SetPanes(sheet, panes string) error
修改为 func (f *File) SetPanes(sheet string, panes *Panes) error
func (f *File) SetConditionalFormat(sheet, reference, opts string) error
修改为 func (f *File) SetConditionalFormat(sheet, rangeRef string, opts []ConditionalFormatOptions) error
SetSheetProps
代替 SetSheetPrOptions
和 SetSheetFormatPr
函数GetSheetProps
代替 GetSheetPrOptions
和 GetSheetFormatPr
函数SetSheetView
代替 SetSheetViewOptions
函数GetSheetView
代替 GetSheetViewOptions
函数SetWorkbookProps
代替 SetWorkbookPrOptions
函数GetWorkbookProps
代替 GetWorkbookPrOptions
函数InsertRows
代替 InsertRow
以支持批量添加行InsertCols
代替 InsertCol
以支持批量添加列CellType
枚举值中添加 CellTypeFormula
, CellTypeInlineString
, CellTypeSharedString
并移除了 CellTypeString
AddComment
函数的签名进行了更改,支持创建富文本批注,相关 issue #1204
GetComments
, GetDefaultFont
和 SetDefaultFont
增加了 error 类型的错误返回值GetDataValidations
和 GetConditionalFormats
函数以支持获取数据验证设置和条件格式,相关 issue #827
ProtectWorkbook
和 UnprotectWorkbook
以提供工作簿保护设置支持SetSheetCol
函数以支持按列设置单元格的值,相关 issue #1247
GetColStyle
函数以支持获取列样式,相关 issue #1293
SetSheetBackgroundFromBytes
函数以支持根据给定的图片数据设置工作表背景图片,相关 issue #1405
IndexedColorMapping
以支持内建索引颜色转换AutoFilterListOptions
, AutoFilterOptions
, Chart
, ChartAxis
, ChartDimension
, ChartLegend
, ChartLine
, ChartMarker
, ChartPlotArea
, ChartSeries
, ChartTitle
, ConditionalFormatOptions
, PaneOptions
, Panes
, GraphicOptions
, Shape
, ShapeColor
, ShapeLine
, ShapeParagraph
和 TableOptions
Save
、Write
和 WriteTo
函数支持指定保存选项,相关 issue #744
AddChart
函数添加图表时,支持为折线图设置是否使用平滑折线,相关 issue #1290
AddChart
函数添加图表时,支持设置自定义折线图线条颜色,相关 issue #1345
AddChart
函数添加图表时,支持设置自定义坐标轴字体样式,相关 issue #320
AddChart
支持创建三维折线图SetColWidth
、GetColWidth
、SetColVisible
、GetColVisible
、SetColStyle
和 GetColStyle
RowOpts
为单元格设置样式,相关 issue #1354
ErrUnprotectWorkbook
、ErrUnprotectWorkbookPassword
、ErrStreamSetPanes
、ErrSheetNameBlank
、ErrSheetNameInvalid
、ErrSheetNameLength
和 ErrSheetNameSingleQuote
,以便开发者可根据不同的错误类型进行采取相应处理HeaderFooterOptions
、PageLayoutMarginsOptions
、PageLayoutOptions
、SheetPropsOptions
和 ViewOptions
AddPicture
添加图片时,现已允许插入 SVG 格式图片OR
计算结果有误的问题SetRow
函数的性能,相较于上一版本,耗时最高降低约 19%感谢 Excelize 的所有贡献者,以下是为此版本提交代码的贡献者列表:
我们很高兴地宣布发布 2.6.1 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 Release Notes。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
TabColor
为 TabColorRGB
TotalColumns
为 MaxColumns
ErrMaxFileNameLength
为 ErrMaxFilePathLength
ErrWorkbookExt
为 ErrWorkbookFileFormat
ErrEncrypt
DeleteComment
函数支持删除单元格批注,相关 issue #849
AddShape
函数添加形状时支持指定宏AddPicture
添加图片时,现已允许插入 EMF、WMF、EMZ 和 WMZ 格式图片,相关 issue #1225
ErrWorkbookPassword
定义了打开工作簿时密码验证失败的错误提示信息,以便开发者可根据不同的错误类型进行采取相应处理MinFontSize
、MinColumns
和 MaxCellStyles
以定义最小字号、最小列号和单元格样式数量上限DeleteDataValidation
函数删除数据验证时,支持省略第二个引用区域参数以删除工作表中的全部数据验证,相关 issue #1254
MaxCalcIterations
以支持指定公式迭代计算的最多迭代次数ColorMappingType
以定义颜色转换枚举类型GetRowOpts
支持读取行属性,相关 issue #1296
AddComment
添加批注时的内存开销并减少耗时,解决 issue #1310
感谢 Excelize 的所有贡献者,以下是为此版本提交代码的贡献者列表:
我们很高兴地宣布发布 2.6.0 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 Release Notes。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
NameSpaceDublinCoreMetadataIntiative
为 NameSpaceDublinCoreMetadataInitiative
以修复拼写错误ErrUnsupportEncryptMechanism
为 ErrUnsupportedEncryptMechanism
ErrDataValidationFormulaLenth
为 ErrDataValidationFormulaLength
ErrDefinedNameduplicate
为 ErrDefinedNameDuplicate
XMLHeaderByte
SetSqrefDropList
的第二个形参 isCurrentSheet
和异常返回值TotalRows
ProtectSheet
新增支持通过指定的算法保护工作表,支持的算法包括: XOR、MD4、MD5、SHA1、SHA256、SHA384 和 SHA512UnprotectSheet
支持通过指定第二个可选参数在移除工作表保护时验证密码SetWorkbookPrOptions
和 GetWorkbookPrOptions
支持设置和获取工作簿中的 FilterPrivacy
与 CodeName
属性,以解除部分情况下向工作簿中嵌入 VBA 工程时的限制,相关 issue #1148
AddChart
函数添加圆环图时,支持指定圆环图内径大小,解决 issue #1172
ErrPasswordLengthInvalid
, ErrUnsupportedHashAlgorithm
, ErrUnsupportedNumberFormat
, ErrWorkbookExt
,以便开发者可根据不同的错误类型进行采取相应处理SetCellDefault
支持设置非数字类型单元格的值,解决 issue #1139
我们很高兴地宣布发布 2.5.0 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
Close
函数关闭工作簿和数据流ReadZipReader
为 File
的实现, 支持通过选项指定解压至内存或文件系统XMLHeader
,可使用 encoding/xml
包的 xml.Header
代替ErrToExcelTime
SetRowStyle
支持设置整行样式, 相关 issue #990
GetCellType
支持获取单元格数据类型, 相关 issue #417 和 #520
SetAppProps
和 GetAppProps
支持设置与获取工作簿应用程序属性, 相关 issue #1095
GetCellValue
, GetRows
, GetCols
, Rows
和 Cols
支持指定是否读取单元格原始值而不应用数字格式表达式, 相关 issue #621
IF
函数, 相关 issue #987
SetCellFormula
支持设置共享公式UpdateLinkedValue
在清除单元格计算缓存时将跳过 macro sheet, 相关 issue #1014
AddPicture
重复创建图片的问题, 相关 issue #1017
AddShape
支持设置形状轮廓线条宽度, 相关 issue #262
UnzipXMLSizeLimit
以支持指定打开每个工作表以及共享字符表时的内存解压上限r="0"
属性工作表的兼容性LOOKUP
函数部分情况下计算结果错误的问题, 解决 issue #994
LOOKUP
仅支持完全匹配的问题, 解决 issue #997
我们很高兴地宣布发布 2.4.1 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
Go Modules 包引用地址调整为 github.com/xuri/excelize/v2
AddPivotTable
创建数据透视表支持通过自定义名称动态引用数据源AddPicture
和 GetPicture
并发插入/获取图片Rows
和 Cols
并发行/列迭代SetSheetRow
并发按行赋值SetCellStyle
并发设置单元格样式NewStyle
并发创建样式File.XLSX
为 File.Pkg
NewSheet
, GetSheetIndex
, DeleteSheet
对工作表名称大小写不敏感,相关 issue #873
SetCellRichText
增加字符数上限检查并修复保留字符丢失问题GetComments
获取批注的问题,解决 issue #825
showOutlineSymbols
、summaryBelow
和 summaryRight
为 false
时,设置失效的问题GetRows
返回冗余工作表尾部空行的问题,解决 issue #842
GetRowHeight
获取行高度错误的问题我们很高兴地宣布发布 2.4.0 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
升级至该版本需要您使用的 Go 语言为 1.15 或更高版本。
GetCellRichText
API,支持根据给定的工作表名称获取富文本SetPageLayout
和 GetPageLayout
现已支持设置和获取页面打印缩放比例、指定单色打印、起始页码SetSheetPrOptions
和 GetSheetPrOptions
现已支持设置和获取工作表标签页颜色SetCellHyperLink
支持设置屏幕提示文字与显示文字,相关 issue #790
ShowError
选项nil
作为值调用 SetCellValue
设置单元格的值时,不再为单元格设置空白字符串而以空值代替,解决 issue #756
COTH
双曲余切三角函数计算有误的问题newFills
和 parseToken
圈复杂度过高的问题UpdateLinkedValue
产生错误的问题GetColWidth
返回默认列宽错误的问题localSheetId
属性将使用 sheetIndex
,修正错误的工作表索引使用我们很高兴地宣布发布 2.3.2 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
AddPivotTable
支持缺省列与多重数据源,相关 issue #710GetCellValue
获取单元格的值支持自定义日期与时间数字格式,相关 issue #703CalcCellValue
新增公式函数支持 AND
、CLEAN
、TRIM
、LOWER
、PROPER
、UPPER
和 OR
,相关 issue #701 和 #747AddChart
新增支持设置数据系列线型宽度和线端类型,相关 issue #549 和 #654NewSheet
返回工作表索引错误的问题,相关 issue #714AddPicture
向带有多个合并单元格的工作表中插入图片时,指定自适应尺寸失效的问题,相关 issue 748worksheetWriter
运行时对内存分配的影响,相关 issue #722AddPicture
添加图片 API 的性能,相关 issue #706我们很高兴地宣布发布 2.3.1 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
RemoveRow
特定情况下由于下标溢出导致的 panic,相关 issue #686我们很高兴地宣布发布 2.3.0 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
SetSheetFormatPr
和 GetSheetFormatPr
,支持设置工作表格式属性,相关 issue #635GetCols
和 Cols
列迭代器AddChart
添加图表 API 支持指定 Y 轴对数刻度,相关 issue #661AddPicture
添加图片 API 支持插入图片自适应单元格CalcCellValue
更新:新增 12 项函数, COUNTA
, ISBLANK
, ISERR
, ISERROR
, ISEVEN
, ISNA
, ISNONTEXT
, ISODD
, ISNUMBER
, MEDIAN
, NA
和 SUMIF
r
属性的 row
标签,以修复部分情况下读取工作表内容为空的问题我们很高兴地宣布发布 2.2.0 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
GetSheetName
、GetSheetIndex
、GetActiveSheetIndex
和 SetActiveSheet
, 相关 #485GetSheetList
API,获取与工作簿内顺序保持一致的工作表列表AddChartSheet
API,支持创建图表工作表,相关 issue #451UnsetConditionalFormat
API,支持从工作表中删除条件格式,相关 issue #571DeleteDataValidation
API,支持从工作表中删数据验证设置,相关 issue #348SetCellRichText
API,支持设置单元格换行与富文本样式,相关 issue #172InsertPageBreak
和 RemovePageBreak
,支持从工作表中插入或删除换页符,相关 issue #492AddPivotTable
API 更改,支持设置数据透视表的数据标签与汇总函数,相关 issue #582AddPivotTable
支持设置数据透视表的筛选项,相关 issue #598AddPivotTable
支持数据透视表中的值、行或筛选项为空ExcelDateToTime
,提供将 Excel 时间格式转换为 time.Time
数据类型Style
结构体,允许通过结构体指针或 JSON 字符创建样式,相关 issue #470SetConditionalFormat
为单元格设置条件格式时,>=
和 <=
运算符不生效的问题, 解决 issue #608StreamWriter
进行流式写入导致工作表损坏的问题,解决 issue #576DuplicateRowTo
进行复制行时,合并单元格未被复制的问题,解决 issue #586GetComments
获取批注式部分批注数据无法获取问题,解决 issue #345GetCellValue
获取单元格值错误问题,解决 issue #602r
属性而导致的 GetCellValue
错误地返回空值问题getRowHeight
,降低内存占用我们很高兴地宣布发布 2.1.0 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
DeleteDefinedName
方法,支持从工作簿或工作表中删除名称SetPageMargins
和 GetPageMargins
方法,支持获取和设置页面边距DeleteChart
和 DeletePicture
方法,支持从工作表中删除图表和图片AddChart
现已支持创建子母饼图、复合条饼图和组合图AddChart
新增设置图表主要网格线支持,相关 issue #501
AddChart
支持设置折线图线条宽度,相关 issue #505
AddChart
现已支持指定图表坐标轴标签间隔单位,相关 issue #538
SetColVisible
支持对指定范围内的多列进行可见行设置AddPivotTable
支持创建数据透视表时,所引用数据源区域存在空列,相关 issue #511
MergeCell
支持重叠合并单元格处理,解决 issue #533
NewStreamWriter
和 Flush
方法,适用于生成包含大规模数据的工作表。与非流式写入相比,可降低 90.2% 的内存开销、节省 53% 时间GetRows
内存采用流式数据读取,读取电子表格文档内存开销降低 87.9%,相关 issue #146 和 issue #382
我们很高兴地宣布发布 2.0.2 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
升级至该版本需要您的 Go 语言版本高于 1.10。
AddPivotTable()
函数AddSparkline()
函数GroupSheets()
和 UngroupSheets()
方法,支持设置工作表分组和取消工作表分组AddVBAProject()
方法,支持向 Excel 文档中嵌入包含函数和宏的 VBA 工程SetPageLayout()
增加适应页面宽高属性支持,相关 issue #432
SetSheetViewOptions()
现在支持 “值为零的单元格是否显示零值” 属性的设置SetCellFormula()
增加了对公式类型和引用属性的设置支持RemoveRow()
删除行出现下标越界问题,解决 issue #437
Save()
方法保存导致的文档损坏问题,解决 issue #443
workbook.xml.rels
中相对路径格式解析的兼容性,解决 issue #442
GetSheetName
获取工作表名称为空的问题, 解决 issue #457
SetSheetPrOptions()
所致的文档损坏问题,解决 issue #483
SetSheetRow()
函数中的异常处理workBookRelsWriter
, drawingRelsWriter
合并为 relsWriter
drawingRelsReader
, workbookRelsReader
, workSheetRelsReader
合并为 relsReader
addDrawingRelationships
, addSheetRelationships
合并为 addRels
我们很高兴地宣布发布 2.0.1 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
SetHeaderFooter()
方法,支持设置页眉和页脚,相关 issue #394
SetColStyle()
方法,支持设置列样式,相关 issue #397
SetDefaultFont()
和 GetDefaultFont()
方法,支持设置工作簿默认字体,相关 issue #390
SetDocProps()
和 GetDocProps()
方法,支持设置和获取文档属性,相关 issue #415
AddChart()
新增加了 26 种图表的创建:簇状圆锥、堆积圆锥、百分比堆积圆锥、三维圆锥图、簇状水平圆锥图、堆积水平圆锥图、堆积百分比水平圆锥图、簇状棱锥图、堆积棱锥、百分比堆积棱锥、三维棱锥图、簇状水平棱锥图、堆积水平棱锥图、堆积百分比水平棱锥图、簇状柱形图 、堆积柱形图、百分比堆积柱形图、三维柱形图、簇状水平圆柱图、堆积水平圆柱图、堆积百分比水平圆柱图、三维曲面图、俯视框架曲面图、三维曲面框架图、气泡图与三维气泡图,不受支持的图表类型将返回错误提示SetDefinedName()
和 GetDefinedName()
方法,支持设置和获取名称AddPicture()
现在支持添加 TIF 和 TIFF 格式的图片我们很高兴地宣布发布 2.0.0 版本,该版本包含了很多新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log.
此版本中最显著的变化包括:
下表列出了 v2.0.0 相比较于 v1.4.1 版本,API 的更改情况:
函数名 | 增加 error 返回值 |
行号计算方法变更* | 删除 | 新增 |
---|---|---|---|---|
ToALphaString | × | × | √ | × |
TitleToNumber | × | × | √ | × |
SplitCellName | × | × | × | √ |
JoinCellName | × | × | × | √ |
ColumnNameToNumber | × | × | × | √ |
ColumnNumberToName | × | × | × | √ |
CellNameToCoordinates | × | × | × | √ |
CoordinatesToCellName | × | × | × | √ |
DuplicateRowTo | × | × | × | √ |
SetCellFloat | × | × | × | √ |
SetCellStyle | √ | × | × | × |
InsertCol | √ | × | × | × |
RemoveCol | √ | × | × | × |
RemoveRow | √ | √ | × | × |
InsertRow | √ | √ | × | × |
DuplicateRow | √ | × | × | × |
SetRowHeight | √ | × | × | × |
GetRowHeight | √ | × | × | × |
GetCellValue | √ | × | × | × |
GetCellFormula | √ | × | × | × |
GetCellHyperLink | √ | × | × | × |
SetCellHyperLink | √ | × | × | × |
SetCellInt | √ | × | × | × |
SetCellBool | √ | × | × | × |
SetCellStr | √ | × | × | × |
SetCellDefault | √ | × | × | × |
GetCellStyle | √ | × | × | × |
SetCellValue | √ | × | × | × |
MergeCell | √ | × | × | × |
SetSheetRow | √ | × | × | × |
SetRowVisible | √ | √ | × | × |
GetRowVisible | √ | √ | × | × |
SetRowOutlineLevel | √ | √ | × | × |
GetRowOutlineLevel | √ | √ | × | × |
GetRows | √ | × | × | × |
Columns | √ | × | × | × |
SearchSheet | √ | × | × | × |
GetPicture | √ | × | × | × |
AutoFilter | √ | × | × | × |
GetColVisible | √ | × | × | × |
SetColVisible | √ | × | × | × |
GetColOutlineLevel | √ | × | × | × |
SetColOutlineLevel | √ | × | × | × |
SetColWidth | √ | × | × | × |
GetColWidth | √ | × | × | × |
GetMergeCells | √ | × | × | × |
ProtectSheet | √ | × | × | × |
UnprotectSheet | √ | × | × | × |
UpdateLinkedValue | √ | × | × | × |
SetSheetVisible | √ | × | × | × |
adjustHelper | √ | × | × | × |
adjustMergeCells | √ | × | × | × |
adjustAutoFilter | √ | × | × | × |
prepareCell | √ | × | × | × |
setDefaultTimeStyle | √ | × | × | × |
timeToExcelTime | √ | × | × | × |
addDrawingChart | √ | × | × | × |
addDrawingVML | √ | × | × | × |
addDrawingPicture | √ | × | × | × |
getTotalRowsCols | √ | × | × | × |
checkRow | √ | × | × | × |
addDrawingShape | √ | × | × | × |
addTable | √ | × | × | × |
workSheetReader | √ | × | × | × |
copySheet | √ | × | × | × |
* 从版本 v2.0.0 开始,所有行操作方法都使用从 1
开始的 Excel 行编号,早期版本中某些方法中的基于 0
的行编号将不再使用,参考相关 issue #349。
DuplicateRowTo()
方法, 支持根据给定的工作表名称(大小写敏感)和行号,在指定行后复制该行SetPageLayout()
新增对页面布局方向设置的支持,解决了相关 issue #318
SetPageLayout()
新增对页面纸张大小设置的支持225
个字符时,文件打开失败的问题,解决了相关 issue #339
GetComment()
,从包含多个工作表的工作簿获取批注时,返回了错误的工作表名称的问题,解决了相关 issue #345
GetRows()
返回多余的列的问题下图是 v1.4.1 和 v2.0.0 版本下创建 12800 行 50 列工作表所执行时间和内存使用情况:
我们很高兴地宣布发布 1.4.1 版本,该版本包含了很多新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log.
此版本中最显著的变化包括:
WriteTo()
方法, 该函数通过实现 io.WriterTo 接口支持文件写入SearchSheet()
方法,支持通过给定工作表名称、单元格的值或者正则表达式来搜索指定工作表,相关 issue #277
ProtectSheet()
和 UnprotectSheet()
方法,支持设置保护和取消保护工作表,以防止其他用户意外或故意更改,移动或删除工作表中的数据,相关 issue #273
GetMergeCells()
方法,支持通过给定的工作表名称获取当前工作表中全部合并单元格的坐标与值go module
支持AddChart()
新增支持创建 二维面积图、二维堆积面积图、二维百分比堆积面积图、三维面积图、三维堆积面积图和三维百分比堆积面积图,相关 issue #311
sharedStringsReader()
因缺少传统与严格模式 XML 命名空间地址转换导致的问题,解决相关 issue #276
GetRows()
获取指定工作表中全部单元格,该函数的返回值将忽略工作表尾部空白行,解决了相关 issue #195
GetSheetMap()
返回工作表索引与名称异常问题,解决了相关 issue #297
我们很高兴地宣布发布 1.4.0 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
AddChart()
、AddComment()
、AddPicture()
、AddShape()
、AddTable()
和 SetConditionalFormat()
GetComments()
支持获取指定工作表中全部批注内容的哈希表RGBToHSL()
和 HSLToRGB()
支持 RGBA 和 HSL 之间的色值转换NewDataValidation()
与系列函数 DataValidation.SetDropList()
、DataValidation.SetError()
、DataValidation.SetInput()
、DataValidation.SetRange()
、DataValidation.SetSqref()
和 DataValidation.SetSqrefDropList()
支持设置数据验证AddPictureFromBytes()
支持从字节数组添加图片到工作表,相关 issue #259GetCellFormula()
现已支持获取单元格共享公式,相关 issue #227NewSheet()
创建工作表导致的问题,相关 issue #249deepcopy
我们很高兴地宣布发布 1.3.0 版本,该版本包含了多项新功能和错误修复。
有关更改的摘要,请参阅 版本说明。完整的更改列表可查看 change log。
此版本中最显著的变化包括:
SetRowHeight()
与 GetRowHeight()
中行索引的一致性, 修复问题 issue #205SetSheetRow()
支持批量设置单行单元格的值,相关 issue #96 和 #194GetColOutlineLevel()
、GetRowOutlineLevel()
、SetColOutlineLevel()
和 SetRowOutlineLevel()
支持设置工作表行、列分组Rows
、Columns()
、Next()
和 Error()
SetCellValue()
现已支持 bool
和 time.Duration
类型值AddTable()
支持指定表格名称,相关 issue #216AddPicture()
新增支持设置图片位置,相关 issue #214GetCellValue()
支持读取 inlineStr
内联类型单元格的值,相关 issue #208 和 #209AddChart()
支持自定义图表尺寸AddPicture()
插入的图片设置超链接属性,相关 issue #185DeleteSheet()
删除工作表时,因内部 activeTab
属性计算错误导致的文档损坏,解决 issue #165xl/SharedStrings.xml
的电子表格文档,相关 issue #188checkCellInArea()
解析合并单元格坐标时下标越界问题,相关 issue #206SetCellStyle()
设置单元格样式速度,优化内部检查行/列区域函数 checkCellInArea()
bytes
代替 string
降低 11% 内存使用,更多性能相关数据请参考 Performance Figures