Class FilterCriteriaBuilder

معیارهای فیلتر را با استفاده از تنظیماتی که به سازنده معیار اضافه می‌کنید، جمع‌آوری می‌کند.

// 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 - نمایشی از معیارهای فیلتر.

این معیارهای فیلتر را کپی می‌کند و یک سازنده معیار ایجاد می‌کند که می‌توانید آن را برای فیلتر دیگری اعمال کنید.

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

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

نوع بولی معیار را برمی‌گرداند، برای مثال، CELL_EMPTY . برای کسب اطلاعات بیشتر در مورد انواع معیارهای بولی، به enum 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 — نوع معیارهای بولی، یا اگر معیار یک شرط بولی نباشد، null .

آرایه‌ای از آرگومان‌ها را برای معیارهای بولی برمی‌گرداند. برخی از انواع معیارهای بولی آرگومان ندارند و یک آرایه خالی برمی‌گردانند، برای مثال، 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 مطابقت دارد.

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

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

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

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

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

بازگشت

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

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

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

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

بازگشت

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

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

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

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

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

شما فقط می‌توانید از این معیار برای فیلترها در صفحات 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);

پارامترها

بازگشت

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

پرتاب‌ها

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

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

شما فقط می‌توانید از این معیار برای فیلترها در صفحات 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);

پارامترها

بازگشت

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

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

شما فقط می‌توانید از این معیار برای فیلترها در صفحات 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);

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

پرتاب‌ها

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

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

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

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

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

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

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

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

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

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

پارامترها

بازگشت

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

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

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

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

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

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

معیارهای فیلتر را طوری تنظیم می‌کند که سلول‌هایی با فرمول مشخص‌شده (مانند =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);

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

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

شما فقط می‌توانید از این معیار با داده‌های متصل به یک پایگاه داده استفاده کنید. برای مثال، از این معیار با فیلترهایی در یک برگه 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 "category" column that shows cells with the text "tech"
// or "business."
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenTextEqualToAny(['tech', 'business'])
                     .build();
dataSheet.addFilter('category', criteria);

پارامترها

بازگشت

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

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

شما فقط می‌توانید از این معیار با داده‌های متصل به یک پایگاه داده استفاده کنید. برای مثال، از این معیار با فیلترهایی در یک برگه 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 "category" column that hides cells with text equal to
// "tech."
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextNotEqualTo('tech').build();
dataSheet.addFilter('category', criteria);

پارامترها

بازگشت

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

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

شما فقط می‌توانید از این معیار با داده‌های متصل به یک پایگاه داده استفاده کنید. برای مثال، از این معیار با فیلترهایی در یک برگه 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 "category" column that hides cells with the text "tech"
// or "business."
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenTextNotEqualToAny(['tech', 'business'])
                     .build();
dataSheet.addFilter('category', criteria);

پارامترها

بازگشت

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

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

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

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

پارامترها

بازگشت

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

معیارهای فیلتر را روی یک شرط بولی تعریف شده توسط مقادیر 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);

پارامترها

بازگشت

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