Class FilterCriteriaBuilder

FilterCriteriaBuilder

لإضافة معايير إلى فلتر ما، يجب عليك تنفيذ ما يلي:

  1. يمكنك إنشاء أداة إنشاء المعايير باستخدام SpreadsheetApp.newFilterCriteria().
  2. أضِف الإعدادات إلى أداة الإنشاء باستخدام الطرق من هذه الفئة.
  3. استخدِم build() لتجميع المعايير باستخدام الإعدادات التي حدّدتها.

طرق الاستخدام الشائعة

إخفاء القيم في ورقة بيانات

يحصل النموذج التالي على الفلتر الحالي للورقة ويضيف معايير تخفي الخلايا في العمود C الذي يحتوي على "hello" أو "العالم". لا يمكن استخدام المعايير في هذه العينة إلا مع الفلاتر في 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);

المعلمات

الاسمالنوعالوصف
valuesString[]قائمة القيم المطلوب إخفاؤها.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
visibleBackgroundColorColorلون الخلفية المطلوب ضبطه يجب أن يكون اللون بنمط نموذج أحمر أخضر أزرق اللون. لا تتيح هذه الطريقة استخدام ألوان المظاهر.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


setVisibleForegroundColor(visibleForegroundColor)

لضبط لون المقدّمة المُستخدَم كمعايير فلتر ستظل الخلايا التي لون مقدمتها هذا مرئية. يؤدي ضبط معايير فلتر ألوان المقدّمة إلى إزالة أي معايير حالية لفلاتر الألوان. من منصة الإنشاء هذه.

يمكنك استخدام هذه المعايير فقط للفلاتر على Grid ورق بيانات، وهو الإعداد التلقائي ونوع الورقة.

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

المعلمات

الاسمالنوعالوصف
visibleForegroundColorColorلون المقدّمة المطلوب ضبطه يجب أن يكون اللون بنمط نموذج أحمر أخضر أزرق اللون. لا تتيح هذه الطريقة استخدام ألوان المظاهر.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


setVisibleValues(values)

تحدد القيم المراد عرضها على الجدول المحوري. يؤدي هذا الإجراء إلى محو أي قيم حالية مرئية أو مخفية.

يمكنك فقط استخدام هذه المعايير للفلاتر على الجداول المحورية غير المرتبطة قاعدة البيانات.

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

المعلمات

الاسمالنوعالوصف
valuesString[]قائمة القيم المطلوب عرضها.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل

الرميات

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

المعلمات

الاسمالنوعالوصف
dateDateأحدث تاريخ للإخفاء

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenDateAfter(date)

لضبط معايير الفلترة التي تعرض الخلايا التي تحتوي على تواريخ تقع بعد التاريخ النسبي المحدّد. إلى يمكنك الاطّلاع على خيارات التاريخ النسبية، راجِع التعداد RelativeDate.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له تاريخًا. إذا كانت البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له يجب أن يكون تاريخًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

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

المعلمات

الاسمالنوعالوصف
dateRelativeDateأحدث تاريخ نسبي.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenDateBefore(date)

لضبط معايير الفلترة التي تعرض الخلايا التي تحتوي على تواريخ تقع قبل التاريخ المحدّد.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له تاريخًا. إذا كانت البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له يجب أن يكون تاريخًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

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

المعلمات

الاسمالنوعالوصف
dateDateأقرب تاريخ تريد إخفاؤه.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenDateBefore(date)

لضبط معايير الفلترة التي تعرض الخلايا التي تحتوي على تواريخ تقع قبل التاريخ النسبي المحدّد. لعرض خيارات التاريخ النسبية، راجِع التعداد RelativeDate.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له تاريخًا. إذا كانت البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له يجب أن يكون تاريخًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

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

المعلمات

الاسمالنوعالوصف
dateRelativeDateأقرب تاريخ نسبي لإخفائها.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenDateEqualTo(date)

لضبط معايير الفلترة التي تعرض الخلايا التي تحتوي على تواريخ تساوي التاريخ المحدّد.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له تاريخًا. إذا كانت البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له يجب أن يكون تاريخًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

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

المعلمات

الاسمالنوعالوصف
dateDateالتاريخ الذي يجب أن تتطابق فيه قيم الخلية.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenDateEqualTo(date)

لضبط معايير الفلترة التي تعرض الخلايا التي تحتوي على تواريخ تساوي التاريخ النسبي المحدّد. لعرض خيارات التاريخ النسبية، راجِع التعداد RelativeDate.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له تاريخًا. إذا كانت البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له يجب أن يكون تاريخًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

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

المعلمات

الاسمالنوعالوصف
dateRelativeDateالتاريخ النسبي الذي يجب أن تتطابق فيه قيم الخلية.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenDateEqualToAny(dates)

لضبط معايير الفلاتر لعرض الخلايا التي تحتوي على تواريخ تساوي أيًّا من التواريخ المحدّدة.

يمكنك فقط استخدام هذه المعايير مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدم هذه معايير تحتوي على فلاتر في ورقة DataSource، وهي ورقة مرتبطة أو 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);

المعلمات

الاسمالنوعالوصف
datesDate[]التواريخ التي سيتم عرضها.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
dateDateالتاريخ الذي تريد إخفاءه.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
datesDate[]التواريخ التي تريد إخفاءها.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
formulaStringصيغة مخصّصة يتم تقييمها إلى true إذا كان الإدخال صالحًا.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenNumberBetween(start, end)

لضبط معايير التصفية لإظهار الخلايا التي تحتوي على عدد يقع بين 2 أو يتوسطه أي منهما أرقام محددة.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that only shows cells with numbers that fall between 1-25, inclusively,
// and sets it to column A.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberBetween(1, 25)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

المعلمات

الاسمالنوعالوصف
startNumberأقل رقم يمكن عرضه.
endNumberأكبر رقم لعرضه.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenNumberEqualTo(number)

لضبط معايير الفلترة لعرض الخلايا ذات رقم يساوي الرقم المحدَّد.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that only shows cells that are equal to 25 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberEqualTo(25)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسمالنوعالوصف
numberNumberالرقم المطلوب عرضه.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenNumberEqualToAny(numbers)

لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم يساوي أيًا من القيم المحددة الأرقام.

يمكنك فقط استخدام هذه المعايير مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدم هذه معايير تحتوي على فلاتر في ورقة DataSource، وهي ورقة مرتبطة أو 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);

المعلمات

الاسمالنوعالوصف
numbersNumber[]الأرقام المراد عرضها.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenNumberGreaterThan(number)

لضبط معايير التصفية لعرض الخلايا التي تحتوي على رقم أكبر من الرقم المحدد

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells greater than 10 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberGreaterThan(10)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسمالنوعالوصف
numberNumberأكبر رقم تريد إخفاؤه.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenNumberGreaterThanOrEqualTo(number)

لضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم أكبر من الرقم المحدَّد أو مساوٍ له الصف.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells greater than or equal to 10 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberGreaterThanOrEqualTo(10)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسمالنوعالوصف
numberNumberأقل رقم يمكن عرضه.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenNumberLessThan(number)

لضبط معايير الفلترة لعرض الخلايا ذات رقم أقل من الرقم المحدَّد.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells less than 10 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberLessThan(10)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسمالنوعالوصف
numberNumberأقل رقم تريد إخفاؤه.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenNumberLessThanOrEqualTo(number)

لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم أقل من الرقم المحدَّد أو مساوٍ له الصف.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells less than or equal to 10 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberLessThanOrEqualTo(10)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسمالنوعالوصف
numberNumberأكبر رقم لعرضه.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenNumberNotBetween(start, end)

لضبط معايير الفلتر لإظهار الخلايا التي تحتوي على رقم لا تقع بين القيم 2 ولا تنتمي إلى أي منهما أرقام محددة.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that hides cells with numbers that fall between 1-25, inclusively,
// and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberNotBetween(1, 25)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسمالنوعالوصف
startNumberإخفاء أقل رقم.
endNumberأكبر رقم تريد إخفاؤه.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenNumberNotEqualTo(number)

لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم لا يساوي العدد المحدّد.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that hides cells that are equal to 25 and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenNumberNotEqualTo(25)
                             .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسمالنوعالوصف
numberNumberالرقم المطلوب إخفاءه.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenNumberNotEqualToAny(numbers)

لضبط معايير الفلتر لعرض الخلايا ذات رقم لا يساوي أيًّا من القيم المحدَّدة الأرقام.

يمكنك فقط استخدام هذه المعايير مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدم هذه معايير تحتوي على فلاتر في ورقة DataSource، وهي ورقة مرتبطة أو 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);

المعلمات

الاسمالنوعالوصف
numbersNumber[]الأرقام المطلوب إخفائها.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenTextContains(text)

لضبط معايير الفلاتر لعرض الخلايا التي تحتوي على نص يحتوي على النص المحدَّد النص غير حساس لحالة الأحرف.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells that contain "Northwest" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextContains("Northwest")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسمالنوعالوصف
textStringالنص الذي يجب أن تحتوي عليه الخلية.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenTextDoesNotContain(text)

لضبط معايير الفلاتر لعرض الخلايا التي تحتوي على نص لا يحتوي على النص المحدَّد. تشير رسالة الأشكال البيانية النص غير حساس لحالة الأحرف.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that hides cells that contain "Northwest" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextDoesNotContain("Northwest")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسمالنوعالوصف
textStringالنص الذي يجب ألا تحتويه الخلية

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenTextEndsWith(text)

لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص ينتهي بالنص المحدّد. النص غير حساس لحالة الأحرف.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells with text that ends with "est" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEndsWith("est")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسمالنوعالوصف
textStringنص يجب أن تحتوي عليه نهاية نص الخلية.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenTextEqualTo(text)

لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص يساوي النص المحدَّد. النص غير حساس لحالة الأحرف.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells with text that equals "hello" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextEqualTo("hello")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسمالنوعالوصف
textStringالنص الذي يجب أن يساويه نص الخلية.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenTextEqualToAny(texts)

لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص يساوي أيًا من النص المحدَّد القيم. النص غير حساس لحالة الأحرف.

يمكنك فقط استخدام هذه المعايير مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدم هذه معايير تحتوي على فلاتر في ورقة DataSource، وهي ورقة مرتبطة أو 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);

المعلمات

الاسمالنوعالوصف
textsString[]يشير ذلك المصطلح إلى القيم النصية التي يجب أن تساويها الخلية.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
textStringالنص الذي لا يمكن أن يساويه نص الخلية.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
textsString[]يشير ذلك المصطلح إلى القيم النصية التي لا يمكن أن تساويها خلية.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


whenTextStartsWith(text)

لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص يبدأ بالنص المحدَّد. النص غير حساس لحالة الأحرف.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows cells with text that starts with "pre" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextStartsWith("pre")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

المعلمات

الاسمالنوعالوصف
textStringنص يجب أن تحتوي عليه بداية نص الخلية.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل


withCriteria(criteria, args)

لضبط معايير الفلتر على شرط منطقي تحدده قيم BooleanCriteria، مثل باسم CELL_EMPTY أو NUMBER_GREATER_THAN. لنسخ الشرط المنطقي من المعايير الحالية، حدد المعلمات لهذه الطريقة باستخدام getCriteriaType() وgetCriteriaValues() على المعايير الحالية.

يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر، ولكن لا يتم استخدام بعض BooleanCriteria. قابلة للتطبيق على جميع الفلاتر.

// Builds a filter criteria that is based on existing boolean conditions from another criteria.
// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Gets the existing boolean conditions applied to Column B and adds criteria to column C that
// has the same boolean conditions and additional criteria that hides the value, "Northwest."
let filter = ss.getFilter();
let filterCriteria = filter.getColumnFilterCriteria(2);
let criteria = SpreadsheetApp.newFilterCriteria()
    .withCriteria(filterCriteria.getCriteriaType(), filterCriteria.getCriteriaValues())
    .setHiddenValues(["Northwest"])
    .build();
filter.setColumnFilterCriteria(3, criteria);

المعلمات

الاسمالنوعالوصف
criteriaBooleanCriteriaنوع المعايير المنطقية.
argsObject[]يشير ذلك المصطلح إلى مصفوفة من الوسيطات المناسبة لنوع المعايير. عدد الوسيطات يتطابق نوعها مع طرق when...() المقابلة المذكورة أعلاه.

الإرجاع

FilterCriteriaBuilder — أداة الإنشاء هذه، للسلاسل