Class PivotTable

PivotTable

存取及修改資料透視表。

方法

方法傳回類型簡短說明
addCalculatedPivotValue(name, formula)PivotValue使用指定的 name，在資料透視表中建立新的資料透視表值 (以指定 formula 計算)。
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)

使用指定的 name，在資料透視表中建立新的資料透視表值 (以指定 formula 計算)。

參數

名稱類型說明
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