Excelize库中设置数据透视表数值格式的方法

Excelize是一个强大的Go语言库，用于处理Excel文件。在实际应用中，我们经常需要创建数据透视表并对其中的数值进行格式化显示。本文将详细介绍如何使用Excelize库设置数据透视表中数值字段的显示格式。

问题背景

在创建数据透视表时，原始数据可能是百分比形式（如10%、20%等），但在数据透视表中默认会显示为小数形式（如0.1、0.2）。这不符合用户的显示需求，需要将数据透视表中的数值格式设置为百分比显示。

解决方案

最新版本的Excelize库在PivotTableField结构中新增了NumFmt字段，用于设置数据透视表数值字段的显示格式。通过这个字段，我们可以指定内置的数字格式代码。

实现方法

以下是完整的实现示例代码：

package main

import (
    "fmt"
    "github.com/xuri/excelize/v2"
)

func main() {
    // 创建新Excel文件
    f := excelize.NewFile()
    defer f.Close()
    
    // 准备数据并写入Sheet1
    data := [][]interface{}{
        {"Val", "Cat"},  // 表头
        {0.1, "eth"},    // 数据行
        {0.2, "eth"},
        {0.3, "btc"},
        {0.4, "btc"},
    }
    
    for rowIdx, row := range data {
        cell, _ := excelize.CoordinatesToCellName(1, rowIdx+1)
        f.SetSheetRow("Sheet1", cell, &row)
    }
    
    // 创建数据透视表
    pivotOpts := excelize.PivotTableOptions{
        DataRange:       "Sheet1!A1:B5",    // 数据源范围
        PivotTableRange: "Sheet1!G3:H6",    // 透视表位置
        Rows: []excelize.PivotTableField{
            {Data: "Cat"},  // 行字段
        },
        Data: []excelize.PivotTableField{
            {
                Data:     "Val",      // 数值字段
                Name:     "Sum of Val", // 显示名称
                Subtotal: "Sum",      // 汇总方式
                NumFmt:   9,          // 百分比格式
            },
        },
        RowGrandTotals:  true,  // 显示行总计
        ColGrandTotals:  true,  // 显示列总计
        ShowRowHeaders:  true,  // 显示行标题
        ShowColHeaders:  true,  // 显示列标题
        ShowLastColumn:  true,  // 显示最后一列
    }
    
    if err := f.AddPivotTable(&pivotOpts); err != nil {
        fmt.Println(err)
        return
    }
    
    // 保存文件
    if err := f.SaveAs("PivotTableWithFormat.xlsx"); err != nil {
        fmt.Println(err)
    }
}

关键参数说明

1. NumFmt字段：这是新增的核心字段，用于设置数值格式。数字9代表百分比格式。

2. 常用数字格式代码：

   • 0: 常规格式
   • 1: 整数
   • 2: 小数
   • 3: 千分位
   • 4: 货币
   • 9: 百分比
   • 10: 科学计数法

3. 其他重要参数：

   • Data: 指定要汇总的数值字段
   • Subtotal: 指定汇总方式，如"Sum"(求和)、"Average"(平均)等
   • Name: 指定在数据透视表中显示的字段名称

实际应用建议

1. 数据准备：确保原始数据是数值类型，百分比数据应以小数形式存储（如10%存储为0.1）。

2. 格式选择：根据业务需求选择合适的数字格式，财务报表常用货币格式，统计分析常用百分比格式。

3. 性能考虑：处理大数据量时，建议先准备好所有数据再一次性写入，避免频繁操作影响性能。

4. 错误处理：务必检查AddPivotTable和SaveAs等方法的返回错误，确保操作成功。

通过这种方法，我们可以轻松创建出符合业务需求的数据透视表，并以恰当的格式展示数据，提升报表的可读性和专业性。