工具函数

创建表格

  1. func (f *File)AddTable(sheet, hcell, vcell, format string) error

根据给定的工作表名、单元格坐标区域和条件格式创建表格。

  • 例1,在名为 Sheet1 的工作表 A1:D5 区域创建表格:

创建表格

  1. err := f.AddTable("Sheet1","A1","D5",``)
  • 例2,在名为 Sheet2 的工作表 F2:H6 区域创建带有条件格式的表格:

创建带有条件格式的表格

  1. err := f.AddTable("Sheet2","F2","H6",`{
  2. "table_name": "table",
  3. "table_style": "TableStyleMedium2",
  4. "show_first_column": true,
  5. "show_last_column": true,
  6. "show_row_stripes": false,
  7. "show_column_stripes": true
  8. }`)

注意,表格坐标区域至少需要覆盖两行:字符型的标题行和内容行。每列标题行的字符需保证是唯一的,并且必须在调用 AddTable 函数前设置表格的标题行数据。多个表格的坐标区域不能有交集。

可选参数 table_name 用以设置自定义表格名称,同一个工作表内的表格名称应该是唯一的。

Excelize 支持的表格样式 table_style 参数:

  1. TableStyleLight1-TableStyleLight21
  2. TableStyleMedium1-TableStyleMedium28
  3. TableStyleDark1-TableStyleDark11
索引预览索引预览索引预览
工具函数 - 图3TableStyleLight1工具函数 - 图4TableStyleLight2工具函数 - 图5
TableStyleLight3工具函数 - 图6TableStyleLight4工具函数 - 图7TableStyleLight5工具函数 - 图8
TableStyleLight6工具函数 - 图9TableStyleLight7工具函数 - 图10TableStyleLight8工具函数 - 图11
TableStyleLight9工具函数 - 图12TableStyleLight10工具函数 - 图13TableStyleLight11工具函数 - 图14
TableStyleLight12工具函数 - 图15TableStyleLight13工具函数 - 图16TableStyleLight14工具函数 - 图17
TableStyleLight15工具函数 - 图18TableStyleLight16工具函数 - 图19TableStyleLight17工具函数 - 图20
TableStyleLight18工具函数 - 图21TableStyleLight19工具函数 - 图22TableStyleLight20工具函数 - 图23
TableStyleLight21工具函数 - 图24TableStyleMedium1工具函数 - 图25TableStyleMedium2工具函数 - 图26
TableStyleMedium3工具函数 - 图27TableStyleMedium4工具函数 - 图28TableStyleMedium5工具函数 - 图29
TableStyleMedium6工具函数 - 图30TableStyleMedium7工具函数 - 图31TableStyleMedium8工具函数 - 图32
TableStyleMedium9工具函数 - 图33TableStyleMedium10工具函数 - 图34TableStyleMedium11工具函数 - 图35
TableStyleMedium12工具函数 - 图36TableStyleMedium13工具函数 - 图37TableStyleMedium14工具函数 - 图38
TableStyleMedium15工具函数 - 图39TableStyleMedium16工具函数 - 图40TableStyleMedium17工具函数 - 图41
TableStyleMedium18工具函数 - 图42TableStyleMedium19工具函数 - 图43TableStyleMedium20工具函数 - 图44
TableStyleMedium21工具函数 - 图45TableStyleMedium22工具函数 - 图46TableStyleMedium23工具函数 - 图47
TableStyleMedium24工具函数 - 图48TableStyleMedium25工具函数 - 图49TableStyleMedium26工具函数 - 图50
TableStyleMedium27工具函数 - 图51TableStyleMedium28工具函数 - 图52TableStyleDark1工具函数 - 图53
TableStyleDark2工具函数 - 图54TableStyleDark3工具函数 - 图55TableStyleDark4工具函数 - 图56
TableStyleDark5工具函数 - 图57TableStyleDark6工具函数 - 图58TableStyleDark7工具函数 - 图59
TableStyleDark8工具函数 - 图60TableStyleDark9工具函数 - 图61TableStyleDark10工具函数 - 图62
TableStyleDark11工具函数 - 图63

自动过滤器

  1. func (f *File)AutoFilter(sheet, hcell, vcell, format string) error

根据给定的工作表名、单元格坐标区域和条件格式创建自动过滤器。Excel 中的自动过滤器可以对一些简单的二维数据数据进行数据筛选。

例1,在名称为 Sheet1 的工作表 A1:D4 区域创建自动过滤器:

创建自动过滤器

  1. err := f.AutoFilter("Sheet1","A1","D4","")

例2,在名称为 Sheet1 的工作表 A1:D4 区域创建带有格式条件的自动过滤器:

  1. err := f.AutoFilter("Sheet1","A1","D4",`{"column":"B","expression":"x != blanks"}`)

参数 column 指定了自动过滤器在过滤范围内的基准列。 Excelize 暂不支持自动过滤器的计算,在设置过滤条件后,如果需要隐藏任何不符合过滤条件的行,可以使用 SetRowVisible() 设置行的可见性。

为列设置过滤条件,参数 expression 用于指定过滤条件运算,支持下列运算符:

  1. ==
  2. !=
  3. >
  4. <
  5. >=
  6. <=
  7. and
  8. or

一个表达式可以包含一个或两个由 andor 运算符分隔的语句。例如:

  1. x <2000
  2. x >2000
  3. x ==2000
  4. x >2000and x <5000
  5. x ==2000or x ==5000

可以通过在表达式中使用空白或非空白值来实现空白或非空白数据的过滤:

  1. x ==Blanks
  2. x ==NonBlanks

Office Excel 还允许一些简单的字符串匹配操作:

  1. x == b*// 以 b 开始
  2. x != b*// 不以 b 开始
  3. x ==*b // 以 b 结尾
  4. x !=*b // 不以 b 结尾
  5. x ==*b*// 包含 b
  6. x !=*b*// 不包含 b

我们还可以使用 * 来匹配任何字符或数字,用 ? 匹配任何单个字符或数字。除此之外,Office Excel 的自动过滤器不支持其他正则表达式的关键字。 Excel 的正则表达式字符可以使用 ~ 进行转义。

上述示例中的占位符变量 x 可以被任何简单的字符串替换。实际的占位符名称在内部被忽略,所以以下所有表达式的效果都是等同的:

  1. x <2000
  2. col <2000
  3. Price<2000

清除单元格缓存

  1. func (f *File)UpdateLinkedValue() error

Excel 会在保存时将保存带有公式的单元格的计算结果,这会导致在 Office Excel 2007 和 2010 中文档在打开时,即便计算因子已经发生变化,公式的计算结果不会自动更新。参考链接:https://social.technet.microsoft.com/Forums/office/en-US/e16bae1f-6a2c-4325-8013-e989a3479066/excel-2010-linked-cells-not-updating 此函数会将工作簿中所有缓存结果清除,这样文档在 Office Excel 中被重新打开时会自动计算新的公式结果,但是由于计算后文档发生了变化,在关闭文档时 Office Excel 会提示是否保存工作簿。

清除单元格缓存对工作簿的影响表现为对 <v> 标签的修改,例如,清除前的单元格缓存:

  1. <rowr="19"spans="2:2">
  2. <cr="B19">
  3. <f>SUM(Sheet2!D2,Sheet2!D11)</f>
  4. <v>100</v>
  5. </c>
  6. </row>

清除单元格缓存后:

  1. <rowr="19"spans="2:2">
  2. <cr="B19">
  3. <f>SUM(Sheet2!D2,Sheet2!D11)</f>
  4. </c>
  5. </row>

单元格坐标切分

  1. func SplitCellName(cell string)(string,int, error)

将工作表的单元格坐标切分为列名和行号。例如,将单元格坐标 AK74 切分为 AK74

  1. excelize.SplitCellName("AK74")// return "AK", 74, nil

单元格坐标组合

  1. func JoinCellName(col string, row int)(string, error)

将列名和行号组合成工作表的单元格坐标。

列名转索引

  1. func ColumnNameToNumber(name string)(int, error)

将工作表的列名(大小写不敏感)转换为索引,对于错误的列名格式将返回错误。例如:

  1. excelize.ColumnNameToNumber("AK")// returns 37, nil

索引转列名

  1. func ColumnNumberToName(num int)(string, error)

将数据类型为整型的索引转换为列名。例如:

  1. excelize.ColumnNumberToName(37)// returns "AK", nil

单元格坐标转索引

  1. func CellNameToCoordinates(cell string)(int,int, error)

将由字母和数字组合而成的单元格坐标转换为 [X, Y] 形式的行、列索引,或返回错误。例如:

  1. excelize.CellCoordinates("A1")// returns 1, 1, nil
  2. excelize.CellCoordinates("Z3")// returns 26, 3, nil

索引转单元格坐标

  1. func CoordinatesToCellName(col, row int, abs ...bool)(string, error)

[X, Y] 形式的行、列索引转换为由字母和数字组合而成的单元格坐标,或返回错误。例如:

  1. excelize.CoordinatesToCellName(1,1)// returns "A1", nil
  2. excelize.CoordinatesToCellName(1,1,true)// returns "$A$1", nil

创建条件格式样式

  1. func (f *File)NewConditionalStyle(style string)(int, error)

通过给定样式为条件格式创建样式,样式参数与 NewStyle() 函数的相同。请注意,使用 RGB 色域颜色代码时,目前仅支持设置字体、填充、对齐和边框的颜色。

设置条件格式

  1. func (f *File)SetConditionalFormat(sheet, area, formatSet string) error

根据给定的工作表名称、单元格坐标区域和格式参数,为单元格值创建条件格式设置规则。条件格式是 Office Excel 的一项功能,它允许您根据特定条件将格式应用于单元格或一系列单元格。

格式参数 type 选项是必需的参数,它没有默认值。允许的类型值及其相关参数是:

类型参数
cellcriteria
value
minimum
maximum
datecriteria
value
minimum
maximum
time_periodcriteria
textcriteria
value
averagecriteria
duplicate(none)
unique(none)
topcriteria
value
bottomcriteria
value
blanks(none)
no_blanks(none)
errors(none)
no_errors(none)
2_color_scalemin_type
max_type
min_value
max_value
min_color
max_color
3_color_scalemin_type
mid_type
max_type
min_value
mid_value
max_value
min_color
mid_color
max_color
data_barmin_type
max_type
min_value
max_value
bar_color
formulacriteria

criteria 参数用于设置单元格数据的条件格式运算符。它没有默认值,同常与 {"type":"cell"} 一起使用,支持的参数为:

文本描述字符符号表示
between
not between
equal to==
not equal to!=
greater than>
less than<
greater than or equal to>=
less than or equal to<=

可以使用上面表格第一列中的 Office Excel 文本描述字符,或者符号表示方法(betweennot between 没有符号表示法)作为条件格式运算符。 下面的相关部分显示了其他条件格式类型的特定标准。

value:该值通常与 criteria 参数一起使用,可以用确定的值作为设置单元格条件格式的条件参数:

  1. f.SetConditionalFormat("Sheet1","D1:D10", fmt.Sprintf(`[
  2. {
  3. "type": "cell",
  4. "criteria": ">",
  5. "format": %d,
  6. "value": "6"
  7. }]`, format))

value 属性也可以是单元格引用:

  1. f.SetConditionalFormat("Sheet1","D1:D10", fmt.Sprintf(`[
  2. {
  3. "type": "cell",
  4. "criteria": ">",
  5. "format": %d,
  6. "value": "$C$1"
  7. }]`, format))

类型:format - format 参数用于指定满足条件格式标准时将应用于单元格的格式。该参数可以通过 NewConditionalStyle() 方法来创建:

  1. format, err = f.NewConditionalStyle(`{
  2. "font":
  3. {
  4. "color": "#9A0511"
  5. },
  6. "fill":
  7. {
  8. "type": "pattern",
  9. "color": ["#FEC7CE"],
  10. "pattern": 1
  11. }
  12. }`)
  13. if err !=nil{
  14. fmt.Println(err)
  15. }
  16. f.SetConditionalFormat("Sheet1","A1:A10", fmt.Sprintf(`[
  17. {
  18. "type": "cell",
  19. "criteria": ">",
  20. "format": %d,
  21. "value": "6"
  22. }]`, format))

注意:在 Office Excel 中,条件格式叠加在现有单元格格式上,并非所有单元格格式属性都可以修改。无法在条件格式中修改的属性包括:字体名称、字体大小、上标和下标、对角边框、所有对齐属性和所有保护属性。

Office Excel 中内置了一些与条件格式一起使用的默认样式。可以使用以下 excelize 设置实现这些样式效果:

  1. // 浅红填充色深色文本代表较差
  2. format1, err = f.NewConditionalStyle(`{
  3. "font":
  4. {
  5. "color": "#9A0511"
  6. },
  7. "fill":
  8. {
  9. "type": "pattern",
  10. "color": ["#FEC7CE"],
  11. "pattern": 1
  12. }
  13. }`)
  14. // 黄填充色深黄色文本代表一般
  15. format2, err = f.NewConditionalStyle(`{
  16. "font":
  17. {
  18. "color": "#9B5713"
  19. },
  20. "fill":
  21. {
  22. "type": "pattern",
  23. "color": ["#FEEAA0"],
  24. "pattern": 1
  25. }
  26. }`)
  27. // 绿填充色深绿色文本代表较好
  28. format3, err = f.NewConditionalStyle(`{
  29. "font":
  30. {
  31. "color": "#09600B"
  32. },
  33. "fill":
  34. {
  35. "type": "pattern",
  36. "color": ["#C7EECF"],
  37. "pattern": 1
  38. }
  39. }`)

类型:minimum - 当条件格式 criteriabetweennot between 时,minimum 参数用于设置下限值。

  1. // 高亮单元格条件格式规则: between...
  2. f.SetConditionalFormat("Sheet1","A1:A10", fmt.Sprintf(`[
  3. {
  4. "type": "cell",
  5. "criteria": "between",
  6. "format": %d,
  7. "minimum": "6",
  8. "maximum": "8"
  9. }]`, format))

类型:maximum - 当条件格式 criteriabetweennot between 时,maximum 参数用于设置上限值,参考上面的例子。

类型:average - 平均类型用于指定 Office Excel “最前最后规则”中“经典”样式的“仅高于或低于平均值的数值设置格式”条件格式:

  1. // 最前最后规则:高于平均值...
  2. f.SetConditionalFormat("Sheet1","A1:A10", fmt.Sprintf(`[
  3. {
  4. "type": "average",
  5. "criteria": "=",
  6. "format": %d,
  7. "above_average": true
  8. }]`, format1))
  9. // 最前最后规则:低于平均值...
  10. f.SetConditionalFormat("Sheet1","B1:B10", fmt.Sprintf(`[
  11. {
  12. "type": "average",
  13. "criteria": "=",
  14. "format": %d,
  15. "above_average": false
  16. }]`, format2))

类型:duplicate - 用于设置“突出显示单元格规则”中的“重复值 …”:

  1. // 突出显示单元格规则: 重复值...
  2. f.SetConditionalFormat("Sheet1","A1:A10", fmt.Sprintf(`[
  3. {
  4. "type": "duplicate",
  5. "criteria": "=",
  6. "format": %d
  7. }]`, format))

类型:unique - 用于设置“突出显示单元格规则”中“只为以下内容的单元格设置格式”的“特定文本”:

  1. // 突出显示单元格规则,只为以下内容的单元格设置格式: 特定文本 不等于...
  2. f.SetConditionalFormat("Sheet1","A1:A10", fmt.Sprintf(`[
  3. {
  4. "type": "unique",
  5. "criteria": "=",
  6. "format": %d
  7. }]`, format))

类型:top - 用于设置“最前最后规则”中的“前 10 项…”或“前 10% …”:

  1. // 最前最后规则: 前 10 项...
  2. f.SetConditionalFormat("Sheet1","H1:H10", fmt.Sprintf(`[
  3. {
  4. "type": "top",
  5. "criteria": "=",
  6. "format": %d,
  7. "value": "6"
  8. }]`, format))

设置带有百分比条件的条件格式:

  1. f.SetConditionalFormat("Sheet1","A1:A10", fmt.Sprintf(`[
  2. {
  3. "type": "top",
  4. "criteria": "=",
  5. "format": %d,
  6. "value": "6",
  7. "percent": true
  8. }]`, format))

类型:2_color_scale - 用于设置带有“双色刻度”的“色阶样式”条件格式:

  1. // 色阶:双色刻度
  2. f.SetConditionalFormat("Sheet1","A1:A10",`[
  3. {
  4. "type": "2_color_scale",
  5. "criteria": "=",
  6. "min_type": "min",
  7. "max_type": "max",
  8. "min_color": "#F8696B",
  9. "max_color": "#63BE7B"
  10. }]`)

双色刻度色阶条件格式可选参数:min_typemax_typemin_valuemax_valuemin_colormax_color

类型:3_color_scale - 用于设置带有“三色刻度”的“色阶样式”条件格式:

  1. // 色阶:三色刻度
  2. f.SetConditionalFormat("Sheet1","A1:A10",`[
  3. {
  4. "type": "3_color_scale",
  5. "criteria": "=",
  6. "min_type": "min",
  7. "mid_type": "percentile",
  8. "max_type": "max",
  9. "min_color": "#F8696B",
  10. "mid_color": "#FFEB84",
  11. "max_color": "#63BE7B"
  12. }]`)

三色刻度色阶条件格式可选参数: min_typemid_typemax_typemin_valuemid_valuemax_valuemin_colormid_colormax_color

类型:data_bar - 用于设置“数据条”类型的条件格式。

min_type - 参数 min_type 在条件格式类型为 2_color_scale3_color_scaledata_bar 时可用。参数 mid_type 在条件格式类型为 3_color_scale 时可用。例如:

  1. // 数据条:渐变填充
  2. f.SetConditionalFormat("Sheet1","K1:K10",`[
  3. {
  4. "type": "data_bar",
  5. "criteria": "=",
  6. "min_type": "min",
  7. "max_type": "max",
  8. "bar_color": "#638EC6"
  9. }]`)

参数 min/mid/max_types 可选值列表:

参数类型
min最低值(仅用于 min_type
num数字
percent百分比
percentile百分点值
formula公式
max最高值(仅用于 max_type

mid_type - 当条件格式类型为 3_color_scale 时使用,与 min_type 用法相同,参考上面的表格。

max_type - 与 min_type 用法相同,参考上面的表格。

min_value - 参数 min_valuemax_value 在条件格式类型为 2_color_scale3_color_scaledata_bar 时可用。参数 mid_value 在条件格式类型为 3_color_scale 时可用。

mid_value - 在条件格式类型为 3_color_scale 时可用,与 min_value 的用法相同,参考上述文档。

max_value - 与 min_value 的用法相同,参考上述文档。

min_color - 参数 min_colormax_color 在条件格式类型为 2_color_scale3_color_scaledata_bar 时可用。参数 mid_color 在条件格式类型为 3_color_scale 时可用。例如:

  1. // 色阶:三色刻度
  2. f.SetConditionalFormat("Sheet1","B1:B10",`[
  3. {
  4. "type": "3_color_scale",
  5. "criteria": "=",
  6. "min_type": "min",
  7. "mid_type": "percentile",
  8. "max_type": "max",
  9. "min_color": "#F8696B",
  10. "mid_color": "#FFEB84",
  11. "max_color": "#63BE7B"
  12. }]`)

mid_color - 当条件格式类型为 3_color_scale 时使用。与 min_color 用法相同,参考上述文档。

max_color - 与 min_color 用法相同,参考上述文档。

bar_color - 当条件格式类型为 data_bar 时使用。与 min_color 用法相同,参考上述文档。

删除条件格式

  1. func (f *File)UnsetConditionalFormat(sheet, area string) error

根据给定的工作表名称和单元格坐标区域删除条件格式。

设置窗格

  1. func (f *File)SetPanes(sheet, panes string)

通过给定的工作表名称和窗格样式参数设置冻结窗格或拆分窗格。

activePane 定义了活动窗格,下表为该属性的可选值:

枚举值描述
bottomLeft (Bottom Left Pane)当应用垂直和水平分割时,位于左下方的窗格。

此值也适用于仅应用了水平分割的情况,将窗格分为上下两个区域。在这种情况下,该值指定底部窗格。
bottomRight (Bottom Right Pane)当垂直和水平时,位于底部右侧的窗格。
topLeft (Top Left Pane)当应用垂直和水平分割时,位于左上方的窗格。

此值也适用于仅应用了水平分割的情况,将窗格分为上下两个区域。在这种情况下,该值指定顶部窗格。

此值也适用于仅应用垂直分割的情况,将窗格分割为右侧和左侧区域。在这种情况下,该值指定左侧窗格。
topRight (Top Right Pane)当应用垂直和水平分割时,位于右上方窗格。

此值也适用于仅应用垂直分割的情况,将窗格分割为右侧和左侧区域。在这种情况下,该值指定右侧窗格。

窗格状态类型仅限于下表中当前列出的受支持的值:

枚举值描述
frozen (Frozen)窗格被冻结,但并不分裂。在此状态下,当窗格被解除冻结然后再次解冻时,会生成单个窗格,而不会被分割。

在这种状态下,分割条不可调节。
split (Split)窗格被分裂,但并不冻结。在此状态下,用户可以调整分割条。

x_split - 水平分割点的位置。如果窗格冻结,则此值用于设置顶部窗格中可见的列数。

y_split - 垂直分割点的位置。如果窗格冻结,则此值用于设置左侧窗格中可见的行数。该属性的可能值由 W3C XML Schema double 数据类型定义。

top_left_cell - 处于“从左到右”模式时,右下方窗格中左上角可见单元格的位置。

sqref - 参考单元格坐标区域。可以是非连续的一组单元格坐标区域。

例1,在名为 Sheet1 的工作表上冻结列 A 并设置活动单元格 Sheet1!K16

冻结列

  1. f.SetPanes("Sheet1",`{
  2. "freeze": true,
  3. "split": false,
  4. "x_split": 1,
  5. "y_split": 0,
  6. "top_left_cell": "B1",
  7. "active_pane": "topRight",
  8. "panes": [
  9. {
  10. "sqref": "K16",
  11. "active_cell": "K16",
  12. "pane": "topRight"
  13. }]
  14. }`)

例2,在名为 Sheet1 的工作表上冻结第 1 到第 9 行,并设置活动单元格区域 Sheet1!A11:XFD11

冻结列并设置活动单元格区域

  1. f.SetPanes("Sheet1",`{
  2. "freeze": true,
  3. "split": false,
  4. "x_split": 0,
  5. "y_split": 9,
  6. "top_left_cell": "A34",
  7. "active_pane": "bottomLeft",
  8. "panes": [
  9. {
  10. "sqref": "A11:XFD11",
  11. "active_cell": "A11",
  12. "pane": "bottomLeft"
  13. }]
  14. }`)

例3,在名为 Sheet1 的工作表上创建拆分窗格,并设置活动单元格 Sheet1!J60

创建拆分窗格

  1. f.SetPanes("Sheet1",`{
  2. "freeze": false,
  3. "split": true,
  4. "x_split": 3270,
  5. "y_split": 1800,
  6. "top_left_cell": "N57",
  7. "active_pane": "bottomLeft",
  8. "panes": [
  9. {
  10. "sqref": "I36",
  11. "active_cell": "I36"
  12. },
  13. {
  14. "sqref": "G33",
  15. "active_cell": "G33",
  16. "pane": "topRight"
  17. },
  18. {
  19. "sqref": "J60",
  20. "active_cell": "J60",
  21. "pane": "bottomLeft"
  22. },
  23. {
  24. "sqref": "O60",
  25. "active_cell": "O60",
  26. "pane": "bottomRight"
  27. }]
  28. }`)

例4,解冻并删除名为 Sheet1 上的所有窗格:

  1. f.SetPanes("Sheet1",`{"freeze":false,"split":false}`)

色值计算

  1. func ThemeColor(baseColor string, tint float64)string

通过给定的 RGB 格式色值与色调参数,计算出最终颜色。例如,获取名为 Sheet1 的工作表 A1 单元格的背景颜色:

  1. package main
  2. import(
  3. "fmt"
  4. "strings"
  5. "github.com/360EntSecGroup-Skylar/excelize/v2"
  6. )
  7. func main(){
  8. f, err := excelize.OpenFile("Book1.xlsx")
  9. if err !=nil{
  10. fmt.Println(err)
  11. return
  12. }
  13. fmt.Println(getCellBgColor(f,"Sheet1","A1"))
  14. }
  15. func getCellBgColor(f *excelize.File, sheet, axix string)string{
  16. styleID, err := f.GetCellStyle(sheet, axix)
  17. if err !=nil{
  18. return err.Error()
  19. }
  20. fillID :=*f.Styles.CellXfs.Xf[styleID].FillID
  21. fgColor := f.Styles.Fills.Fill[fillID].PatternFill.FgColor
  22. if fgColor.Theme!=nil{
  23. children := f.Theme.ThemeElements.ClrScheme.Children
  24. if*fgColor.Theme<4{
  25. dklt := map[int]string{
  26. 0: children[1].SysClr.LastClr,
  27. 1: children[0].SysClr.LastClr,
  28. 2:*children[3].SrgbClr.Val,
  29. 3:*children[2].SrgbClr.Val,
  30. }
  31. return strings.TrimPrefix(
  32. excelize.ThemeColor(dklt[*fgColor.Theme], fgColor.Tint),"FF")
  33. }
  34. srgbClr :=*children[*fgColor.Theme].SrgbClr.Val
  35. return strings.TrimPrefix(excelize.ThemeColor(srgbClr, fgColor.Tint),"FF")
  36. }
  37. return strings.TrimPrefix(fgColor.RGB,"FF")
  38. }

RGB与HSL色彩空间色值转换

  1. func RGBToHSL(r, g, b uint8)(h, s, l float64)

该函数提供方法将 RGB 色彩空间三元组转换为 HSL 色彩空间三元组。

HSL与RGB色彩空间色值转换

  1. func HSLToRGB(h, s, l float64)(r, g, b uint8)

该函数提供方法将 HSL 色彩空间三元组转换为 RGB 色彩空间三元组。

文件 Writer

Write

  1. func (f *File)Write(w io.Writer) error

该函数提供方法将当前文件内容写入给定的 io.Writer

WriteTo

  1. func (f *File)WriteTo(w io.Writer)(int64, error)

该函数通过实现 io.WriterTo 以保存文件。

WriteToBuffer

  1. func (f *File)WriteToBuffer()(*bytes.Buffer, error)

该函数提供获取当前文件内容 *bytes.Buffer 的方法。

嵌入 VBA 项目

  1. func (f *File)AddVBAProject(bin string) error

该函数提供方法将包含函数和/或宏的 vbaProject.bin 文件嵌入到 Excel 文档中,文件扩展名应为 .xlsm。例如:

  1. if err := f.SetSheetPrOptions("Sheet1", excelize.CodeName("Sheet1")); err !=nil{
  2. fmt.Println(err)
  3. }
  4. if err := f.AddVBAProject("vbaProject.bin"); err !=nil{
  5. fmt.Println(err)
  6. }
  7. if err := f.SaveAs("macros.xlsm"); err !=nil{
  8. fmt.Println(err)
  9. }

Excel 日期时间转换

  1. func ExcelDateToTime(excelDate float64, use1904Format bool)(time.Time, error)

ExcelDateToTime 将 Excel 中以 float 类型表示的日期转换为 time.Time 类型。

字符集转码器

  1. func (f *File)CharsetTranscoder(fn charsetTranscoderFn)*File

CharsetTranscoder 为非 UTF-8 编码的电子表格文档设置用户提供指定自定义编码转换器支持。