概述
本 Demo 展示了如何在透视表中对日期字段进行分组，实现按年、季度、月、日等不同时间维度汇总数据。Demo 提供了交互式界面，用户可以动态切换分组方式，实时查看不同时间维度的数据统计结果。
实现思路
创建数据源工作表，加载销售数据（包含日期、地区、城市、金额等字段）
创建透视表并添加基础字段（地区、城市作为列字段）
对日期字段应用初始分组（按年分组）
绑定单选框事件，根据用户选择动态切换分组方式
支持按天分组时自定义分组间隔（如每 7 天一组）
代码解析
创建透视表并设置日期分组
这段代码创建透视表后，通过 group 方法对日期字段进行分组。groupInfo 对象包含原始字段名 originFieldName 和分组配置数组 dateGroups，其中 by 属性使用 GC.Pivot.DateGroupType.years 枚举指定按年分组。
动态切换分组方式
这段代码根据用户选择动态构建 groupInfo 对象。当按天分组时，可以通过 groupInterval 属性指定分组间隔（如每 7 天一组）。分组完成后，使用 add 方法将分组后的字段添加到透视表的行区域。
运行效果
透视表默认按年分组显示数据，展示各年份的总销售额
点击"按季度分组"单选框，透视表切换为按季度显示数据
点击"按月分组"单选框，透视表切换为按月显示数据
点击"按天分组"单选框后，可在输入框中设置分组间隔（如输入 7 表示每 7 天一组）
每次切换分组方式后，透视表会自动更新列宽以适应新的数据布局
API 参考
pivotTable.group(groupInfo)
对透视表字段进行分组。
groupInfo.originFieldName: 原始字段名（字符串）
groupInfo.dateGroups: 日期分组配置数组，每个元素包含：
by: 分组类型，使用 GC.Pivot.DateGroupType 枚举
groupInterval: 分组间隔（可选，用于天分组时指定间隔天数）
start: 开始日期（可选）
end: 结束日期（可选）
GC.Pivot.DateGroupType 枚举
支持的日期分组类型：
years - 年
quarters - 季度
months - 月
days - 日
hours - 小时
minutes - 分钟
seconds - 秒
pivotTable.add(sourceName, displayName, area, subtotal?)
向透视表添加字段。
sourceName: 源字段名（分组后的字段名格式为"分组类型 (原字段名)"）
displayName: 显示名称
area: 字段区域，使用 GC.Spread.Pivot.PivotTableFieldType 枚举
subtotal: 小计类型（可选），如 GC.Pivot.SubtotalType.sum
window.onload = function () {
let spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), {sheetCount: 2});
initSpread(spread);
};
function initSpread(spread) {
spread.suspendPaint();
let sheet1 = spread.getSheet(0);
let sheet2 = spread.getSheet(1);
let tableName = getSource(sheet2, pivotSales);
let pivotTable = addPivotTable(sheet1, tableName);
bindEvent(pivotTable,spread);
spread.resumePaint();
}
function getSource(sheet, tableSource){
sheet.name("DataSource");
sheet.setRowCount(700);
sheet.setColumnWidth(5, 120);
sheet.getCell(-1, 5).formatter("YYYY-mm-DD");
sheet.getRange(-1,4,0,1).formatter("$ #,##0");
let table = sheet.tables.add('table', 0, 0, 642, 6);
table.style(GC.Spread.Sheets.Tables.TableThemes["none"]);
sheet.setArray(0, 0, tableSource);
return table.name();
}
function addPivotTable(sheet, source){
sheet.suspendPaint();
sheet.name("PivotTable");
sheet.setRowCount(10000);
sheet.setColumnCount(500);
let pivotTable = sheet.pivotTables.add("PivotTable", source, 1, 1, GC.Spread.Pivot.PivotTableLayoutType.outline, GC.Spread.Pivot.PivotTableThemes.medium3);
pivotTable.suspendLayout();
pivotTable.add("region", "Region", GC.Spread.Pivot.PivotTableFieldType.columnField);
pivotTable.add("city", "City", GC.Spread.Pivot.PivotTableFieldType.columnField);
let groupInfo = { originFieldName: "date", dateGroups: [
{ by: GC.Pivot.DateGroupType.years },
] };
pivotTable.group(groupInfo);
pivotTable.add("年 (date)", "Years (date)", GC.Spread.Pivot.PivotTableFieldType.rowField);
pivotTable.add("amount", "Amount", GC.Spread.Pivot.PivotTableFieldType.valueField, GC.Pivot.SubtotalType.sum);
pivotTable.resumeLayout();
sheet.resumePaint();
pivotTable.autoFitColumn();
return pivotTable;
}
function bindEvent(pivotTable, spread){
const radios = document.querySelectorAll('input[name="dateGroup"]');
const groupIntervalEle = document.querySelector('input[id="numInput"]');
radios.forEach(radio => {
radio.addEventListener('change', (e) => {
spread.suspendPaint();
const value = e.target.value;
let groupInfo = { originFieldName: "date", dateGroups: [] }, fieldName;
groupIntervalEle.style.display = "none";
switch (value) {
case "0":
groupInfo.dateGroups.push({ by: GC.Pivot.DateGroupType.years });
fieldName = "年 (date)";
break;
case "1":
groupInfo.dateGroups.push({ by: GC.Pivot.DateGroupType.quarters });
fieldName = "季度 (date)";
break;
case "2":
groupInfo.dateGroups.push({ by: GC.Pivot.DateGroupType.months });
fieldName = "月 (date)";
break;
case "3":
groupIntervalEle.style.display = "inline-block";
groupInfo.dateGroups.push({ by: GC.Pivot.DateGroupType.days, groupInterval: +groupIntervalEle.value || 1});
fieldName = "日 (date)";
break;
default:
groupInfo.dateGroups.push({ by: GC.Pivot.DateGroupType.years });
fieldName = "年 (date)";
break;
}
pivotTable.suspendLayout();
pivotTable.group(groupInfo);
console.log(groupInfo)
pivotTable.add(fieldName, fieldName, GC.Spread.Pivot.PivotTableFieldType.rowField);
pivotTable.resumeLayout();
spread.resumePaint();
pivotTable.autoFitColumn();
});
});
groupIntervalEle.addEventListener('change', (e) => {
const groupDaysEle = document.querySelector('input[id="toggle-date-group-days"]');
if (groupDaysEle.checked) {
spread.suspendPaint();
let groupInfo = { originFieldName: "date", dateGroups: [
{ by: GC.Pivot.DateGroupType.days, groupInterval: +groupIntervalEle.value || 1}
] };
pivotTable.suspendLayout();
pivotTable.group(groupInfo);
console.log(groupInfo)
pivotTable.add("日 (date)", "Days (date)", GC.Spread.Pivot.PivotTableFieldType.rowField);
pivotTable.resumeLayout();
spread.resumePaint();
pivotTable.autoFitColumn();
}
})
}
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="spreadjs culture" content="zh-cn" />
<link rel="stylesheet" type="text/css"
href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/dist/gc.spread.sheets.all.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-shapes/dist/gc.spread.sheets.shapes.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-pivot-addon/dist/gc.spread.pivot.pivottables.min.js"
type="text/javascript"></script>
<script
src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.min.js"
type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script>
<script src="$DEMOROOT$/spread/source/data/pivotSales.js" type="text/javascript"></script>
<script src="app.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="styles.css">
</head>
<body>
<div class="sample-tutorial">
<div id="ss" class="sample-spreadsheets"></div>
<div class="options-container">
<div class="group">
<label><b>分组字段</b></label>
</div>
<hr />
<div class="group">
<div class="date-group-items">
<input type="radio" name="dateGroup" id="toggle-date-group-years" checked="checked"
value="0" /><label for="toggle-date-group-years">按年分组</label>
</div>
<div class="date-group-items">
<input type="radio" name="dateGroup" id="toggle-date-group-quarters" value="1" /><label
for="toggle-date-group-quarters">按季度分组</label>
</div>
<div class="date-group-items">
<input type="radio" name="dateGroup" id="toggle-date-group-months" value="2" /><label
for="toggle-date-group-months">按月分组</label>
</div>
<div class="date-group-items">
<input type="radio" name="dateGroup" id="toggle-date-group-days" value="3" /><label
for="toggle-date-group-days">按天分组</label>
<input type="number" id="numInput" class="date-group-interval" min="1" value="1" />
</div>
</div>
</div>
</div>
</body>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: calc(100% - 280px);
height: 100%;
overflow: hidden;
float: left;
}
.options-container {
float: right;
width: 280px;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
overflow: auto;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
.group{
width: 250px;
margin-bottom: 20px;
}
.date-group-items {
margin: 5px;
}
input {
margin-right: 10px;
}
.date-group-interval {
display: none;
outline: none;
width: 50px;
margin-left: 30px;
border: 1px solid #abadb3;
}
