이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class FilterCriteriaBuilder

필터에 기준을 추가하려면 다음을 수행해야 합니다.

SpreadsheetApp.newFilterCriteria()를 사용하여 기준 작성 도구를 만듭니다.
이 클래스의 메서드를 사용하여 빌더에 설정을 추가합니다.
build()을 사용하여 기준을 지정된 설정으로 조합합니다.

일반적인 용도

시트에서 값 숨기기

다음 샘플은 시트의 기존 필터를 가져오고 셀을 숨기는 기준을 추가합니다. 'hello'가 포함된 C열 'world'라고 부릅니다. 이 샘플의 기준은 기본 유형인 Grid개의 시트에 필터가 적용됩니다.

let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setHiddenValues(["hello", "world"])
                             .build();
filter.setColumnFilterCriteria(3, criteria);

비어 있지 않은 셀만 표시

다음 샘플은 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()`	`FilterCriteria`	기준 작성 도구에 추가한 설정을 사용하여 필터 기준을 조합합니다.
`copy()`	`FilterCriteriaBuilder`	이 필터 기준을 복사하여 다른 필터에 적용할 수 있는 기준 작성 도구를 만듭니다. 필터를 적용합니다.
`getCriteriaType()`	`BooleanCriteria`	기준의 불리언 유형(예: `CELL_EMPTY`)을 반환합니다.
`getCriteriaValues()`	`Object[]`	부울 기준에 대한 인수 배열을 반환합니다.
`getHiddenValues()`	`String[]`	필터가 숨겨진 값을 반환합니다.
`getVisibleBackgroundColor()`	`Color`	필터 기준으로 사용된 배경 색상을 반환합니다.
`getVisibleForegroundColor()`	`Color`	필터 기준으로 사용된 전경 색상을 반환합니다.
`getVisibleValues()`	`String[]`	피벗 테이블 필터에 표시되는 값을 반환합니다.
`setHiddenValues(values)`	`FilterCriteriaBuilder`	숨길 값을 설정합니다.
`setVisibleBackgroundColor(visibleBackgroundColor)`	`FilterCriteriaBuilder`	필터 기준으로 사용되는 배경 색상을 설정합니다.
`setVisibleForegroundColor(visibleForegroundColor)`	`FilterCriteriaBuilder`	필터 기준으로 사용되는 전경 색상을 설정합니다.
`setVisibleValues(values)`	`FilterCriteriaBuilder`	피벗 테이블에 표시할 값을 설정합니다.
`whenCellEmpty()`	`FilterCriteriaBuilder`	빈 셀을 표시하도록 필터 기준을 설정합니다.
`whenCellNotEmpty()`	`FilterCriteriaBuilder`	비어 있지 않은 셀을 표시하도록 필터 기준을 설정합니다.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	날짜가 지정된 날짜 이후의 셀을 표시하는 필터 기준을 설정합니다.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	날짜가 지정된 상대 날짜 이후인 셀을 표시하는 필터 기준을 설정합니다.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	날짜가 지정된 날짜 이전인 셀을 표시하는 필터 기준을 설정합니다.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	지정된 상대 날짜 이전의 날짜가 포함된 셀을 표시하는 필터 기준을 설정합니다.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	지정된 날짜와 동일한 날짜가 있는 셀을 표시하는 필터 기준을 설정합니다.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	지정된 상대 날짜와 동일한 날짜가 있는 셀을 표시하는 필터 기준을 설정합니다.
`whenDateEqualToAny(dates)`	`FilterCriteriaBuilder`	날짜가 지정된 날짜 중 하나와 같은 셀을 표시하도록 필터 기준을 설정합니다.
`whenDateNotEqualTo(date)`	`FilterCriteriaBuilder`	지정된 날짜와 다른 셀을 표시하도록 필터 기준을 설정합니다.
`whenDateNotEqualToAny(dates)`	`FilterCriteriaBuilder`	지정된 날짜와 같지 않은 날짜가 포함된 셀을 표시하도록 필터 기준을 설정합니다. 날짜.
`whenFormulaSatisfied(formula)`	`FilterCriteriaBuilder`	지정된 수식 (예: `=B:B<C:C`)이 있는 셀을 표시하도록 필터 기준을 설정합니다. `true`로 평가됩니다.
`whenNumberBetween(start, end)`	`FilterCriteriaBuilder`	2에 속하거나 2 사이에 있는 숫자가 포함된 셀을 표시하도록 필터 기준을 설정합니다. 지정할 수 있습니다.
`whenNumberEqualTo(number)`	`FilterCriteriaBuilder`	지정된 숫자와 동일한 숫자를 가진 셀을 표시하도록 필터 기준을 설정합니다.
`whenNumberEqualToAny(numbers)`	`FilterCriteriaBuilder`	지정된 값과 동일한 숫자를 가진 셀을 표시하도록 필터 기준을 설정합니다. 있습니다.
`whenNumberGreaterThan(number)`	`FilterCriteriaBuilder`	지정된 숫자보다 큰 숫자가 포함된 셀을 표시하도록 필터 기준을 설정합니다.
`whenNumberGreaterThanOrEqualTo(number)`	`FilterCriteriaBuilder`	지정된 값보다 크거나 같은 셀을 표시하도록 필터 기준을 설정합니다. 있습니다.
`whenNumberLessThan(number)`	`FilterCriteriaBuilder`	지정된 숫자보다 작은 숫자가 포함된 셀을 표시하도록 필터 기준을 설정합니다.
`whenNumberLessThanOrEqualTo(number)`	`FilterCriteriaBuilder`	지정된 값보다 작거나 같은 숫자를 가진 셀을 표시하도록 필터 기준을 설정합니다. 있습니다.
`whenNumberNotBetween(start, end)`	`FilterCriteriaBuilder`	2에 속하지 않는 숫자가 포함된 셀을 표시하도록 필터 기준을 설정합니다. 지정할 수 있습니다.
`whenNumberNotEqualTo(number)`	`FilterCriteriaBuilder`	지정된 숫자와 같지 않은 숫자가 포함된 셀을 표시하도록 필터 기준을 설정합니다.
`whenNumberNotEqualToAny(numbers)`	`FilterCriteriaBuilder`	지정된 값과 같지 않은 숫자가 포함된 셀을 표시하도록 필터 기준을 설정합니다. 있습니다.
`whenTextContains(text)`	`FilterCriteriaBuilder`	지정된 텍스트가 포함된 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다.
`whenTextDoesNotContain(text)`	`FilterCriteriaBuilder`	지정된 텍스트를 포함하지 않는 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다.
`whenTextEndsWith(text)`	`FilterCriteriaBuilder`	지정된 텍스트로 끝나는 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다.
`whenTextEqualTo(text)`	`FilterCriteriaBuilder`	지정된 텍스트와 동일한 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다.
`whenTextEqualToAny(texts)`	`FilterCriteriaBuilder`	지정된 텍스트와 일치하는 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 값으로 사용됩니다.
`whenTextNotEqualTo(text)`	`FilterCriteriaBuilder`	지정된 텍스트와 다른 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다.
`whenTextNotEqualToAny(texts)`	`FilterCriteriaBuilder`	지정된 값과 같지 않은 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 값으로 사용됩니다.
`whenTextStartsWith(text)`	`FilterCriteriaBuilder`	지정된 텍스트로 시작하는 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다.
`withCriteria(criteria, args)`	`FilterCriteriaBuilder`	필터 기준을 `BooleanCriteria` 값으로 정의된 불리언 조건으로 설정합니다. 예를 들면 다음과 같습니다. `CELL_EMPTY` 또는 `NUMBER_GREATER_THAN`로 표현됩니다.

자세한 문서

`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 - 체이닝을 위한 빌더입니다.

생성 값

Error — 값 중 하나라도 null인 경우.

`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 스타일이어야 합니다. color[색상] 이 메서드는 테마 색상을 지원하지 않습니다.

리턴

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 스타일이어야 합니다. color[색상] 이 메서드는 테마 색상을 지원하지 않습니다.

리턴

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 - 체이닝을 위한 빌더입니다.

생성 값

Error — 값 중 하나라도 null인 경우.

`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)`

날짜가 지정된 상대 날짜 이후인 셀을 표시하는 필터 기준을 설정합니다. 받는사람 상대 날짜 옵션을 보려면 열거형 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)`

지정된 상대 날짜 이전의 날짜가 포함된 셀을 표시하는 필터 기준을 설정합니다. 상대적 날짜 옵션을 보려면 열거형 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)`

지정된 상대 날짜와 동일한 날짜가 있는 셀을 표시하는 필터 기준을 설정합니다. 상대적 날짜 옵션을 보려면 열거형 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)`

지정된 날짜와 다른 셀을 표시하도록 필터 기준을 설정합니다.

필터링 기준으로 사용할 열의 데이터 유형은 날짜여야 합니다.

// 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)`

지정된 날짜와 같지 않은 날짜가 포함된 셀을 표시하도록 필터 기준을 설정합니다. 날짜.

// 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)`

지정된 수식 (예: =B:B<C:C)이 있는 셀을 표시하도록 필터 기준을 설정합니다. true로 평가됩니다.

이 기준은 데이터베이스에 연결되지 않은 데이터만 필터링할 수 있습니다.

// 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에 속하거나 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)`

지정된 값과 동일한 숫자를 가진 셀을 표시하도록 필터 기준을 설정합니다. 있습니다.

// 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)`

지정된 값과 같지 않은 숫자가 포함된 셀을 표시하도록 필터 기준을 설정합니다. 있습니다.

// 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)`

지정된 텍스트와 일치하는 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 값으로 사용됩니다. 텍스트는 대소문자를 구분하지 않습니다.

// 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)`

지정된 텍스트와 다른 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 이 텍스트는 대소문자를 구분하지 않습니다.

// 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)`

지정된 값과 같지 않은 텍스트가 있는 셀을 표시하도록 필터 기준을 설정합니다. 값으로 사용됩니다. 텍스트는 대소문자를 구분하지 않습니다.

// 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 - 체이닝을 위한 빌더입니다.