Class PivotGroup

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행 또는 열 그룹화가 2개 이상인 경우 이 방법은 후속 그룹화의 각 항목에 이 그룹화 라벨을 표시합니다.
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()

행 또는 열 그룹화가 2개 이상인 경우 이 방법은 후속 그룹화의 각 항목에 이 그룹화 라벨을 표시합니다. 라벨이 이미 반복되면 작동하지 않습니다. 행 또는 열 그룹이 여러 개 있기 전에 이 메서드를 호출하면, 추가 그룹화가 추가되면 반복되는 라벨이 표시됩니다.

리턴

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.
var sheet = SpreadsheetApp.getActiveSheet();
var pivotTable = sheet.getPivotTables()[0];
var itemGroup = pivotTable.getRowGroups()[0];
var 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