این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class FilterCriteriaBuilder

برای افزودن معیار به فیلتر، باید موارد زیر را انجام دهید:

سازنده معیارها را با استفاده از SpreadsheetApp.newFilterCriteria() ایجاد کنید.
با استفاده از متدهای این کلاس تنظیمات را به سازنده اضافه کنید.
از build() برای جمع آوری معیارها با تنظیمات مشخص شده خود استفاده کنید.

استفاده های رایج

مخفی کردن مقادیر در یک برگه

نمونه زیر فیلتر موجود یک برگه را دریافت می‌کند و معیارهایی را اضافه می‌کند که سلول‌های ستون C حاوی «hello» یا «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 عدد مشخص شده قرار می گیرد، تنظیم می کند.
`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 مراجعه کنید.

مردم اغلب از این روش برای اضافه کردن معیارهای شرط بولی به یک فیلتر بدون جایگزین کردن معیارهای موجود استفاده می کنند.

برای بدست آوردن آرگومان های معیارها، از 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[] - آرایه ای از آرگومان های متناسب با نوع معیار بولی. تعداد آرگومان ها و نوع آنها با متد when...() کلاس FilterCriteriaBuilder مطابقت دارد.

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

رنگ پس زمینه استفاده شده به عنوان معیار فیلتر را برمی گرداند. سلول هایی با این رنگ پس زمینه قابل مشاهده باقی می مانند.

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

رنگ پیش زمینه استفاده شده به عنوان معیار فیلتر را برمی گرداند. سلول هایی با این رنگ پیش زمینه قابل مشاهده باقی می مانند.

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

برگشت

Color - رنگ پیش زمینه که به عنوان معیار فیلتر استفاده می شود.

`getVisibleValues()`

مقادیری را که فیلتر جدول محوری نشان می دهد برمی گرداند.

این معیار فقط برای فیلترهای جداول محوری است که به پایگاه داده متصل نیستند. یک آرایه خالی برای انواع دیگر فیلترها برمی گرداند.

let ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet, then gets the visible values of its first filter.
pivotTable = ss.getPivotTables()[0];
pivotFilterValues = pivotTable.getFilters()[0].getFilterCriteria().getVisibleValues();
// Logs the visible values.
console.log(pivotFilterValues);

برگشت

String[] - آرایه ای از مقادیری که فیلتر جدول محوری نشان می دهد.

`setHiddenValues(values)`

مقادیر را برای پنهان کردن تنظیم می کند. مقادیر قابل مشاهده یا پنهان موجود را پاک می کند.

شما فقط می توانید از این معیار برای فیلترها در صفحات Grid ، نوع پیش فرض برگه استفاده کنید.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Sets the values to hide and applies the criteria to column C.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setHiddenValues(["Hello", "World"])
                             .build();
filter.setColumnFilterCriteria(3, criteria);

مولفه های

نام	تایپ کنید	شرح
`values`	`String[]`	لیست مقادیر برای پنهان کردن

برگشت

FilterCriteriaBuilder - این سازنده، برای زنجیر کردن.

`setVisibleBackgroundColor(visibleBackgroundColor)`

رنگ پس زمینه مورد استفاده را به عنوان معیار فیلتر تنظیم می کند. سلول هایی با این رنگ پس زمینه قابل مشاهده باقی می مانند. تنظیم یک معیار فیلتر رنگ پس‌زمینه، هر معیار فیلتر رنگ فعلی را از این سازنده حذف می‌کند.

شما فقط می توانید از این معیار برای فیلترها در صفحات Grid ، نوع پیش فرض برگه استفاده کنید.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that filters by background color and sets it to column B.
let color = SpreadsheetApp.newColor().setRgbColor("#185ABC").build();
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleBackgroundColor(color)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

مولفه های

نام	تایپ کنید	شرح
`visibleBackgroundColor`	`Color`	رنگ پس زمینه برای تنظیم. رنگ باید به سبک RGB باشد. این روش از رنگ های تم پشتیبانی نمی کند.

برگشت

FilterCriteriaBuilder - این سازنده، برای زنجیر کردن.

`setVisibleForegroundColor(visibleForegroundColor)`

رنگ پیش زمینه مورد استفاده به عنوان معیار فیلتر را تنظیم می کند. سلول هایی با این رنگ پیش زمینه قابل مشاهده باقی می مانند. تنظیم معیار فیلتر رنگی پیش زمینه، هرگونه معیار فیلتر رنگ فعلی را از این سازنده حذف می کند.

شما فقط می توانید از این معیار برای فیلترها در صفحات Grid ، نوع پیش فرض برگه استفاده کنید.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that filters by foreground color and sets it to column B.
let color = SpreadsheetApp.newColor().setRgbColor("#185ABC").build();
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleForegroundColor(color)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

مولفه های

نام	تایپ کنید	شرح
`visibleForegroundColor`	`Color`	رنگ پیش زمینه برای تنظیم. رنگ باید به سبک RGB باشد. این روش از رنگ های تم پشتیبانی نمی کند.

برگشت

FilterCriteriaBuilder - این سازنده، برای زنجیر کردن.

`setVisibleValues(values)`

مقادیر را برای نمایش در جدول محوری تنظیم می کند. مقادیر قابل مشاهده یا پنهان موجود را پاک می کند.

شما فقط می توانید از این معیار برای فیلترهای جداول محوری استفاده کنید که به پایگاه داده متصل نیستند.

// Gets the active sheet.
const ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet and adds a filter to it that
// sets the visible values to "Northeast" and "Southwest."
let pivotTable = ss.getPivotTables()[0];
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleValues(["Northeast", "Southwest"])
                             .build();
pivotTable.addFilter(2, criteria);

مولفه های

نام	تایپ کنید	شرح
`values`	`String[]`	لیست مقادیر برای نمایش

برگشت

FilterCriteriaBuilder - این سازنده، برای زنجیر کردن.

`whenCellEmpty()`

معیارهای فیلتر را برای نشان دادن سلول های خالی تنظیم می کند.

با هر نوع فیلتری می توانید از این معیار استفاده کنید.

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

برگشت

FilterCriteriaBuilder - این سازنده، برای زنجیر کردن.

`whenCellNotEmpty()`

معیارهای فیلتر را برای نشان دادن سلول هایی که خالی نیستند تنظیم می کند.

با هر نوع فیلتری می توانید از این معیار استفاده کنید.

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

برگشت

FilterCriteriaBuilder - این سازنده، برای زنجیر کردن.

`whenDateAfter(date)`

معیارهای فیلتر را تنظیم می کند که سلول ها را با تاریخ هایی که بعد از تاریخ مشخص شده هستند نشان می دهد.

با هر نوع فیلتری می توانید از این معیار استفاده کنید. اگر از این معیار برای داده هایی استفاده می کنید که به یک پایگاه داده متصل هستند، نوع داده ستونی که بر اساس آن فیلتر می کنید باید یک تاریخ باشد. اگر داده ها به پایگاه داده متصل نیستند، نیازی نیست که نوع داده ستونی که بر اساس آن فیلتر می کنید تاریخ باشد، اما اگر اینطور نباشد، ممکن است نتایج غیرمنتظره ای دریافت کنید.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates after June 1, 2022
// and sets it to column A.
let date = new Date("June 1, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateAfter(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

مولفه های

نام	تایپ کنید	شرح
`date`	`Date`	آخرین تاریخ برای پنهان کردن

برگشت

FilterCriteriaBuilder - این سازنده، برای زنجیر کردن.

`whenDateAfter(date)`

معیارهای فیلتر را تنظیم می کند که سلول ها را با تاریخ هایی که بعد از تاریخ نسبی مشخص شده هستند نشان می دهد. برای مشاهده گزینه های تاریخ نسبی، به Enum RelativeDate مراجعه کنید.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates after today's date
// and sets it to column A.
let date = SpreadsheetApp.RelativeDate.TODAY;
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateAfter(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

مولفه های

نام	تایپ کنید	شرح
`date`	`RelativeDate`	آخرین تاریخ نسبی

برگشت

FilterCriteriaBuilder - این سازنده، برای زنجیر کردن.

`whenDateBefore(date)`

معیارهای فیلتر را تنظیم می کند که سلول ها را با تاریخ هایی که قبل از تاریخ مشخص شده هستند نشان می دهد.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates before June 1, 2022
// and sets it to column A.
let date = new Date("June 1, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateBefore(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

مولفه های

نام	تایپ کنید	شرح
`date`	`Date`	اولین تاریخ برای پنهان کردن

برگشت

FilterCriteriaBuilder - این سازنده، برای زنجیر کردن.

`whenDateBefore(date)`

معیارهای فیلتر را تنظیم می کند که سلول هایی را با تاریخ هایی که قبل از تاریخ نسبی مشخص شده هستند نشان می دهد. برای مشاهده گزینه های تاریخ نسبی، به Enum RelativeDate مراجعه کنید.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates before today's date
// and sets it to column A.
let date = SpreadsheetApp.RelativeDate.TODAY;
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateBefore(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

مولفه های

نام	تایپ کنید	شرح
`date`	`RelativeDate`	اولین تاریخ نسبی برای پنهان کردن

برگشت

FilterCriteriaBuilder - این سازنده، برای زنجیر کردن.

`whenDateEqualTo(date)`

معیارهای فیلتر را تنظیم می کند که سلول ها را با تاریخ های برابر با تاریخ مشخص شده نشان می دهد.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates equal to June 1, 2022
// and sets it to column A.
let date = new Date("June 1, 2022");
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateEqualTo(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

مولفه های

نام	تایپ کنید	شرح
`date`	`Date`	تاریخی که مقادیر سلول باید مطابقت داشته باشد.

برگشت

FilterCriteriaBuilder - این سازنده، برای زنجیر کردن.

`whenDateEqualTo(date)`

معیارهای فیلتر را تنظیم می کند که سلول هایی را با تاریخ هایی که برابر با تاریخ نسبی مشخص شده است را نشان می دهد. برای مشاهده گزینه های تاریخ نسبی، به Enum RelativeDate مراجعه کنید.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates that fall within the past month
// and sets it to column A.
let date = SpreadsheetApp.RelativeDate.PAST_MONTH;
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateEqualTo(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

مولفه های

نام	تایپ کنید	شرح
`date`	`RelativeDate`	تاریخ نسبی که مقادیر سلول باید مطابقت داشته باشد.

برگشت

FilterCriteriaBuilder - این سازنده، برای زنجیر کردن.

`whenDateEqualToAny(dates)`

معیارهای فیلتر را برای نشان دادن سلول هایی با تاریخ هایی که برابر با هر یک از تاریخ های مشخص شده است تنظیم می کند.

شما فقط می توانید از این معیار با داده های متصل به پایگاه داده استفاده کنید. به عنوان مثال، از این معیار با فیلترها در برگه DataSource ، صفحه ای که به پایگاه داده متصل است، یا DataSourcePivotTable ، یک جدول محوری ایجاد شده از یک صفحه DataSource استفاده کنید.

// 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 عدد مشخص شده قرار می گیرد، تنظیم می کند.

با هر نوع فیلتری می توانید از این معیار استفاده کنید. اگر از این معیار برای داده هایی استفاده می کنید که به یک پایگاه داده متصل هستند، نوع داده ستونی که بر اساس آن فیلتر می کنید باید یک عدد باشد. اگر داده ها به پایگاه داده متصل نیستند، نیازی نیست که نوع داده ستونی که بر اساس آن فیلتر می کنید عدد باشد، اما اگر اینطور نباشد، ممکن است نتایج غیرمنتظره ای دریافت کنید.

// 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 - این سازنده، برای زنجیر کردن.