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لضبط معايير التصفية لعرض الخلايا التي تحتوي على رقم يقع بين رقمين محددين أو يمثلون أيًا منهما.
whenNumberEqualTo(number)FilterCriteriaBuilderلضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم يساوي الرقم المحدد.
whenNumberEqualToAny(numbers)FilterCriteriaBuilderلتعيين معايير التصفية لعرض الخلايا التي تحتوي على رقم يساوي أي من الأرقام المحددة.
whenNumberGreaterThan(number)FilterCriteriaBuilderلضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم أكبر من الرقم المحدد
whenNumberGreaterThanOrEqualTo(number)FilterCriteriaBuilderلضبط معايير التصفية لعرض الخلايا التي تحتوي على رقم أكبر من أو يساوي الرقم المحدد.
whenNumberLessThan(number)FilterCriteriaBuilderلضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم أقل من الرقم المحدد.
whenNumberLessThanOrEqualTo(number)FilterCriteriaBuilderلضبط معايير التصفية لعرض الخلايا التي تحتوي على رقم أقل من أو يساوي الرقم المحدد.
whenNumberNotBetween(start, end)FilterCriteriaBuilderلتعيين معايير التصفية لإظهار الخلايا التي تحتوي على رقم لا تقع بين رقمين محددين وأيهما ليس أي منهما.
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);

المَعلمات

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

استرجاع الكرة

FilterCriteriaBuilder: أداة الإنشاء هذه مخصّصة للسلاسل


setVisibleBackgroundColor(visibleBackgroundColor)

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

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

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

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

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

استرجاع الكرة

FilterCriteriaBuilder: أداة الإنشاء هذه مخصّصة للسلاسل


whenCellEmpty()

تحدِّد معايير الفلترة لعرض الخلايا الفارغة.

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

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

استرجاع الكرة

FilterCriteriaBuilder: أداة الإنشاء هذه مخصّصة للسلاسل


whenCellNotEmpty()

تحدِّد معايير الفلترة لعرض الخلايا غير الفارغة.

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

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

استرجاع الكرة

FilterCriteriaBuilder: أداة الإنشاء هذه مخصّصة للسلاسل


whenDateAfter(date)

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

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

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

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

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

استرجاع الكرة

FilterCriteriaBuilder: أداة الإنشاء هذه مخصّصة للسلاسل


whenNumberBetween(start, end)

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

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

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

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

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

استرجاع الكرة

FilterCriteriaBuilder: أداة الإنشاء هذه مخصّصة للسلاسل


whenNumberNotBetween(start, end)

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

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

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

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
criteriaBooleanCriteriaنوع المعايير المنطقية.
argsObject[]تمثّل هذه السمة مصفوفة من الوسيطات المناسبة لنوع المعايير ويتطابق عدد الوسيطات ونوعها مع طرق when...() المقابلة أعلاه.

استرجاع الكرة

FilterCriteriaBuilder: أداة الإنشاء هذه مخصّصة للسلاسل