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

Class FilterCriteriaBuilder

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

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

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

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

نمونه زیر فیلتر موجود یک برگه را دریافت می‌کند و معیارهایی را اضافه می‌کند که سلول‌های ستون C حاوی «hello» یا «world» را پنهان می‌کند. معیارهای این نمونه فقط با فیلترهای روی صفحات Grid ، نوع پیش فرض برگه، قابل استفاده است.

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

فقط سلول های غیر خالی را نشان دهید

نمونه زیر فیلتری را به برگه Data Source اضافه می‌کند، صفحه‌ای که به یک پایگاه داده متصل است، با معیارهایی که فقط سلول‌هایی را در ستون «رده» نشان می‌دهد که خالی نیستند.

// 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()`	`Filter Criteria`	معیارهای فیلتر را با استفاده از تنظیماتی که به سازنده معیار اضافه می کنید جمع آوری می کند.
`copy()`	`Filter Criteria Builder`	این معیار فیلتر را کپی می کند و یک معیارساز ایجاد می کند که می توانید آن را روی فیلتر دیگری اعمال کنید.
`get Criteria Type()`	`Boolean Criteria`	نوع بولی معیار را برمی‌گرداند، به عنوان مثال، `CELL_EMPTY` .
`get Criteria Values()`	`Object[]`	آرایه ای از آرگومان ها را برای معیارهای بولی برمی گرداند.
`get Hidden Values()`	`String[]`	مقادیری را که فیلتر پنهان می کند برمی گرداند.
`get Visible Background Color()`	`Color`	رنگ پس زمینه استفاده شده به عنوان معیار فیلتر را برمی گرداند.
`get Visible Foreground Color()`	`Color`	رنگ پیش زمینه استفاده شده به عنوان معیار فیلتر را برمی گرداند.
`get Visible Values()`	`String[]`	مقادیری را که فیلتر جدول محوری نشان می دهد برمی گرداند.
`set Hidden Values(values)`	`Filter Criteria Builder`	مقادیر را برای پنهان کردن تنظیم می کند.
`set Visible Background Color(visibleBackgroundColor)`	`Filter Criteria Builder`	رنگ پس زمینه مورد استفاده را به عنوان معیار فیلتر تنظیم می کند.
`set Visible Foreground Color(visibleForegroundColor)`	`Filter Criteria Builder`	رنگ پیش زمینه مورد استفاده به عنوان معیار فیلتر را تنظیم می کند.
`set Visible Values(values)`	`Filter Criteria Builder`	مقادیر را برای نمایش در جدول محوری تنظیم می کند.
`when Cell Empty()`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول های خالی تنظیم می کند.
`when Cell Not Empty()`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول هایی که خالی نیستند تنظیم می کند.
`when Date After(date)`	`Filter Criteria Builder`	معیارهای فیلتر را تنظیم می کند که سلول ها را با تاریخ هایی که بعد از تاریخ مشخص شده هستند نشان می دهد.
`when Date After(date)`	`Filter Criteria Builder`	معیارهای فیلتر را تنظیم می کند که سلول ها را با تاریخ هایی که بعد از تاریخ نسبی مشخص شده هستند نشان می دهد.
`when Date Before(date)`	`Filter Criteria Builder`	معیارهای فیلتر را تنظیم می کند که سلول ها را با تاریخ هایی که قبل از تاریخ مشخص شده هستند نشان می دهد.
`when Date Before(date)`	`Filter Criteria Builder`	معیارهای فیلتر را تنظیم می کند که سلول هایی را با تاریخ هایی که قبل از تاریخ نسبی مشخص شده هستند نشان می دهد.
`when Date Equal To(date)`	`Filter Criteria Builder`	معیارهای فیلتر را تنظیم می کند که سلول ها را با تاریخ های برابر با تاریخ مشخص شده نشان می دهد.
`when Date Equal To(date)`	`Filter Criteria Builder`	معیارهای فیلتر را تنظیم می کند که سلول هایی را با تاریخ هایی که برابر با تاریخ نسبی مشخص شده است را نشان می دهد.
`when Date Equal To Any(dates)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول هایی با تاریخ هایی که برابر با هر یک از تاریخ های مشخص شده است تنظیم می کند.
`when Date Not Equal To(date)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول هایی که با تاریخ مشخص شده برابر نیستند تنظیم می کند.
`when Date Not Equal To Any(dates)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول هایی با تاریخ هایی تنظیم می کند که با هیچ یک از تاریخ های مشخص شده برابر نیستند.
`when Formula Satisfied(formula)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول ها با فرمول مشخص (مانند `=B:B<C:C` ) تنظیم می کند که به `true` ارزیابی می شود.
`when Number Between(start, end)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول هایی با عددی که بین 2 عدد مشخص شده قرار می گیرد، تنظیم می کند.
`when Number Equal To(number)`	`Filter Criteria Builder`	معیار فیلتر را طوری تنظیم می کند که سلول هایی با عددی برابر با عدد مشخص شده نشان دهد.
`when Number Equal To Any(numbers)`	`Filter Criteria Builder`	معیار فیلتر را طوری تنظیم می کند که سلول هایی با عددی برابر با هر یک از اعداد مشخص شده نشان دهد.
`when Number Greater Than(number)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول هایی با تعداد بیشتر از تعداد مشخص شده تنظیم می کند
`when Number Greater Than Or Equal To(number)`	`Filter Criteria Builder`	معیارهای فیلتر را طوری تنظیم می کند که سلول هایی با تعداد بیشتر یا مساوی با تعداد مشخص شده نشان دهد.
`when Number Less Than(number)`	`Filter Criteria Builder`	معیارهای فیلتر را طوری تنظیم می کند که سلول هایی با تعداد کمتر از تعداد مشخص شده نشان دهد.
`when Number Less Than Or Equal To(number)`	`Filter Criteria Builder`	معیارهای فیلتر را طوری تنظیم می کند که سلول هایی با تعداد کمتر یا مساوی با تعداد مشخص شده نشان دهد.
`when Number Not Between(start, end)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول‌هایی تنظیم می‌کند که عددی بین آن‌ها قرار نمی‌گیرد و هیچ کدام از 2 عدد مشخص‌شده نیست.
`when Number Not Equal To(number)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول هایی با عددی که با عدد مشخص شده برابر نیست، تنظیم می کند.
`when Number Not Equal To Any(numbers)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول هایی با عددی که با هیچ یک از اعداد مشخص شده برابر نیست تنظیم می کند.
`when Text Contains(text)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نمایش سلول هایی با متنی که حاوی متن مشخص شده است تنظیم می کند.
`when Text Does Not Contain(text)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول هایی با متنی تنظیم می کند که حاوی متن مشخص شده نیست.
`when Text Ends With(text)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نمایش سلول هایی با متنی که به متن مشخص شده ختم می شود، تنظیم می کند.
`when Text Equal To(text)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول هایی با متنی برابر با متن مشخص شده تنظیم می کند.
`when Text Equal To Any(texts)`	`Filter Criteria Builder`	معیار فیلتر را برای نشان دادن سلول هایی با متنی که برابر با هر یک از مقادیر متن مشخص شده است تنظیم می کند.
`when Text Not Equal To(text)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول هایی با متنی که با متن مشخص شده برابری نمی کند، تنظیم می کند.
`when Text Not Equal To Any(texts)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نشان دادن سلول هایی با متنی تنظیم می کند که با هیچ یک از مقادیر مشخص شده برابر نیست.
`when Text Starts With(text)`	`Filter Criteria Builder`	معیارهای فیلتر را برای نمایش سلول هایی با متنی که با متن مشخص شده شروع می شود، تنظیم می کند.
`with Criteria(criteria, args)`	`Filter Criteria Builder`	معیارهای فیلتر را روی یک شرایط بولی که با مقادیر `Boolean Criteria` ، مانند `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);

بازگشت

Filter Criteria - نمایشی از معیارهای فیلتر.

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

بازگشت

Filter Criteria Builder - یک سازنده معیار فیلتر بر اساس این معیار فیلتر.

`get Criteria Type()`

نوع بولی معیار را برمی‌گرداند، به عنوان مثال، CELL_EMPTY . برای آشنایی با انواع معیارهای بولی، به فهرست Boolean Criteria مراجعه کنید.

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

برای بدست آوردن آرگومان های معیارها، get Criteria Values() استفاده کنید.
برای استفاده از نوع معیار و مقادیر معیار برای ایجاد یا اصلاح معیارهای فیلتر، with Criteria(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);

بازگشت

Boolean Criteria - نوع معیار بولی، یا اگر معیار شرط بولی نباشد، null .

`get Criteria Values()`

آرایه ای از آرگومان ها را برای معیارهای بولی برمی گرداند. برخی از انواع معیارهای بولی آرگومان ندارند و یک آرایه خالی برمی‌گردانند، به عنوان مثال، CELL_NOT_EMPTY .

برای دریافت نوع معیار بولی، get Criteria Type() استفاده کنید.
برای استفاده از نوع معیار و مقادیر معیار برای ایجاد یا اصلاح یک معیار فیلتر، with Criteria(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[] - آرایه ای از آرگومان های متناسب با نوع معیار بولی. تعداد آرگومان‌ها و نوع آنها با متد when...() کلاس Filter Criteria Builder مطابقت دارد.

`get Hidden Values()`

مقادیری را که فیلتر پنهان می کند برمی گرداند.

از این معیار با فیلترها در صفحات 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[] - آرایه ای از مقادیر که فیلتر پنهان می کند.

`get Visible Background Color()`

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

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 - رنگ پس زمینه به عنوان معیار فیلتر استفاده می شود.

`get Visible Foreground Color()`

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

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 - رنگ پیش زمینه که به عنوان معیار فیلتر استفاده می شود.

`get Visible Values()`

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

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

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[] - آرایه ای از مقادیری که فیلتر جدول محوری نشان می دهد.

`set Hidden Values(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[]`	لیست مقادیر برای پنهان کردن

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

پرتاب می کند

Error - اگر هر یک از مقادیر null باشد.

`set Visible Background Color(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);

پارامترها

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

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`set Visible Foreground Color(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);

پارامترها

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

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`set Visible Values(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[]`	لیست مقادیر برای نمایش

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

پرتاب می کند

Error - اگر هر یک از مقادیر null باشد.

`when Cell Empty()`

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

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

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

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Cell Not Empty()`

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

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

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

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Date After(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`	آخرین تاریخ برای پنهان کردن

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Date After(date)`

معیارهای فیلتر را تنظیم می کند که سلول ها را با تاریخ هایی که بعد از تاریخ نسبی مشخص شده هستند نشان می دهد. برای مشاهده گزینه های تاریخ نسبی، به Enum Relative 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 today's date
// and sets it to column A.

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

پارامترها

نام	تایپ کنید	توضیحات
`date`	`Relative Date`	آخرین تاریخ نسبی

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Date Before(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`	اولین تاریخ برای پنهان کردن

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Date Before(date)`

معیارهای فیلتر را تنظیم می کند که سلول هایی را با تاریخ هایی که قبل از تاریخ نسبی مشخص شده هستند نشان می دهد. برای مشاهده گزینه های تاریخ نسبی، به Enum Relative 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 today's date
// and sets it to column A.

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

پارامترها

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

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Date Equal To(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`	تاریخی که مقادیر سلول باید مطابقت داشته باشد.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Date Equal To(date)`

معیارهای فیلتر را تنظیم می کند که سلول هایی را با تاریخ هایی که برابر با تاریخ نسبی مشخص شده است را نشان می دهد. برای مشاهده گزینه های تاریخ نسبی، به Enum Relative 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 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`	`Relative Date`	تاریخ نسبی که مقادیر سلول باید مطابقت داشته باشد.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Date Equal To Any(dates)`

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

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

// 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[]`	تاریخ هایی که باید نمایش داده شود.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Date Not Equal To(date)`

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

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

// 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`	تاریخ پنهان کردن

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Date Not Equal To Any(dates)`

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

// 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[]`	تاریخ هایی که باید پنهان شوند

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Formula Satisfied(formula)`

معیارهای فیلتر را برای نشان دادن سلول ها با فرمول مشخص (مانند =B:B<C:C ) تنظیم می کند که به true ارزیابی می شود.

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

// 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` ارزیابی می شود.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Number Between(start, end)`

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

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

// 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`	بالاترین عدد برای نمایش

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Number Equal To(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`	عدد برای نشان دادن

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Number Equal To Any(numbers)`

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

// 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[]`	اعداد برای نشان دادن

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Number Greater Than(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`	بیشترین تعداد برای پنهان کردن.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Number Greater Than Or Equal To(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`	کمترین عدد برای نمایش

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Number Less Than(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`	کمترین عدد برای پنهان کردن

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Number Less Than Or Equal To(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`	بالاترین عدد برای نمایش

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Number Not Between(start, end)`

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

// 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`	بیشترین تعداد برای پنهان کردن.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Number Not Equal To(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`	شماره ای که باید پنهان شود.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Number Not Equal To Any(numbers)`

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

// 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[]`	اعدادی که باید پنهان شوند

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Text Contains(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`	متنی که سلول باید حاوی آن باشد.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Text Does Not Contain(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`	متنی که سلول نباید حاوی آن باشد.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Text Ends With(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`	متنی که انتهای متن سلول باید حاوی آن باشد.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Text Equal To(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`	متنی که متن سلول باید برابر باشد.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Text Equal To Any(texts)`

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

// 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[]`	مقادیر متنی که یک سلول باید برابر باشد.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Text Not Equal To(text)`

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

// 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`	متنی که متن سلول نمی تواند برابر باشد.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Text Not Equal To Any(texts)`

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

// 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[]`	مقادیر متنی که یک سلول نمی تواند برابر باشد.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`when Text Starts With(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`	متنی که ابتدای متن سلول باید حاوی آن باشد.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.

`with Criteria(criteria, args)`

معیارهای فیلتر را روی یک شرایط بولی که با مقادیر Boolean Criteria ، مانند CELL_EMPTY یا NUMBER_GREATER_THAN تعریف شده است، تنظیم می کند. برای کپی شرط بولی از معیارهای موجود، پارامترهای این متد را با استفاده از get Criteria Type() تعریف کنید و get Criteria Values() .

شما می توانید این معیار را با هر نوع فیلتری استفاده کنید، اما برخی از Boolean Criteria برای همه فیلترها قابل اجرا نیستند.

// 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`	`Boolean Criteria`	نوع معیارهای بولی
`args`	`Object[]`	آرایه ای از آرگومان های متناسب با نوع معیار؛ تعداد آرگومان‌ها و نوع آن‌ها با متدهای `when...()` بالا مطابقت دارد.

بازگشت

Filter Criteria Builder - این سازنده، برای زنجیره زدن.