Class FilterCriteriaBuilder

FilterCriteriaBuilder

필터에 기준을 추가하려면 다음 단계를 따르세요.

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

일반적인 용도

시트에서 값 숨기기

다음 샘플은 시트의 기존 필터를 가져와 'hello' 또는 'world'가 포함된 C열의 셀을 숨기는 기준을 추가합니다. 이 샘플의 기준은 기본 시트 유형인 Grid 시트의 필터에만 사용할 수 있습니다.

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

셀이 비어 있지 않은 경우만 표시

다음 샘플은 데이터베이스에 연결된 시트인 DataSource 시트에 '카테고리' 열에서 비어 있지 않은 셀만 표시하는 기준을 사용하여 필터를 추가합니다.

// Gets the sheet named "Connected sheet," which is connected to a database.
const sheet = SpreadsheetApp.getActiveSpreadsheet()
                  .getSheetByName('Connected sheet')
                  .asDataSourceSheet();
// Creates criteria that only shows non-empty cells.
const 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	true로 평가되는 지정된 수식 (예: =B:B<C:C)이 있는 셀을 표시하도록 필터 기준을 설정합니다.
whenNumberBetween(start, end)	FilterCriteriaBuilder	지정된 두 숫자 사이의 숫자 또는 지정된 두 숫자 중 하나인 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.
whenNumberEqualTo(number)	FilterCriteriaBuilder	지정된 숫자와 같은 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.
whenNumberEqualToAny(numbers)	FilterCriteriaBuilder	지정된 숫자와 같은 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.
whenNumberGreaterThan(number)	FilterCriteriaBuilder	지정된 숫자보다 큰 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.
whenNumberGreaterThanOrEqualTo(number)	FilterCriteriaBuilder	지정된 숫자보다 크거나 같은 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.
whenNumberLessThan(number)	FilterCriteriaBuilder	지정된 숫자보다 작은 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.
whenNumberLessThanOrEqualTo(number)	FilterCriteriaBuilder	지정된 숫자보다 작거나 같은 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.
whenNumberNotBetween(start, end)	FilterCriteriaBuilder	지정된 두 숫자 사이 또는 지정된 두 숫자가 아닌 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.
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();
const filter = ss.getFilter();
const criteria = SpreadsheetApp
                     .newFilterCriteria()  // Creates a criteria builder.
                     .whenCellNotEmpty()   // Adds settings to the builder.
                     .build();             // Assembles the criteria.
filter.setColumnFilterCriteria(2, criteria);

리턴

FilterCriteria: 필터 기준의 표현입니다.

---

copy()

이 필터 기준을 복사하고 다른 필터에 적용할 수 있는 기준 작성 도구를 만듭니다.

이 메서드는 모든 유형의 필터에 사용할 수 있습니다. 시트 필터를 사용하는 경우 기준을 다른 열에 복사할 수 있습니다.

const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Makes a copy of the filter criteria applied to column C.
const 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를 반환합니다.

const ss = SpreadsheetApp.getActiveSheet();
// Gets the filter on the active sheet.
const filter = ss.getFilter();
// Gets the criteria type and returns a string representing the criteria type
// object.
const criteriaType =
    filter.getColumnFilterCriteria(2).getCriteriaType().toString();
// Logs the criteria type.
console.log(criteriaType);

리턴

BooleanCriteria: 불리언 기준의 유형입니다. 기준이 불리언 조건이 아닌 경우 null입니다.

---

getCriteriaValues()

불리언 기준의 인수 배열을 반환합니다. 일부 불리언 기준 유형에는 인수가 없으며 빈 배열을 반환합니다(예: CELL_NOT_EMPTY).

이 메서드는 기존 기준을 대체하지 않고 필터에 불리언 조건 기준을 추가하는 데 자주 사용됩니다.

• 불리언 기준 유형을 가져오려면 getCriteriaType()를 사용합니다.
• 기준 유형 및 기준 값을 사용하여 필터 기준을 만들거나 수정하려면 withCriteria(criteria, args)를 참고하세요.

  이 메서드는 모든 유형의 필터에 사용할 수 있습니다.

  const ss = SpreadsheetApp.getActiveSheet();
  const 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.
  const criteriaValues = filter.getColumnFilterCriteria(2).getCriteriaValues();
  console.log(criteriaValues);

  리턴

  Object[]: 불리언 기준 유형에 적합한 인수 배열입니다. 인수의 개수와 유형이 FilterCriteriaBuilder 클래스의 상응하는 when...() 메서드와 일치합니다.

---

getHiddenValues()

필터가 숨기는 값을 반환합니다.

기본 시트 유형인 Grid 시트에서 필터와 함께 이 기준을 사용합니다. 다른 유형의 필터에 이 메서드를 호출하면 null를 반환합니다.

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Gets the filter criteria applied to column B, then gets the hidden values.
const filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues();
// Logs the hidden values.
console.log(filterCriteria);

리턴

String[]: 필터가 숨기는 값 배열입니다.

---

getVisibleBackgroundColor()

필터 기준으로 사용되는 배경 색상을 반환합니다. 이 배경 색상이 적용된 셀은 계속 표시됩니다.

기본 시트 유형인 Grid 시트에서 필터와 함께 이 기준을 사용합니다. 다른 유형의 필터에 이 메서드를 호출하면 null를 반환합니다.

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
// Logs the background color that column B is filtered by as a hexadecimal
// string.
const filter = range.getFilter();
const color = filter.getColumnFilterCriteria(2)
                  .getVisibleBackgroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

리턴

Color: 필터 기준으로 사용되는 배경 색상입니다.

---

getVisibleForegroundColor()

필터 기준으로 사용되는 전경 색상을 반환합니다. 이 전경 색상이 적용된 셀은 계속 표시됩니다.

기본 시트 유형인 Grid 시트에서 필터와 함께 이 기준을 사용합니다. 다른 유형의 필터에 대해 이 메서드를 호출하면 null를 반환합니다.

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
// Logs the foreground color that column B is filtered by as a hexadecimal
// string.
const filter = range.getFilter();
const color = filter.getColumnFilterCriteria(2)
                  .getVisibleForegroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

리턴

Color: 필터 기준으로 사용되는 전경 색상입니다.

---

getVisibleValues()

피벗 테이블 필터에 표시되는 값을 반환합니다.

이 기준은 데이터베이스에 연결되지 않은 피벗 테이블의 필터에만 적용됩니다. 다른 유형의 필터의 경우 빈 배열을 반환합니다.

const ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet, then gets the visible values of its
// first filter.
const pivotTable = ss.getPivotTables()[0];
const 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();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets the values to hide and applies the criteria to column C.
const 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();
const filter = ss.getFilter();
// Creates criteria that filters by background color and sets it to column B.
const color = SpreadsheetApp.newColor().setRgbColor('#185ABC').build();
const 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();
const filter = ss.getFilter();
// Creates criteria that filters by foreground color and sets it to column B.
const color = SpreadsheetApp.newColor().setRgbColor('#185ABC').build();
const 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."
const pivotTable = ss.getPivotTables()[0];
const 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();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets criteria to column B that only shows empty cells.
const criteria = SpreadsheetApp.newFilterCriteria().whenCellEmpty().build();
filter.setColumnFilterCriteria(2, criteria);

리턴

FilterCriteriaBuilder: 체이닝을 위한 이 빌더

---

whenCellNotEmpty()

비어 있지 않은 셀을 표시하도록 필터 기준을 설정합니다.

이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets criteria to column B that only shows cells that aren't empty.
const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();
filter.setColumnFilterCriteria(2, criteria);

리턴

FilterCriteriaBuilder: 체이닝을 위한 이 빌더

---

whenDateAfter(date)

지정된 날짜 이후의 날짜가 있는 셀을 표시하는 필터 기준을 설정합니다.

이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형이 날짜여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않은 경우 필터링하는 열의 데이터 유형이 날짜일 필요는 없지만 그렇지 않은 경우 예기치 않은 결과가 표시될 수 있습니다.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates after June 1, 2022
// and sets it to column A.
const date = new Date('June 1, 2022');
const 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();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates after today's date
// and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

매개변수

이름	유형	설명
date	RelativeDate	가장 최근 상대 날짜입니다.

리턴

FilterCriteriaBuilder: 체이닝을 위한 이 빌더

---

whenDateBefore(date)

지정된 날짜 이전의 날짜가 있는 셀을 표시하는 필터 기준을 설정합니다.

이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형이 날짜여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않은 경우 필터링하는 열의 데이터 유형이 날짜일 필요는 없지만 그렇지 않은 경우 예기치 않은 결과가 표시될 수 있습니다.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates before June 1, 2022
// and sets it to column A.
const date = new Date('June 1, 2022');
const 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();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates before today's date
// and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

매개변수

이름	유형	설명
date	RelativeDate	숨길 가장 빠른 상대 날짜입니다.

리턴

FilterCriteriaBuilder: 체이닝을 위한 이 빌더

---

whenDateEqualTo(date)

지정된 날짜와 동일한 날짜가 있는 셀을 표시하는 필터 기준을 설정합니다.

이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형이 날짜여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않은 경우 필터링하는 열의 데이터 유형이 날짜일 필요는 없지만 그렇지 않은 경우 예기치 않은 결과가 표시될 수 있습니다.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates equal to June 1, 2022
// and sets it to column A.
const date = new Date('June 1, 2022');
const 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();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates that fall within the past
// month and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateEqualTo(SpreadsheetApp.RelativeDate.PAST_MONTH)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

매개변수

이름	유형	설명
date	RelativeDate	셀 값이 일치해야 하는 상대 날짜입니다.

리턴

FilterCriteriaBuilder: 체이닝을 위한 이 빌더

---

whenDateEqualToAny(dates)

지정된 날짜와 동일한 날짜가 있는 셀을 표시하도록 필터 기준을 설정합니다.

이 기준은 데이터베이스에 연결된 데이터에만 사용할 수 있습니다. 예를 들어 DataSource 시트, 데이터베이스에 연결된 시트 또는 DataSource 시트에서 만든 피벗 테이블인 DataSourcePivotTable의 필터와 함께 이 기준을 사용하세요.

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that shows cells with any of the below
// dates.
const date1 = new Date('June 1, 2022');
const date2 = new Date('June 2, 2022');
const date3 = new Date('June 3, 2022');
const 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.
const ss =
    SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Pivot Table Sheet');
const dataPivotTable = ss.getDataSourcePivotTables()[0];
// Creates criteria that only shows cells that don't equal June 16, 2022
// and sets it to the "date" column.
const date = new Date('June 16, 2022');
const 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.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that hides cells with any of the below
// dates.
const date1 = new Date('June 1, 2022');
const date2 = new Date('June 2, 2022');
const date3 = new Date('June 3, 2022');
const 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();
const 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.
const formula = '=B:B<C:C';
const criteria =
    SpreadsheetApp.newFilterCriteria().whenFormulaSatisfied(formula).build();
filter.setColumnFilterCriteria(1, criteria);

매개변수

이름	유형	설명
formula	String	입력이 유효한 경우 true로 평가되는 맞춤 수식입니다.

리턴

FilterCriteriaBuilder: 체이닝을 위한 이 빌더

---

whenNumberBetween(start, end)

지정된 두 숫자 사이의 숫자 또는 지정된 두 숫자 중 하나인 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.

이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형이 숫자여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않은 경우 필터링하는 열의 데이터 유형이 숫자가 아니어도 되지만, 그렇지 않은 경우 예기치 않은 결과가 표시될 수 있습니다.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that only shows cells with numbers that fall between 1-25,
// inclusively, and sets it to column A.
const 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();
const filter = ss.getFilter();
// Creates criteria that only shows cells that are equal to 25 and sets it to
// column B.
const 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.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that only shows cells with the number
// 10, 20, or 30.
const 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();
const filter = ss.getFilter();
// Creates criteria that shows cells greater than 10 and sets it to column B.
const 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();
const filter = ss.getFilter();
// Creates criteria that shows cells greater than or equal to 10 and sets it to
// column B.
const 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();
const filter = ss.getFilter();
// Creates criteria that shows cells less than 10 and sets it to column B.
const 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();
const filter = ss.getFilter();
// Creates criteria that shows cells less than or equal to 10 and sets it to
// column B.
const criteria =
    SpreadsheetApp.newFilterCriteria().whenNumberLessThanOrEqualTo(10).build();
filter.setColumnFilterCriteria(2, criteria);

매개변수

이름	유형	설명
number	Number	표시할 최대 수입니다.

리턴

FilterCriteriaBuilder: 체이닝을 위한 이 빌더

---

whenNumberNotBetween(start, end)

지정된 두 숫자 사이 또는 두 숫자가 아닌 숫자가 있는 셀을 표시하도록 필터 기준을 설정합니다.

이 기준은 모든 유형의 필터와 함께 사용할 수 있습니다. 데이터베이스에 연결된 데이터에 이 기준을 사용하는 경우 필터링하는 열의 데이터 유형이 숫자여야 합니다. 데이터가 데이터베이스에 연결되어 있지 않은 경우 필터링하는 열의 데이터 유형이 숫자가 아니어도 되지만 그렇지 않은 경우 예기치 않은 결과가 표시될 수 있습니다.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Creates criteria that hides cells with numbers that fall between 1-25,
// inclusively, and sets it to column B.
const 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();
const filter = ss.getFilter();
// Creates criteria that hides cells that are equal to 25 and sets it to column
// B.
const 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.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that hides cells with the number 10, 20,
// or 30.
const 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();
const filter = ss.getFilter();
// Creates criteria that shows cells that contain "Northwest" and sets it to
// column B.
const 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();
const filter = ss.getFilter();
// Creates criteria that hides cells that contain "Northwest" and sets it to
// column B.
const 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();
const filter = ss.getFilter();
// Creates criteria that shows cells with text that ends with "est" and sets it
// to column B.
const 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();
const filter = ss.getFilter();
// Creates criteria that shows cells with text that equals "hello" and sets it
// to column B.
const 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.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that shows cells with the text "tech"
// or "business."
const 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.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with text equal to
// "tech."
const 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.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with the text "tech"
// or "business."
const 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();
const filter = ss.getFilter();
// Creates criteria that shows cells with text that starts with "pre" and sets
// it to column B.
const 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();
const 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."
const filterCriteria = filter.getColumnFilterCriteria(2);
const criteria = SpreadsheetApp.newFilterCriteria()
                     .withCriteria(
                         filterCriteria.getCriteriaType(),
                         filterCriteria.getCriteriaValues(),
                         )
                     .setHiddenValues(['Northwest'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

매개변수

이름	유형	설명
criteria	BooleanCriteria	불리언 기준의 유형입니다.
args	Object[]	기준 유형에 적합한 인수 배열입니다. 인수의 개수와 유형은 위에 나온 상응하는 when...() 메서드와 일치합니다.

리턴

FilterCriteriaBuilder: 체이닝을 위한 이 빌더