数据透视表

《Excelize 权威指南》图书出版，网上购买方式：人民邮电出版社 | 异步社区 | 天猫 | 京东 | 当当 | 亚马逊 | 微店 | 抖音

数据透视表是一种交互式的表，是计算、汇总和分析数据的强大工具，可助你了解数据中的对比情况、模式和趋势。

PivotTableOptions 定义了数据透视表的属性。

type PivotTableOptions struct {
    DataRange           string
    PivotTableRange     string
    Name                string
    Rows                []PivotTableField
    Columns             []PivotTableField
    Data                []PivotTableField
    Filter              []PivotTableField
    RowGrandTotals      bool
    ColGrandTotals      bool
    ShowDrill           bool
    UseAutoFormatting   bool
    PageOverThenDown    bool
    MergeItem           bool
    ClassicLayout       bool
    CompactData         bool
    ShowError           bool
    ShowRowHeaders      bool
    ShowColHeaders      bool
    ShowRowStripes      bool
    ShowColStripes      bool
    ShowLastColumn      bool
    FieldPrintTitles    bool
    ItemPrintTitles     bool
    PivotTableStyleName string
    // 还包含其他已过滤或未导出的字段
}

PivotTableStyleName: 支持的数据透视表样式:

PivotStyleLight1 - PivotStyleLight28
PivotStyleMedium1 - PivotStyleMedium28
PivotStyleDark1 - PivotStyleDark28

PivotTableShowValuesAsType 定义了数据透视表数据字段中"值显示方式"的计算类型。

type PivotTableShowValuesAsType byte

PivotTableShowValuesAsType 定义了数据透视表数据字段中"值显示方式"的计算类型枚举。

const (
    PivotTableShowValuesAsNoCalculation PivotTableShowValuesAsType = iota
    PivotTableShowValuesAsPercentOfGrandTotal
    PivotTableShowValuesAsPercentOfColumnTotal
    PivotTableShowValuesAsPercentOfRowTotal
    PivotTableShowValuesAsPercentOf
    PivotTableShowValuesAsPercentOfParentRowTotal
    PivotTableShowValuesAsPercentOfParentColumnTotal
    PivotTableShowValuesAsPercentOfParentTotal
    PivotTableShowValuesAsDifferenceFrom
    PivotTableShowValuesAsPercentDifferenceFrom
    PivotTableShowValuesAsRunningTotalIn
    PivotTableShowValuesAsPercentRunningTotalIn
    PivotTableShowValuesAsRankSmallestToLargest
    PivotTableShowValuesAsRankLargestToSmallest
    PivotTableShowValuesAsIndex
)

PivotTableShowValuesAs 定义了数据透视表数据字段中"值显示方式"的设置。

type PivotTableShowValuesAs struct {
    Type      PivotTableShowValuesAsType
    BaseField string
    BaseItem  string
}

PivotTableField 定义了数据透视表的字段属性。

type PivotTableField struct {
    Compact         bool
    Data            string
    Name            string
    Outline         bool
    ShowAll         bool
    InsertBlankRow  bool
    Subtotal        string
    DefaultSubtotal bool
    NumFmt          int
    SelectedItems   []string
    ShowValuesAs    PivotTableShowValuesAs
}

Subtotal 指定适用于数值字段的聚合函数。默认值为 Sum。该属性的可选值如下：

Name 用以指定数值字段的名称，最大长度为 255 个字符，超出部分的字符将不会被保留。

SelectedItems 用以指定透视表字段中的默认选中项，选中项必须是该字段所引用的单元格范围内的值。

ShowValuesAs 用以指定数据透视表数据字段中"值显示方式"的计算类型。ShowValuesAs 的 Type 字段可选値如下：

请注意，ShowValuesAs 的基准字段和基准项设置仅对部分计算类型是必需的。需要基准字段设置的计算类型如下：

需要基准项设置的计算类型如下：

创建数据透视表

func (f *File) AddPivotTable(opts *PivotTableOptions) error

根据给定的属性创建数据透视表。

例如，以 Sheet1!G4:M30 作为数据源，在 Sheet1!A1:E31 选区创建数据透视表，并按照销售数据汇总求和:

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    // 在工作表中添加数据
    month := []string{"1月", "2月", "3月", "4月", "5月", "6月",
        "7月", "8月", "9月", "10月", "11月", "12月"}
    year := []int{2017, 2018, 2019}
    types := []string{"肉类", "乳制品", "饮料", "农产品"}
    revenue := []int{3217, 4512, 3891, 4738, 3054, 4265, 3643, 4901, 3378, 4126}
    region := []string{"东部", "西部", "北部", "南部"}
    if err := f.SetSheetRow(
        "Sheet1", "A1", &[]string{"月份", "年份", "类型", "收入", "地区"},
    ); err != nil {
        fmt.Println(err)
        return
    }
    for row := 2; row < 32; row++ {
        f.SetCellValue("Sheet1", fmt.Sprintf("A%d", row), month[(row-2)%len(month)])
        f.SetCellValue("Sheet1", fmt.Sprintf("B%d", row), year[(row-2)%len(year)])
        f.SetCellValue("Sheet1", fmt.Sprintf("C%d", row), types[(row-2)%len(types)])
        f.SetCellValue("Sheet1", fmt.Sprintf("D%d", row), revenue[(row-2)%len(revenue)])
        f.SetCellValue("Sheet1", fmt.Sprintf("E%d", row), region[(row-2)%len(region)])
    }
    if err := f.AddPivotTable(&excelize.PivotTableOptions{
        DataRange:       "Sheet1!A1:E31",
        PivotTableRange: "Sheet1!G4:M30",
        Rows: []excelize.PivotTableField{
            {Data: "月份", DefaultSubtotal: true}, {Data: "年份"},
        },
        Filter: []excelize.PivotTableField{
            {Data: "地区"},
        },
        Columns: []excelize.PivotTableField{
            {Data: "类型", DefaultSubtotal: true},
        },
        Data: []excelize.PivotTableField{
            {Data: "收入", Name: "合计", Subtotal: "Sum"},
        },
        RowGrandTotals: true,
        ColGrandTotals: true,
        ShowDrill:      true,
        ShowRowHeaders: true,
        ShowColHeaders: true,
        ShowLastColumn: true,
    }); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

获取数据透视表

func (f *File) GetPivotTables(sheet string) ([]PivotTableOptions, error)

根据给定的工作表名称返回该工作表中的全部数据透视表属性。

删除数据透视表

func (f *File) DeletePivotTable(sheet, name string) error

根据给定的工作表名称和数据透视表名称删除指定数据透视表。请注意，该函数不会清除数据透视表区域内单元格的值。