Class PivotGroup

피벗그룹

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

메서드

메서드반환 유형간략한 설명
addManualGroupingRule(groupName, groupMembers)PivotGroup이 피벗 그룹에 수동 그룹화 규칙을 추가합니다.
areLabelsRepeated()Boolean라벨이 반복으로 표시되는지 여부를 반환합니다.
clearGroupingRule()PivotGroup이 피벗 그룹에서 그룹화 규칙을 삭제합니다.
clearSort()PivotGroup이 그룹에 적용된 정렬을 삭제합니다.
getDateTimeGroupingRule()DateTimeGroupingRule|null피벗 그룹의 날짜 시간 그룹화 규칙을 반환합니다. 날짜 시간 그룹화 규칙이 설정되지 않은 경우 null을 반환합니다.
getDimension()Dimension행 그룹인지 열 그룹인지 여부를 반환합니다.
getGroupLimit()PivotGroupLimit|null피벗 그룹의 피벗 그룹 한도를 반환합니다.
getIndex()Integer현재 그룹 순서에서 이 피벗 그룹의 색인을 반환합니다.
getPivotTable()PivotTable이 그룹화가 속한 PivotTable를 반환합니다.
getSourceDataColumn()Integer이 그룹이 요약하는 소스 데이터 열의 수를 반환합니다.
getSourceDataSourceColumn()DataSourceColumn|null피벗 그룹이 작동하는 데이터 소스 열을 반환합니다.
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|null - 날짜 시간 그룹화 규칙입니다.

승인

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

  • 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|null: 피벗 그룹 한도입니다.

승인

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

  • 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()

이 그룹이 요약하는 소스 데이터 열의 수를 반환합니다. 이 그룹이 스프레드시트의 'A' 열에 있는 소스 데이터를 요약하는 경우 이 색인은 1부터 시작하며 이 메서드는 1를 반환합니다.

리턴

Integer - 소스 데이터 열 번호

승인

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

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

getSourceDataSourceColumn()

피벗 그룹이 작동하는 데이터 소스 열을 반환합니다. 피벗 테이블이 {DataSourcePivotTableApi}이 아니면 null를 반환합니다.

리턴

DataSourceColumn|null - 피벗 그룹이 작동하는 데이터 소스 열입니다.

승인

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

  • 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