필터에 기준을 추가하려면 다음을 수행해야 합니다.
SpreadsheetApp.newFilterCriteria()
를 사용하여 기준 작성 도구를 만듭니다.- 이 클래스의 메서드를 사용하여 빌더에 설정을 추가합니다.
build()
를 사용하여 지정된 설정으로 기준을 조합합니다.
일반적인 용도
시트에서 값 숨기기
다음 샘플은 시트의 기존 필터를 가져오고 'hello' 또는 'world'가 포함된 C 열의 셀을 숨기는 기준을 추가합니다. 이 샘플의 기준은 기본 시트 유형인Grid
시트의 필터에만 사용할 수 있습니다.
let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() .setHiddenValues(["hello", "world"]) .build(); filter.setColumnFilterCriteria(3, criteria);
비어 있지 않은 셀만 표시
다음 샘플에서는 'Category' 열의 비어 있지 않은 셀만 표시하는 기준을 사용하여 데이터베이스에 연결된 시트인DataSource
시트에 필터를 추가합니다.
// Gets the sheet named "Connected sheet," which is connected to a database. let sheet = SpreadsheetApp.getActiveSpreadsheet() .getSheetByName("Connected sheet") .asDataSourceSheet(); // Creates criteria that only shows non-empty cells. let criteria = SpreadsheetApp.newFilterCriteria() .whenCellNotEmpty() .build(); // Applies the criteria to the column named "Category." sheet.addFilter("Category", criteria);
방법
자세한 문서
build()
기준 작성 도구에 추가한 설정을 사용하여 필터 기준을 조합합니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() // Creates a criteria builder. .whenCellNotEmpty() // Adds settings to the builder. .build(); // Assembles the criteria. filter.setColumnFilterCriteria(2, criteria);
리턴
FilterCriteria
- 필터 기준을 나타냅니다.
copy()
이 필터 기준을 복사하고 다른 필터에 적용할 수 있는 기준 작성 도구를 만듭니다.
이 방법은 모든 유형의 필터와 함께 사용할 수 있습니다. 시트 필터를 사용하는 경우 기준을 다른 열에 복사할 수 있습니다.
let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Makes a copy of the filter criteria applied to column C. let criteria = filter.getColumnFilterCriteria(3).copy().build(); // Applies the copied criteria to column B. The copied criteria overwrites any existing // criteria on column B. filter.setColumnFilterCriteria(2, criteria);
리턴
FilterCriteriaBuilder
- 이 필터 기준을 기반으로 하는 필터 기준 작성 도구입니다.
getCriteriaType()
기준의 불리언 유형(예: CELL_EMPTY
)을 반환합니다. 불리언 기준의 유형에 관해 알아보려면 BooleanCriteria
enum을 참고하세요.
사람들은 종종 이 메서드를 사용하여 기존 기준을 대체하지 않고 필터에 불리언 조건 기준을 추가합니다.
- 기준의 인수를 가져오려면
getCriteriaValues()
을 사용합니다. - 기준 유형 및 기준 값을 사용하여 필터 기준을 만들거나 수정하려면
withCriteria(criteria, args)
를 참고하세요.
이 방법은 모든 유형의 필터에 사용할 수 있습니다. 필터 기준이 불리언 조건이 아니면 null
을 반환합니다.
let ss = SpreadsheetApp.getActiveSheet(); // Gets the filter on the active sheet. let filter = ss.getFilter(); // Gets the criteria type and returns a string representing the criteria type object. let criteriaType = filter.getColumnFilterCriteria(2) .getCriteriaType() .toString(); // Logs the criteria type. console.log(criteriaType);
리턴
BooleanCriteria
- 불리언 기준의 유형 또는 기준이 불리언 조건이 아닌 경우 null
입니다.
getCriteriaValues()
불리언 기준에 대한 인수 배열을 반환합니다. 일부 불리언 기준 유형에는 인수가 없으며 빈 배열을 반환합니다(예: CELL_NOT_EMPTY
).
사람들은 종종 이 메서드를 사용하여 기존 기준을 대체하지 않고 필터에 불리언 조건 기준을 추가합니다.
- 불리언 기준 유형을 가져오려면
getCriteriaType()
을 사용하세요. - 기준 유형과 기준 값을 사용하여 필터 기준을 만들거나 수정하려면
withCriteria(criteria, args)
를 참고하세요.이 방법은 모든 유형의 필터에 사용할 수 있습니다.
let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Gets the values of the boolean criteria and logs them. For example, if the boolean // condition is whenNumberGreaterThan(10), then the logged value is 10. let criteriaValues = filter.getColumnFilterCriteria(2).getCriteriaValues(); console.log(criteriaValues);
리턴
Object[]
- 불리언 기준 유형에 적합한 인수 배열입니다. 인수의 수와 그 유형은FilterCriteriaBuilder
클래스의 상응하는when...()
메서드와 일치합니다.
getHiddenValues()
필터가 숨긴 값을 반환합니다.
시트의 기본 유형인 Grid
시트에서 이 기준을 필터에 사용하세요.
다른 유형의 필터에 이 메서드를 호출하면 null
가 반환됩니다.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Gets the filter criteria applied to column B, then gets the hidden values. let filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues(); // Logs the hidden values. console.log(filterCriteria);
리턴
String[]
- 필터가 숨기는 값의 배열입니다.
getVisibleBackgroundColor()
필터 기준으로 사용된 배경 색상을 반환합니다. 이 배경 색상의 셀은 계속 표시됩니다.
시트의 기본 유형인 Grid
시트에서 이 기준을 필터에 사용하세요.
다른 유형의 필터에 이 메서드를 호출하면 null
가 반환됩니다.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Logs the background color that column B is filtered by as a hexadecimal string. let filter = range.getFilter(); let color = filter.getColumnFilterCriteria(2) .getVisibleBackgroundColor() .asRgbColor() .asHexString(); console.log(color);
리턴
Color
- 필터 기준으로 사용되는 배경 색상입니다.
getVisibleForegroundColor()
필터 기준으로 사용된 전경 색상을 반환합니다. 이 전경색의 셀은 계속 표시됩니다.
시트의 기본 유형인 Grid
시트에서 이 기준을 필터에 사용하세요.
다른 유형의 필터에 이 메서드를 호출하면 null
가 반환됩니다.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Logs the foreground color that column B is filtered by as a hexadecimal string. let filter = range.getFilter(); let color = filter.getColumnFilterCriteria(2) .getVisibleForegroundColor() .asRgbColor() .asHexString(); console.log(color);
리턴
Color
: 필터 기준으로 사용되는 전경 색상입니다.
getVisibleValues()
피벗 테이블 필터에 표시되는 값을 반환합니다.
이 기준은 데이터베이스에 연결되지 않은 피벗 테이블의 필터에만 적용됩니다. 다른 유형의 필터에 대한 빈 배열을 반환합니다.
let ss = SpreadsheetApp.getActiveSheet(); // Gets the first pivot table on the sheet, then gets the visible values of its first filter. pivotTable = ss.getPivotTables()[0]; pivotFilterValues = pivotTable.getFilters()[0].getFilterCriteria().getVisibleValues(); // Logs the visible values. console.log(pivotFilterValues);
리턴
String[]
- 피벗 테이블 필터에 표시되는 값의 배열입니다.
setHiddenValues(values)
숨길 값을 설정합니다. 기존에 표시되거나 숨겨진 값을 지웁니다.
이 기준은 시트의 기본 유형인 Grid
시트의 필터에만 사용할 수 있습니다.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Sets the values to hide and applies the criteria to column C. let criteria = SpreadsheetApp.newFilterCriteria() .setHiddenValues(["Hello", "World"]) .build(); filter.setColumnFilterCriteria(3, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
values | String[] | 숨길 값의 목록입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
setVisibleBackgroundColor(visibleBackgroundColor)
필터 기준으로 사용되는 배경 색상을 설정합니다. 이 배경 색상의 셀은 계속 표시됩니다. 배경 색상 필터 기준을 설정하면 이 빌더에서 현재 색상 필터 기준이 삭제됩니다.
이 기준은 시트의 기본 유형인 Grid
시트의 필터에만 사용할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that filters by background color and sets it to column B. let color = SpreadsheetApp.newColor().setRgbColor("#185ABC").build(); let criteria = SpreadsheetApp.newFilterCriteria() .setVisibleBackgroundColor(color) .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
visibleBackgroundColor | Color | 설정할 배경 색상입니다. 색상은 RGB 스타일이어야 합니다. 이 방법은 테마 색상을 지원하지 않습니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
setVisibleForegroundColor(visibleForegroundColor)
필터 기준으로 사용되는 전경 색상을 설정합니다. 이 전경색의 셀은 계속 표시됩니다. 포그라운드 색상 필터 기준을 설정하면 이 빌더에서 현재 색상 필터 기준이 삭제됩니다.
이 기준은 시트의 기본 유형인 Grid
시트의 필터에만 사용할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that filters by foreground color and sets it to column B. let color = SpreadsheetApp.newColor().setRgbColor("#185ABC").build(); let criteria = SpreadsheetApp.newFilterCriteria() .setVisibleForegroundColor(color) .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
visibleForegroundColor | Color | 설정할 전경색입니다. 색상은 RGB 스타일이어야 합니다. 이 방법은 테마 색상을 지원하지 않습니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
setVisibleValues(values)
피벗 테이블에 표시할 값을 설정합니다. 기존에 표시되거나 숨겨진 값을 지웁니다.
데이터베이스에 연결되지 않은 피벗 테이블의 필터에만 이 기준을 사용할 수 있습니다.
// Gets the active sheet. const ss = SpreadsheetApp.getActiveSheet(); // Gets the first pivot table on the sheet and adds a filter to it that // sets the visible values to "Northeast" and "Southwest." let pivotTable = ss.getPivotTables()[0]; let criteria = SpreadsheetApp.newFilterCriteria() .setVisibleValues(["Northeast", "Southwest"]) .build(); pivotTable.addFilter(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
values | String[] | 표시할 값의 목록입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenCellEmpty()
빈 셀을 표시하도록 필터 기준을 설정합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Sets criteria to column B that only shows empty cells. let criteria = SpreadsheetApp.newFilterCriteria() .whenCellEmpty() .build(); filter.setColumnFilterCriteria(2, criteria);
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenCellNotEmpty()
비어 있지 않은 셀을 표시하도록 필터 기준을 설정합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Sets criteria to column B that only shows cells that aren't empty. let criteria = SpreadsheetApp.newFilterCriteria() .whenCellNotEmpty() .build(); filter.setColumnFilterCriteria(2, criteria);
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenDateAfter(date)
지정된 날짜 이후의 날짜를 포함하는 셀을 표시하는 필터 기준을 설정합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 날짜여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 날짜일 필요가 없지만 날짜가 없으면 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates after June 1, 2022 // and sets it to column A. let date = new Date("June 1, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateAfter(date) .build(); filter.setColumnFilterCriteria(1, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
date | Date | 숨길 마지막 날짜입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenDateAfter(date)
지정된 상대 날짜 이후의 날짜가 있는 셀을 표시하는 필터 기준을 설정합니다. 상대 날짜 옵션을 보려면 enum RelativeDate
를 참고하세요.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 날짜여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 날짜일 필요가 없지만 날짜가 없으면 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates after today's date // and sets it to column A. let date = SpreadsheetApp.RelativeDate.TODAY; let criteria = SpreadsheetApp.newFilterCriteria() .whenDateAfter(date) .build(); filter.setColumnFilterCriteria(1, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
date | RelativeDate | 가장 최근의 상대 날짜입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenDateBefore(date)
지정된 날짜 이전의 날짜가 있는 셀을 표시하는 필터 기준을 설정합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 날짜여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 날짜일 필요가 없지만 날짜가 없으면 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates before June 1, 2022 // and sets it to column A. let date = new Date("June 1, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateBefore(date) .build(); filter.setColumnFilterCriteria(1, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
date | Date | 숨길 가장 빠른 날짜입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenDateBefore(date)
지정된 상대 날짜 이전의 날짜가 있는 셀을 표시하는 필터 기준을 설정합니다.
상대 날짜 옵션을 보려면 enum RelativeDate
를 참고하세요.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 날짜여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 날짜일 필요가 없지만 날짜가 없으면 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates before today's date // and sets it to column A. let date = SpreadsheetApp.RelativeDate.TODAY; let criteria = SpreadsheetApp.newFilterCriteria() .whenDateBefore(date) .build(); filter.setColumnFilterCriteria(1, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
date | RelativeDate | 숨길 가장 이른 상대 날짜입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenDateEqualTo(date)
날짜가 지정된 날짜와 동일한 셀을 표시하는 필터 기준을 설정합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 날짜여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 날짜일 필요가 없지만 날짜가 없으면 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates equal to June 1, 2022 // and sets it to column A. let date = new Date("June 1, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateEqualTo(date) .build(); filter.setColumnFilterCriteria(1, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
date | Date | 셀 값이 일치해야 하는 날짜입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenDateEqualTo(date)
지정된 상대 날짜와 동일한 날짜가 있는 셀을 표시하는 필터 기준을 설정합니다.
상대 날짜 옵션을 보려면 enum RelativeDate
를 참고하세요.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 날짜여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 날짜일 필요가 없지만 날짜가 없으면 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates that fall within the past month // and sets it to column A. let date = SpreadsheetApp.RelativeDate.PAST_MONTH; let criteria = SpreadsheetApp.newFilterCriteria() .whenDateEqualTo(date) .build(); filter.setColumnFilterCriteria(1, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
date | RelativeDate | 셀 값이 일치해야 하는 상대 날짜입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenDateEqualToAny(dates)
지정된 날짜와 동일한 날짜가 있는 셀을 표시하도록 필터 기준을 설정합니다.
데이터베이스에 연결된 데이터에만 이 기준을 사용할 수 있습니다. 예를 들어 DataSource
시트, 데이터베이스에 연결된 시트 또는 DataSource
시트에서 생성된 피벗 테이블인 DataSourcePivotTable
의 필터와 함께 이 기준을 사용합니다.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "date" column that shows cells with any of the below dates. let date1 = new Date("June 1, 2022"); let date2 = new Date("June 2, 2022"); let date3 = new Date("June 3, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateEqualToAny([date1, date2, date3]) .build(); dataSheet.addFilter("date", criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
dates | Date[] | 표시할 날짜입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenDateNotEqualTo(date)
지정된 날짜와 같지 않은 셀을 표시하도록 필터 기준을 설정합니다.
데이터베이스에 연결된 데이터에만 이 기준을 사용할 수 있습니다. 예를 들어 DataSource
시트, 데이터베이스에 연결된 시트 또는 DataSource
시트에서 생성된 피벗 테이블인 DataSourcePivotTable
의 필터와 함께 이 기준을 사용합니다.
필터링하는 열의 데이터 유형은 날짜여야 합니다.
// Gets a pivot table that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Pivot Table Sheet"); let dataPivotTable = ss.getDataSourcePivotTables()[0]; // Creates criteria that only shows cells that don't equal June 16, 2022 // and sets it to the "date" column. let date = new Date("June 16, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateNotEqualTo(date) .build(); dataPivotTable.addFilter("date", criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
date | Date | 숨길 날짜입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenDateNotEqualToAny(dates)
지정된 날짜와 같지 않은 날짜가 있는 셀을 표시하도록 필터 기준을 설정합니다.
데이터베이스에 연결된 데이터에만 이 기준을 사용할 수 있습니다. 예를 들어 DataSource
시트, 데이터베이스에 연결된 시트 또는 DataSource
시트에서 생성된 피벗 테이블인 DataSourcePivotTable
의 필터와 함께 이 기준을 사용합니다.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "date" column that hides cells with any of the below dates. let date1 = new Date("June 1, 2022"); let date2 = new Date("June 2, 2022"); let date3 = new Date("June 3, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateNotEqualToAny([date1, date2, date3]) .build(); dataSheet.addFilter("date", criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
dates | Date[] | 숨길 날짜입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenFormulaSatisfied(formula)
true
로 평가되는 지정된 수식 (예: =B:B<C:C
)이 있는 셀을 표시하도록 필터 기준을 설정합니다.
이 기준은 데이터베이스에 연결되지 않은 데이터를 필터링하는 데만 사용할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows the rows where the value in column B is less than the value in // column C and sets it to column A. let formula = "=B:B<C:C"; let criteria = SpreadsheetApp.newFilterCriteria() .whenFormulaSatisfied(formula) .build(); filter.setColumnFilterCriteria(1, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
formula | String | 입력이 유효하면 true 로 평가되는 커스텀 수식입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenNumberBetween(start, end)
숫자가 지정된 2개 숫자 사이에 있거나 둘 중 하나인 셀을 표시하도록 필터 기준을 설정합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 숫자여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 숫자일 필요는 없지만 숫자가 아닌 경우 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that only shows cells with numbers that fall between 1-25, inclusively, // and sets it to column A. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberBetween(1, 25) .build(); filter.setColumnFilterCriteria(1, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Number | 표시할 가장 낮은 숫자입니다. |
end | Number | 표시할 가장 높은 숫자입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenNumberEqualTo(number)
지정된 숫자와 같은 숫자의 셀을 표시하도록 필터 기준을 설정합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 숫자여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 숫자일 필요는 없지만 숫자가 아닌 경우 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that only shows cells that are equal to 25 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberEqualTo(25) .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
number | Number | 표시할 숫자입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenNumberEqualToAny(numbers)
지정된 숫자와 동일한 숫자를 가진 셀을 표시하도록 필터 기준을 설정합니다.
데이터베이스에 연결된 데이터에만 이 기준을 사용할 수 있습니다. 예를 들어 DataSource
시트, 데이터베이스에 연결된 시트 또는 DataSource
시트에서 생성된 피벗 테이블인 DataSourcePivotTable
의 필터와 함께 이 기준을 사용합니다.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "amount" column that only shows cells with the number 10, 20, or 30. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberEqualToAny([10,20,30]) .build(); dataSheet.addFilter("amount", criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
numbers | Number[] | 표시할 숫자입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenNumberGreaterThan(number)
지정된 숫자보다 큰 숫자를 가진 셀을 표시하도록 필터 기준을 설정합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 숫자여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 숫자일 필요는 없지만 숫자가 아닌 경우 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells greater than 10 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberGreaterThan(10) .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
number | Number | 숨길 가장 큰 숫자입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenNumberGreaterThanOrEqualTo(number)
지정된 숫자보다 크거나 같은 숫자를 가진 셀을 표시하도록 필터 기준을 설정합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 숫자여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 숫자일 필요는 없지만 숫자가 아닌 경우 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells greater than or equal to 10 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberGreaterThanOrEqualTo(10) .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
number | Number | 표시할 가장 낮은 숫자입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenNumberLessThan(number)
지정된 숫자보다 작은 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 숫자여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 숫자일 필요는 없지만 숫자가 아닌 경우 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells less than 10 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberLessThan(10) .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
number | Number | 숨길 가장 낮은 숫자입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenNumberLessThanOrEqualTo(number)
지정된 숫자보다 작거나 같은 숫자를 포함하는 셀을 표시하도록 필터 기준을 설정합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 숫자여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 숫자일 필요는 없지만 숫자가 아닌 경우 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells less than or equal to 10 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberLessThanOrEqualTo(10) .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
number | Number | 표시할 가장 높은 숫자입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenNumberNotBetween(start, end)
숫자가 포함된 셀을 표시하도록 필터 기준을 설정합니다. 이때 지정된 2개의 숫자 사이에 포함되지도 않습니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 숫자여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 숫자일 필요는 없지만 숫자가 아닌 경우 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that hides cells with numbers that fall between 1-25, inclusively, // and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberNotBetween(1, 25) .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
start | Number | 가장 낮은 숫자는 숨기기입니다. |
end | Number | 숨길 가장 큰 숫자입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenNumberNotEqualTo(number)
지정된 숫자와 같지 않은 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형은 숫자여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않으면 필터링할 열의 데이터 유형이 숫자일 필요는 없지만 숫자가 아닌 경우 예기치 않은 결과가 발생할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that hides cells that are equal to 25 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberNotEqualTo(25) .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
number | Number | 숨길 숫자입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenNumberNotEqualToAny(numbers)
지정된 숫자와 같지 않은 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.
데이터베이스에 연결된 데이터에만 이 기준을 사용할 수 있습니다. 예를 들어 DataSource
시트, 데이터베이스에 연결된 시트 또는 DataSource
시트에서 생성된 피벗 테이블인 DataSourcePivotTable
의 필터와 함께 이 기준을 사용합니다.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "amount" column that hides cells with the number 10, 20, or 30. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberNotEqualToAny([10,20,30]) .build(); dataSheet.addFilter("amount", criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
numbers | Number[] | 숨길 숫자입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenTextContains(text)
지정된 텍스트를 포함하는 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 텍스트는 대소문자를 구분하지 않습니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells that contain "Northwest" and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenTextContains("Northwest") .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 셀에 포함해야 하는 텍스트입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenTextDoesNotContain(text)
지정된 텍스트가 포함되지 않은 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 텍스트는 대소문자를 구분하지 않습니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that hides cells that contain "Northwest" and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenTextDoesNotContain("Northwest") .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 셀에 포함되면 안 되는 텍스트입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenTextEndsWith(text)
지정된 텍스트로 끝나는 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 텍스트는 대소문자를 구분하지 않습니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells with text that ends with "est" and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenTextEndsWith("est") .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 셀의 텍스트 끝에 포함되어야 하는 텍스트입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenTextEqualTo(text)
지정된 텍스트와 동일한 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 텍스트는 대소문자를 구분하지 않습니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells with text that equals "hello" and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenTextEqualTo("hello") .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 셀의 텍스트와 같아야 하는 텍스트입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenTextEqualToAny(texts)
지정된 텍스트 값과 동일한 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 텍스트는 대소문자를 구분하지 않습니다.
데이터베이스에 연결된 데이터에만 이 기준을 사용할 수 있습니다. 예를 들어 DataSource
시트, 데이터베이스에 연결된 시트 또는 DataSource
시트에서 생성된 피벗 테이블인 DataSourcePivotTable
의 필터와 함께 이 기준을 사용합니다.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "category" column that shows cells with the text "tech" or "business." let criteria = SpreadsheetApp.newFilterCriteria() .whenTextEqualToAny(["tech","business"]) .build(); dataSheet.addFilter("category", criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
texts | String[] | 셀이 같아야 하는 텍스트 값입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenTextNotEqualTo(text)
지정된 텍스트와 같지 않은 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 텍스트는 대소문자를 구분하지 않습니다.
데이터베이스에 연결된 데이터에만 이 기준을 사용할 수 있습니다. 예를 들어 DataSource
시트, 데이터베이스에 연결된 시트 또는 DataSource
시트에서 생성된 피벗 테이블인 DataSourcePivotTable
의 필터와 함께 이 기준을 사용합니다.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "category" column that hides cells with text equal to "tech." let criteria = SpreadsheetApp.newFilterCriteria() .whenTextNotEqualTo("tech") .build(); dataSheet.addFilter("category", criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 셀의 텍스트와 같을 수 없는 텍스트입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenTextNotEqualToAny(texts)
지정된 값과 같지 않은 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 텍스트는 대소문자를 구분하지 않습니다.
데이터베이스에 연결된 데이터에만 이 기준을 사용할 수 있습니다. 예를 들어 DataSource
시트, 데이터베이스에 연결된 시트 또는 DataSource
시트에서 생성된 피벗 테이블인 DataSourcePivotTable
의 필터와 함께 이 기준을 사용합니다.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "category" column that hides cells with the text "tech" or "business." let criteria = SpreadsheetApp.newFilterCriteria() .whenTextNotEqualToAny(["tech","business"]) .build(); dataSheet.addFilter("category", criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
texts | String[] | 셀이 같을 수 없는 텍스트 값입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
whenTextStartsWith(text)
지정된 텍스트로 시작하는 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 텍스트는 대소문자를 구분하지 않습니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells with text that starts with "pre" and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenTextStartsWith("pre") .build(); filter.setColumnFilterCriteria(2, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
text | String | 셀의 텍스트 시작 부분에 포함되어야 하는 텍스트입니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.
withCriteria(criteria, args)
필터 기준을 BooleanCriteria
값(예: CELL_EMPTY
또는 NUMBER_GREATER_THAN
)으로 정의된 불리언 조건으로 설정합니다. 기존 기준에서 불리언 조건을 복사하려면 기존 기준에서 getCriteriaType()
및 getCriteriaValues()
를 사용하여 이 메서드의 매개변수를 정의합니다.
이 기준은 모든 유형의 필터와 함께 사용할 수 있지만 일부 BooleanCriteria
는 모든 필터에 적용되지 않습니다.
// Builds a filter criteria that is based on existing boolean conditions from another criteria. // Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Gets the existing boolean conditions applied to Column B and adds criteria to column C that // has the same boolean conditions and additional criteria that hides the value, "Northwest." let filter = ss.getFilter(); let filterCriteria = filter.getColumnFilterCriteria(2); let criteria = SpreadsheetApp.newFilterCriteria() .withCriteria(filterCriteria.getCriteriaType(), filterCriteria.getCriteriaValues()) .setHiddenValues(["Northwest"]) .build(); filter.setColumnFilterCriteria(3, criteria);
매개변수
이름 | 유형 | 설명 |
---|---|---|
criteria | BooleanCriteria | 불리언 기준의 유형입니다. |
args | Object[] | 기준 유형에 적합한 인수 배열입니다. 인수의 수와 유형은 위의 상응하는 when...() 메서드와 일치합니다. |
리턴
FilterCriteriaBuilder
- 체이닝을 위한 빌더입니다.