Class PivotTable

資料透視表

存取及修改資料透視表。

方法

方法傳回類型簡短說明
addCalculatedPivotValue(name, formula)PivotValue在資料透視表中建立新的透視值，該值是根據指定的 formula 和指定的 name 計算而得。
addColumnGroup(sourceDataColumn)PivotGroup在資料透視表中定義新的資料透視欄群組。
addFilter(sourceDataColumn, filterCriteria)PivotFilter為資料透視表建立新的資料透視篩選器。
addPivotValue(sourceDataColumn, summarizeFunction)PivotValue使用指定的 summarizeFunction，在資料透視表中定義新的資料透視值。
addRowGroup(sourceDataColumn)PivotGroup在資料透視表中定義新的資料透視列群組。
asDataSourcePivotTable()DataSourcePivotTable如果資料透視表已連結至 DataSource，則會傳回資料透視表做為資料來源資料透視表；如果未連結，則會傳回 null。
getAnchorCell()Range傳回 Range，代表資料透視表繫結的儲存格。
getColumnGroups()PivotGroup[]傳回這個資料透視表中資料欄群組的排序清單。
getFilters()PivotFilter[]傳回這個樞紐分析表中的篩選器排序清單。
getPivotValues()PivotValue[]傳回這個資料透視表中資料透視值的排序清單。
getRowGroups()PivotGroup[]傳回這個資料透視表中列群組的排序清單。
getSourceDataRange()Range傳回用於建立資料透視表的來源資料範圍。
getValuesDisplayOrientation()Dimension傳回值是以資料列或資料欄的形式顯示。
remove()void刪除這個資料透視表。
setValuesDisplayOrientation(dimension)PivotTable將資料透視表的版面配置設為以欄或列的形式顯示值。

內容詳盡的說明文件

addCalculatedPivotValue(name, formula)

在資料透視表中建立新的透視值，該值是根據指定的 formula 和指定的 name 計算而得。

參數

名稱類型說明
nameString這個計算樞紐值的名稱。
formulaString用來計算這個值的公式。

回攻員

PivotValue：新建立的 PivotValue

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

addColumnGroup(sourceDataColumn)

在資料透視表中定義新的樞紐資料欄群組。指定的 sourceDataColumn 會指出這個分組所依據的來源資料欄。

參數

名稱類型說明
sourceDataColumnInteger這個群組匯總的欄數。這個索引代表試算表中資料欄的絕對編號，1 代表資料欄「A」，2 代表資料欄 B，以此類推。

回攻員

PivotGroup：新建立的 PivotGroup

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

addFilter(sourceDataColumn, filterCriteria)

為資料透視表建立新的資料透視篩選器。指定的 sourceDataColumn 會指出這個篩選器要處理的來源資料欄。

參數

名稱類型說明
sourceDataColumnInteger這個群組匯總的欄數。這個索引代表試算表中資料欄的絕對編號，1 代表資料欄「A」，2 代表資料欄 B，以此類推。
filterCriteriaFilterCriteria用於篩選的篩選條件。

回攻員

PivotFilter：新建立的 PivotFilter

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

addPivotValue(sourceDataColumn, summarizeFunction)

使用指定的 summarizeFunction，在資料透視表中定義新的資料透視值。指定的 sourceDataColumn 會指出這個值所依據的來源資料欄。

參數

名稱類型說明
sourceDataColumnInteger這個群組匯總的欄數。這個索引代表試算表中資料欄的絕對編號，1 代表資料欄「A」，2 代表資料欄 B，以此類推。
summarizeFunctionPivotTableSummarizeFunction

回攻員

PivotValue：新建立的 PivotValue

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

addRowGroup(sourceDataColumn)

在資料透視表中定義新的資料透視列群組。指定的 sourceDataColumn 會指出這個分組所依據的來源資料欄。

參數

名稱類型說明
sourceDataColumnInteger這個群組匯總的欄數。這個索引代表試算表中資料欄的絕對編號，1 代表資料欄「A」，2 代表資料欄 B，以此類推。

回攻員

PivotGroup：新建立的 PivotGroup

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

asDataSourcePivotTable()

如果資料透視表已連結至 DataSource，則會傳回資料透視表做為資料來源資料透視表；如果未連結，則會傳回 null。

回攻員

DataSourcePivotTable：資料來源資料透視表。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

getAnchorCell()

傳回 Range，代表資料透視表繫結的儲存格。

回攻員

Range：這個資料透視表的錨定儲存格

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

getColumnGroups()

傳回這個資料透視表中資料欄群組的排序清單。

回攻員

PivotGroup[]：這個資料透視表中的欄群組

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

getFilters()

傳回這個樞紐分析表中的篩選器排序清單。

回攻員

PivotFilter[]：這個資料透視表中的篩選器

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

getPivotValues()

傳回這個資料透視表中資料透視值的排序清單。

回攻員

PivotValue[]：這個資料透視表中的資料透視值

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

getRowGroups()

傳回這個資料透視表中列群組的排序清單。

回攻員

PivotGroup[]：這個資料透視表中的列群組

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

getSourceDataRange()

傳回用於建立資料透視表的來源資料範圍。

回攻員

Range：這個資料透視表的來源資料範圍。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

getValuesDisplayOrientation()

傳回值是以資料列或資料欄的形式顯示。

回攻員

Dimension：值是以列或欄的形式顯示

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

  • 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

setValuesDisplayOrientation(dimension)

將資料透視表的版面配置設為以欄或列的形式顯示值。

參數

名稱類型說明
dimensionDimension指示樞紐值顯示方式的維度。

回攻員

PivotTable：用於鏈結的資料透視表

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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