筛选

您可以将某些筛选应用于数据透视表，以便在隐藏其余数据的同时仅查看所需信息。

行和列字段筛选

当需要筛选行或列的数据时，您可以应用行和列字段筛选。下图显示了应用于数据透视表的筛选，以仅显示东部地区的数量。

以下示例代码显示了如何筛选 Region 列以仅显示东部地区的数据。

// 添加筛选字段
myPivotTable.add("OrderDate", "OrderDate", GC.Spread.Pivot.PivotTableFieldType.filterField);
let itemList = ["East"];
myPivotTable.labelFilter("Region", { textItem: { list: itemList, isAll: false } });

值筛选

值筛选可用于根据汇总值（如总和、计数、最大值、最小值、平均值等）筛选数据透视表中基于值的字段。下图显示了应用于数据透视表的值筛选，以显示值大于 2000 的类别列的“数量总和”。

以下示例代码显示了如何应用值筛选来显示大于 2000 的“数量总和”。

// 添加筛选字段
myPivotTable.add("OrderDate", "OrderDate", GC.Spread.Pivot.PivotTableFieldType.filterField);
// 使用 FilterInfo 对大于 2000 的“数量总和”应用值筛选
let valueFilter = { condition: { conType: GC.Pivot.PivotConditionType.value, val: [2000], operator: 2 }, conditionByName: "Sum of quantity" };
myPivotTable.valueFilter("Category", valueFilter);

标签筛选

标签筛选可用于筛选行标签项。它根据要筛选的字段的数据类型提供不同的选项。例如，对于字符串或数字数据类型，提供的选项是等于、不等于、开始于、包含、大于等。而对于日期数据类型，提供的选项是之前、之后、明天、下周等。以下示例演示如何将标签筛选应用于“区域”列字段以显示以“S”开头的城市。

以下示例代码显示了如何为以“S”开头的城市应用标签筛选。

// 添加筛选字段
myPivotTable.add("OrderDate", "OrderDate", GC.Spread.Pivot.PivotTableFieldType.filterField);
//  对以“S”开头的“城市”名称应用标签筛选，使用 FilterInfo
let labelFilter = { condition: { conType: GC.Pivot.PivotConditionType.caption, val: 'S', operator: 2 } };
myPivotTable.labelFilter("City", labelFilter);

您还可以使用手动筛选代替为标签筛选定义条件。下图显示了应用于显示“泽西”和“西雅图”城市数据的手动筛选。

以下代码示例显示了如何应用手动筛选。

// 添加手动筛选
let parent = { textItem: { list: ["Jersey", "Seattle"], isAll: false } };
myPivotTable.labelFilter("City", parent);

您还可以通过将allowMultipleFiltersPerField选项设置为 true来选择同时应用手动和基于条件的标签筛选。以下示例演示如何在数据透视表中应用多个筛选。

以下示例显示如何在数据透视表中应用多个筛选。

myPivotTable.options.allowMultipleFiltersPerField = true;
// 当设置allowMultipleFiltersPerField 时，两个筛选即都生效
var labelFilter = {
    textItem: { list: ["Jersey", "San Francisco"], isAll: false },
    condition: { conType: GC.Pivot.PivotConditionType.caption, operator: GC.Pivot.PivotCaptionFilterOperator.beginsWith, val: 'S' }
};
myPivotTable.labelFilter("City", labelFilter);

日期类型筛选

日期类型筛选可用于指定应用于数据透视表的日期类型项目的标准。下图显示了应用于数据透视表以显示季度数据的日期类型筛选。

以下示例代码显示了如何应用日期类型筛选。

let groupInfo = {
     originFieldName: "OrderDate",
     dateGroups: [
         { by: GC.Pivot.DateGroupType.quarters },
         { by: GC.Pivot.DateGroupType.years }]
 };
 myPivotTable.group(groupInfo);
 myPivotTable.add("OrderDate", "Qtr", GC.Spread.Pivot.PivotTableFieldType.columnField);
//  使用 FilterInfo 应用标签筛选
 let labelFilter = { condition: { conType: GC.Pivot.PivotConditionType.date, val: [], operator: GC.Pivot.PivotDateFilterOperator.Q1 } };
 myPivotTable.labelFilter("Qtr", labelFilter);

您还可以在日期筛选中应用以下内置日期：:

• Quarter-to-Date (QTD): 从当前季度开始到当前日期结束的期间。
• Month-to-Date (MTD): 从当前月度开始到当前日期结束的期间。
• Year-to-Date (YTD): 从当前年度开始到当前日期结束的期间。

除了上述选项，您还可以通过将 isParallel属性设置为 true 来使用并行日期筛选。 并行日期筛选允许您获取与实际期间相对应的前一个或即将到来的日期（取决于数据透视表中的数据）中的相同期间。 例如，假设今天是 2021 年 11 月 23 日，数据透视表包含 2021 年 9 月 1 日到 2021 年 12 月 31 日的数据。

Month to Date:

• 2021 年 11 月 1 日 - 2021 年 11 月 23 日

并行>Month to Date筛选:

• 2021 年 9 月 1 日 - 2021 年 9 月 23 日
• 2021 年 10 月 1 日 - 2021 年 10 月 23 日
• 2021 年 11 月 1 日 - 2021 年 11 月 23 日
• 2021 年 12 月 1 日 - 2021 年 12 月 23 日

以下示例代码显示了如何应用dateToDate筛选.

function DateToDateFilter() {
    var condition = {
        conType: GC.Pivot.PivotConditionType.month,
        operator: GC.Pivot.PivotDateFilterOperator.dateToDate,
        val: [new Date(2021, 7, 15), new Date(2022, 6, 20)],
        isParallel: false,
        isDynamicEndDate: true,
        by: GC.Pivot.PivotAdvancedDateFilterBy.month
    };
    var filterInfo = {
        condition
    };
    myPivotTable.labelFilter("OrderDate", filterInfo);

}

创建筛选信息

通过创建筛选信息来应用上述筛选。下表描述了可用于创建筛选信息的条件：

隐藏筛选按钮

您可以使用showFilter选项隐藏数据透视表中的筛选按钮。

以下示例代码显示了如何隐藏筛选按钮。

// 将 showFilter 设置为 false
myPivotTable.options.showFilter = false;

筛选对话框

您可以通过单击数据透视表中的任何行或列标题来使用“筛选”对话框。它提供了各种排序和筛选选项。您还可以从筛选对话框的列表框中选择所需的项目。下图显示了筛选对话框。

筛选对话框还提供了一个搜索框，可让您方便地应用筛选设置。

您可以输入不区分大小写的搜索词，还可以使用“Add current selection to filter”选项将所选项目与以前的筛选信息合并。如果未选中，则当前选择将覆盖先前的筛选信息。

它还允许您使用正则表达式字符进行搜索，例如'?', '*' 和'~'下图所示其他符号.