Class PivotValue

数据透视值

访问和修改数据透视表中的值组。

方法

方法	返回类型	简介
getDisplayType()	PivotValueDisplayType	返回显示类型，用于描述此数据透视值目前在表格中的显示方式。
getFormula()	String	返回用于计算此值的公式。
getPivotTable()	PivotTable	返回此值所属的 PivotTable。
getSourceDataColumn()	Integer	返回数据透视值汇总的源数据列的编号。
getSourceDataSourceColumn()	DataSourceColumn	返回数据透视值汇总的数据源列。
getSummarizedBy()	PivotTableSummarizeFunction	返回此组的汇总函数。
remove()	void	从数据透视表中移除此值。
setDisplayName(name)	PivotValue	在数据透视表中设置此值的显示名称。
setFormula(formula)	PivotValue	设置用于计算此值的公式。
showAs(displayType)	PivotValue	在数据透视表中将此值显示为另一个值的函数。
summarizeBy(summarizeFunction)	PivotValue	设置汇总函数。

详细文档

getDisplayType()

返回显示类型，用于描述此数据透视值目前在表格中的显示方式。

返回

PivotValueDisplayType - 此数据透视值的显示类型

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getFormula()

返回用于计算此值的公式。如果此值不是计算字段，此方法会返回 null。

返回

String - 用于链接的数据透视值

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getPivotTable()

返回此值所属的 PivotTable。

返回

PivotTable - 此值所属的数据透视表

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getSourceDataColumn()

返回数据透视值汇总的源数据列的数量。此编号从 1 开始，如果此组汇总了电子表格“A”列中的来源数据，此方法会返回 1。

返回

Integer - 来源数据列编号。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getSourceDataSourceColumn()

返回数据透视值汇总的数据源列。如果数据透视表不是 {DataSourcePivotTableApi}，则返回 null。

返回

DataSourceColumn - 数据透视值汇总的源数据源列。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

getSummarizedBy()

返回此组的汇总函数。

返回

PivotTableSummarizeFunction - 组的汇总函数

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

remove()

从数据透视表中移除此值。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setDisplayName(name)

在数据透视表中设置此值的显示名称。

参数

名称	类型	说明
name	String	要设置的显示名称。

返回

PivotValue - 用于链接的数据透视值

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

setFormula(formula)

设置用于计算此值的公式。如果此值不是计算字段，则此方法会导致错误。

参数

名称	类型	说明
formula	String	用于计算此值的公式。

返回

PivotValue - 用于链接的数据透视值

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

showAs(displayType)

在数据透视表中将此值显示为另一个值的函数。

参数

名称	类型	说明
displayType	PivotValueDisplayType	显示值的方式。

返回

PivotValue - 用于链接的数据透视值

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

summarizeBy(summarizeFunction)

设置汇总函数。

参数

名称	类型	说明
summarizeFunction	PivotTableSummarizeFunction	用于汇总此值的来源数据列中数据的函数。

返回

PivotValue - 用于链接的数据透视值

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets