Class FilterCriteriaBuilder

FilterCriteriaBuilder

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

  1. SpreadsheetApp.newFilterCriteria()를 사용하여 기준 작성 도구를 만듭니다.
  2. 이 클래스의 메서드를 사용하여 빌더에 설정을 추가합니다.
  3. 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()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)FilterCriteriaBuildertrue로 평가되는 지정된 수식 (예: =B:B<C:C)이 있는 셀을 표시하도록 필터 기준을 설정합니다.
whenNumberBetween(start, end)FilterCriteriaBuilder숫자가 지정된 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을 참고하세요.

사람들은 종종 이 메서드를 사용하여 기존 기준을 대체하지 않고 필터에 불리언 조건 기준을 추가합니다.

이 방법은 모든 유형의 필터에 사용할 수 있습니다. 필터 기준이 불리언 조건이 아니면 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);

매개변수

이름유형설명
valuesString[]숨길 값의 목록입니다.

리턴

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

매개변수

이름유형설명
visibleBackgroundColorColor설정할 배경 색상입니다. 색상은 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);

매개변수

이름유형설명
visibleForegroundColorColor설정할 전경색입니다. 색상은 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);

매개변수

이름유형설명
valuesString[]표시할 값의 목록입니다.

리턴

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

매개변수

이름유형설명
dateDate숨길 마지막 날짜입니다.

리턴

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

매개변수

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

리턴

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

매개변수

이름유형설명
dateDate숨길 가장 빠른 날짜입니다.

리턴

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

매개변수

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

리턴

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

매개변수

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

리턴

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

매개변수

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

리턴

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

매개변수

이름유형설명
datesDate[]표시할 날짜입니다.

리턴

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

매개변수

이름유형설명
dateDate숨길 날짜입니다.

리턴

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

매개변수

이름유형설명
datesDate[]숨길 날짜입니다.

리턴

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

매개변수

이름유형설명
formulaString입력이 유효하면 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);

매개변수

이름유형설명
startNumber표시할 가장 낮은 숫자입니다.
endNumber표시할 가장 높은 숫자입니다.

리턴

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

매개변수

이름유형설명
numberNumber표시할 숫자입니다.

리턴

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

매개변수

이름유형설명
numbersNumber[]표시할 숫자입니다.

리턴

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

매개변수

이름유형설명
numberNumber숨길 가장 큰 숫자입니다.

리턴

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

매개변수

이름유형설명
numberNumber표시할 가장 낮은 숫자입니다.

리턴

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

매개변수

이름유형설명
numberNumber숨길 가장 낮은 숫자입니다.

리턴

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

매개변수

이름유형설명
numberNumber표시할 가장 높은 숫자입니다.

리턴

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

매개변수

이름유형설명
startNumber가장 낮은 숫자는 숨기기입니다.
endNumber숨길 가장 큰 숫자입니다.

리턴

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

매개변수

이름유형설명
numberNumber숨길 숫자입니다.

리턴

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

매개변수

이름유형설명
numbersNumber[]숨길 숫자입니다.

리턴

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

매개변수

이름유형설명
textString셀에 포함해야 하는 텍스트입니다.

리턴

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

매개변수

이름유형설명
textString셀에 포함되면 안 되는 텍스트입니다.

리턴

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

매개변수

이름유형설명
textString셀의 텍스트 끝에 포함되어야 하는 텍스트입니다.

리턴

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

매개변수

이름유형설명
textString셀의 텍스트와 같아야 하는 텍스트입니다.

리턴

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

매개변수

이름유형설명
textsString[]셀이 같아야 하는 텍스트 값입니다.

리턴

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

매개변수

이름유형설명
textString셀의 텍스트와 같을 수 없는 텍스트입니다.

리턴

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

매개변수

이름유형설명
textsString[]셀이 같을 수 없는 텍스트 값입니다.

리턴

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

매개변수

이름유형설명
textString셀의 텍스트 시작 부분에 포함되어야 하는 텍스트입니다.

리턴

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

매개변수

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

리턴

FilterCriteriaBuilder - 체이닝을 위한 빌더입니다.