Class FilterCriteriaBuilder

FilterCriteriaBuilder

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

  1. سازنده معیارها را با استفاده از SpreadsheetApp.newFilterCriteria() ایجاد کنید.
  2. با استفاده از متدهای این کلاس تنظیمات را به سازنده اضافه کنید.
  3. از 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()

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

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

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

بازگشت

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


getVisibleForegroundColor()

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

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

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

بازگشت

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


getVisibleValues()

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

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

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

بازگشت

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


setHiddenValues(values)

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

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

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

پارامترها

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

بازگشت

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

پرتاب می کند

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


setVisibleBackgroundColor(visibleBackgroundColor)

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

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

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

پارامترها

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

بازگشت

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

پرتاب می کند

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


whenCellEmpty()

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

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

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

بازگشت

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


whenCellNotEmpty()

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

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

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

بازگشت

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


whenDateAfter(date)

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

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

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

پارامترها

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

بازگشت

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


whenDateAfter(date)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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