Class PivotGroup

피벗그룹

피벗 테이블 분석 그룹에 액세스하고 수정합니다.

메서드

메서드반환 유형간략한 설명
addManualGroupingRule(groupName, groupMembers)PivotGroup이 피벗 그룹에 수동 그룹화 규칙을 추가합니다.
areLabelsRepeated()Boolean라벨이 반복으로 표시되는지 여부를 반환합니다.
clearGroupingRule()PivotGroup이 피벗 그룹에서 모든 그룹화 규칙을 삭제합니다.
clearSort()PivotGroup이 그룹에 적용된 정렬을 삭제합니다.
getDateTimeGroupingRule()DateTimeGroupingRule피벗 그룹의 날짜 시간 그룹화 규칙을 반환하거나 날짜 시간 그룹화 규칙이 설정되지 않은 경우 null을 반환합니다.
getDimension()Dimension행 또는 열 그룹인지 여부를 반환합니다.
getGroupLimit()PivotGroupLimit피벗 그룹의 피벗 그룹 한도를 반환합니다.
getIndex()Integer현재 그룹 순서에서 이 피벗 그룹의 색인을 반환합니다.
getPivotTable()PivotTable이 그룹이 속한 PivotTable를 반환합니다.
getSourceDataColumn()Integer이 그룹에서 요약하는 소스 데이터 열의 수를 반환합니다.
getSourceDataSourceColumn()DataSourceColumn피벗 그룹이 작동하는 데이터 소스 열을 반환합니다.
hideRepeatedLabels()PivotGroup이 그룹화에서 중복된 라벨을 숨깁니다.
isSortAscending()Boolean정렬이 오름차순이면 true를 반환하고 정렬 순서가 내림차순이면 false를 반환합니다.
moveToIndex(index)PivotGroup이 그룹을 현재 행 또는 열 그룹 목록의 지정된 위치로 이동합니다.
remove()void테이블에서 이 피벗 그룹을 삭제합니다.
removeManualGroupingRule(groupName)PivotGroup지정된 groupName를 사용하여 수동 그룹화 규칙을 삭제합니다.
resetDisplayName()PivotGroup피벗 테이블에서 이 그룹의 표시 이름을 기본값으로 재설정합니다.
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroup피벗 그룹에 날짜 시간 그룹화 규칙을 설정합니다.
setDisplayName(name)PivotGroup피벗 테이블에서 이 그룹의 표시 이름을 설정합니다.
setGroupLimit(countLimit)PivotGroup피벗 그룹의 피벗 그룹 한도를 설정합니다.
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroup이 피벗 그룹의 히스토그램 그룹화 규칙을 설정합니다.
showRepeatedLabels()PivotGroup행 또는 열 그룹화가 두 개 이상인 경우 이 메서드는 후속 그룹의 각 항목에 대해 이 그룹의 라벨을 표시합니다.
showTotals(showTotals)PivotGroup표에 이 피벗 그룹의 총 값을 표시할지 여부를 설정합니다.
sortAscending()PivotGroup정렬 순서를 오름차순으로 설정합니다.
sortBy(value, oppositeGroupValues)PivotGroupoppositeGroupValues의 값에 대해 지정된 PivotValue를 기준으로 이 그룹을 정렬합니다.
sortDescending()PivotGroup정렬 순서를 내림차순으로 설정합니다.
totalsAreShown()Boolean이 피벗 그룹에 현재 총 값이 표시되는지 여부를 반환합니다.

자세한 문서

addManualGroupingRule(groupName, groupMembers)

이 피벗 그룹에 수동 그룹화 규칙을 추가합니다.

매개변수

이름유형설명
groupNameString이 그룹화 규칙의 이름입니다.
groupMembersObject[]이 그룹화 규칙에 포함된 값입니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

areLabelsRepeated()

라벨이 반복으로 표시되는지 여부를 반환합니다.

리턴

Boolean - 라벨이 반복되면 true을 반환하고 그렇지 않으면 false을 반환합니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

clearGroupingRule()

이 피벗 그룹에서 모든 그룹화 규칙을 삭제합니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

clearSort()

이 그룹에 적용된 정렬을 삭제합니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getDateTimeGroupingRule()

피벗 그룹의 날짜 시간 그룹화 규칙을 반환하거나 날짜 시간 그룹화 규칙이 설정되지 않은 경우 null을 반환합니다.

리턴

DateTimeGroupingRule: 날짜 시간 그룹화 규칙입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getDimension()

행 또는 열 그룹인지 여부를 반환합니다.

리턴

Dimension: 이 그룹의 유형을 나타내는 측정기준

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getGroupLimit()

피벗 그룹의 피벗 그룹 한도를 반환합니다. 피벗 그룹 한도가 설정되지 않은 경우 null를 반환합니다.

리턴

PivotGroupLimit: 피벗 그룹 한도입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

getIndex()

현재 그룹 순서에서 이 피벗 그룹의 색인을 반환합니다.

리턴

Integer: 피벗 그룹의 색인

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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

hideRepeatedLabels()

이 그룹화에서 중복된 라벨을 숨깁니다. 라벨이 이미 숨겨져 있으면 아무 일도 일어나지 않습니다. 행 또는 열 그룹이 여러 개 있기 전에 이 메서드가 호출되면 그룹이 추가될 때 중복 라벨이 숨겨집니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

isSortAscending()

정렬이 오름차순이면 true를 반환하고 정렬 순서가 내림차순이면 false를 반환합니다.

리턴

Boolean: 정렬 순서가 오름차순인 경우 true입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

moveToIndex(index)

이 그룹을 현재 행 또는 열 그룹 목록의 지정된 위치로 이동합니다. 이러한 색인은 0부터 시작합니다. 예를 들어 이 그룹을 첫 번째 위치로 이동해야 하는 경우 이 메서드는 0를 사용하여 호출해야 합니다.

매개변수

이름유형설명
indexInteger이 그룹을 이동할 색인입니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

  • 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

removeManualGroupingRule(groupName)

지정된 groupName를 사용하여 수동 그룹화 규칙을 삭제합니다.

매개변수

이름유형설명
groupNameString삭제할 그룹화 규칙의 이름입니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

resetDisplayName()

피벗 테이블에서 이 그룹의 표시 이름을 기본값으로 재설정합니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

setDateTimeGroupingRule(dateTimeGroupingRuleType)

피벗 그룹에 날짜 시간 그룹화 규칙을 설정합니다.

규칙을 삭제하려면 clearGroupingRule()를 사용합니다.

매개변수

이름유형설명
dateTimeGroupingRuleTypeDateTimeGroupingRuleType설정할 규칙 유형입니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

setDisplayName(name)

피벗 테이블에서 이 그룹의 표시 이름을 설정합니다.

매개변수

이름유형설명
nameString설정할 표시 이름입니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

setGroupLimit(countLimit)

피벗 그룹의 피벗 그룹 한도를 설정합니다. 이 작업은 DataSourcePivotTable에만 지원됩니다.

매개변수

이름유형설명
countLimitInteger설정할 행 또는 열의 개수 제한입니다. 양수여야 합니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

setHistogramGroupingRule(minValue, maxValue, intervalSize)

이 피벗 그룹의 히스토그램 그룹화 규칙을 설정합니다. 히스토그램 규칙은 소스 데이터 열의 값을 일정한 크기의 버킷으로 정리합니다. minValue부터 maxValue까지의 모든 값은 크기가 interval인 그룹에 배치됩니다. minValue보다 작은 모든 값은 maxValue보다 큰 모든 값과 마찬가지로 하나의 버킷에 배치됩니다.

매개변수

이름유형설명
minValueInteger버킷에 배치할 항목의 최소값입니다. 이 값보다 작은 값은 하나의 버킷으로 결합됩니다.
maxValueInteger버킷에 배치할 항목의 최대 값입니다. 이 값보다 큰 값은 하나의 버킷으로 결합됩니다.
intervalSizeInteger

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

showRepeatedLabels()

행 또는 열 그룹화가 두 개 이상인 경우 이 메서드는 후속 그룹의 각 항목에 대해 이 그룹의 라벨을 표시합니다. 라벨이 이미 반복된 경우 아무 일도 일어나지 않습니다. 행 또는 열 그룹이 여러 개 있기 전에 이 메서드가 호출되면 그룹이 추가될 때 반복된 라벨이 표시됩니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

showTotals(showTotals)

표에 이 피벗 그룹의 총 값을 표시할지 여부를 설정합니다.

매개변수

이름유형설명
showTotalsBoolean합계를 표시할지 여부입니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

sortAscending()

정렬 순서를 오름차순으로 설정합니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

sortBy(value, oppositeGroupValues)

oppositeGroupValues의 값에 대해 지정된 PivotValue를 기준으로 이 그룹을 정렬합니다. 

// Sorts the item group by the "SUM of Quantity" pivot value for the specified
// salespersons.
const sheet = SpreadsheetApp.getActiveSheet();
const pivotTable = sheet.getPivotTables()[0];
const itemGroup = pivotTable.getRowGroups()[0];
const sumQuantityValue = pivotTable.getPivotValues()[0];
itemGroup.sortBy(sumQuantityValue, ['Beth', 'Amir', 'Devyn']);

매개변수

이름유형설명
valuePivotValue정렬할 피벗 값입니다.
oppositeGroupValuesObject[]정렬하는 데 사용되는 반대 피벗 그룹의 값 (행 그룹을 정렬하는 경우 열 그룹, 열 그룹을 정렬하는 경우 행 그룹)입니다. 이러한 값의 순서에 따라 동점 시 우선순위가 결정됩니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

sortDescending()

정렬 순서를 내림차순으로 설정합니다.

리턴

PivotGroup: 체이닝을 위한 피벗 그룹입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

totalsAreShown()

이 피벗 그룹에 현재 총 값이 표시되는지 여부를 반환합니다.

리턴

Boolean: 이 피벗 그룹에 총 값이 표시되는 경우 true이고 그렇지 않으면 false을 반환합니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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