访问和修改数据透视表。
方法
方法 | 返回类型 | 简介 |
---|---|---|
add | Pivot | 在数据透视表中创建一个新的透视值,该值是使用指定的 name 从指定的 formula 计算得出的。 |
add | Pivot | 在数据透视表中定义新的透视列分组。 |
add | Pivot | 为数据透视表创建新的数据透视过滤器。 |
add | Pivot | 使用指定的 summarize 在数据透视表中定义新的透视值。 |
add | Pivot | 在数据透视表中定义新的透视表行分组。 |
as | Data | 如果数据透视表已关联到 Data ,则将其作为数据源数据透视表返回;否则,返回 null 。 |
get | Range | 返回表示此数据透视表锚定的单元格的 Range 。 |
get | Pivot | 返回此数据透视表中列组的有序列表。 |
get | Pivot | 返回此数据透视表中过滤条件的有序列表。 |
get | Pivot | 返回此数据透视表中数据透视值的有序列表。 |
get | Pivot | 返回此数据透视表中行组的有序列表。 |
get | Range | 返回用于构建数据透视表的源数据范围。 |
get | Dimension | 返回值是显示为行还是列。 |
remove() | void | 删除此数据透视表。 |
set | Pivot | 设置此数据透视表的布局,以将值显示为列或行。 |
详细文档
add Calculated Pivot Value(name, formula)
在数据透视表中创建一个新的透视值,该值是使用指定的 name
从指定的 formula
计算得出的。
参数
名称 | 类型 | 说明 |
---|---|---|
name | String | 此计算汇总值的名称。 |
formula | String | 用于计算此值的公式。 |
返回
Pivot
- 新创建的 Pivot
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Column Group(sourceDataColumn)
在数据透视表中定义新的透视列分组。指定的 source
表示此分组所依据的源数据中的列。
参数
名称 | 类型 | 说明 |
---|---|---|
source | Integer | 此组汇总的列的编号。此编号表示电子表格中列的绝对编号;1 表示列“A”,2 表示列 B,依此类推。 |
返回
Pivot
- 新创建的 Pivot
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Filter(sourceDataColumn, filterCriteria)
为数据透视表创建新的数据透视过滤器。指定的 source
表示此过滤器要对源数据中的哪个列进行操作。
参数
名称 | 类型 | 说明 |
---|---|---|
source | Integer | 此组汇总的列的编号。此编号表示电子表格中列的绝对编号;1 表示列“A”,2 表示列 B,依此类推。 |
filter | Filter | 用于执行过滤的过滤条件。 |
返回
Pivot
- 新创建的 Pivot
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Pivot Value(sourceDataColumn, summarizeFunction)
使用指定的 summarize
在数据透视表中定义新的透视值。指定的 source
表示此值基于的来源数据中的列。
参数
名称 | 类型 | 说明 |
---|---|---|
source | Integer | 此组汇总的列的编号。此编号表示电子表格中列的绝对编号;1 表示列“A”,2 表示列 B,依此类推。 |
summarize | Pivot |
返回
Pivot
- 新创建的 Pivot
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Row Group(sourceDataColumn)
在数据透视表中定义新的透视表行分组。指定的 source
表示此分组所依据的源数据中的列。
参数
名称 | 类型 | 说明 |
---|---|---|
source | Integer | 此组汇总的列的编号。此编号表示电子表格中列的绝对编号;1 表示列“A”,2 表示列 B,依此类推。 |
返回
Pivot
- 新创建的 Pivot
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
as Data Source Pivot Table()
如果数据透视表已关联到 Data
,则将其作为数据源数据透视表返回;否则,返回 null
。
返回
Data
- 数据源数据透视表。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Anchor Cell()
get Column Groups()
返回此数据透视表中列组的有序列表。
返回
Pivot
- 此数据透视表中的列组
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Filters()
返回此数据透视表中过滤条件的有序列表。
返回
Pivot
- 此数据透视表中的过滤条件
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Pivot Values()
返回此数据透视表中数据透视值的有序列表。
返回
Pivot
- 此数据透视表中的数据透视值
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Row Groups()
返回此数据透视表中行组的有序列表。
返回
Pivot
- 此数据透视表中的行组
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Source Data Range()
get Values Display Orientation()
remove()
删除此数据透视表。对此数据透视表执行进一步操作会导致错误。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Values Display Orientation(dimension)
设置此数据透视表的布局,以将值显示为列或行。
参数
名称 | 类型 | 说明 |
---|---|---|
dimension | Dimension | 用于指示如何显示数据透视表值的维度。 |
返回
Pivot
- 用于串联的数据透视表
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets