لإضافة معايير إلى فلتر ما، يجب عليك تنفيذ ما يلي:
- يمكنك إنشاء أداة إنشاء المعايير باستخدام
SpreadsheetApp.newFilterCriteria()
. - أضِف الإعدادات إلى أداة الإنشاء باستخدام الطرق من هذه الفئة.
- استخدِم
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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
values | String[] | قائمة القيم المطلوب إخفاؤها. |
الإرجاع
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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
visibleBackgroundColor | Color | لون الخلفية المطلوب ضبطه يجب أن يكون اللون بنمط نموذج أحمر أخضر أزرق اللون. لا تتيح هذه الطريقة استخدام ألوان المظاهر. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
setVisibleForegroundColor(visibleForegroundColor)
لضبط لون المقدّمة المُستخدَم كمعايير فلتر ستظل الخلايا التي لون مقدمتها هذا مرئية. يؤدي ضبط معايير فلتر ألوان المقدّمة إلى إزالة أي معايير حالية لفلاتر الألوان. من منصة الإنشاء هذه.
يمكنك استخدام هذه المعايير فقط للفلاتر على Grid
ورق بيانات، وهو الإعداد التلقائي
ونوع الورقة.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that filters by foreground color and sets it to column B. let color = SpreadsheetApp.newColor().setRgbColor("#185ABC").build(); let criteria = SpreadsheetApp.newFilterCriteria() .setVisibleForegroundColor(color) .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
visibleForegroundColor | Color | لون المقدّمة المطلوب ضبطه يجب أن يكون اللون بنمط نموذج أحمر أخضر أزرق اللون. لا تتيح هذه الطريقة استخدام ألوان المظاهر. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
setVisibleValues(values)
تحدد القيم المراد عرضها على الجدول المحوري. يؤدي هذا الإجراء إلى محو أي قيم حالية مرئية أو مخفية.
يمكنك فقط استخدام هذه المعايير للفلاتر على الجداول المحورية غير المرتبطة قاعدة البيانات.
// Gets the active sheet. const ss = SpreadsheetApp.getActiveSheet(); // Gets the first pivot table on the sheet and adds a filter to it that // sets the visible values to "Northeast" and "Southwest." let pivotTable = ss.getPivotTables()[0]; let criteria = SpreadsheetApp.newFilterCriteria() .setVisibleValues(["Northeast", "Southwest"]) .build(); pivotTable.addFilter(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
values | String[] | قائمة القيم المطلوب عرضها. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenCellEmpty()
تضبط معايير الفلتر لإظهار الخلايا الفارغة.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Sets criteria to column B that only shows empty cells. let criteria = SpreadsheetApp.newFilterCriteria() .whenCellEmpty() .build(); filter.setColumnFilterCriteria(2, criteria);
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenCellNotEmpty()
لضبط معايير الفلاتر لعرض الخلايا غير الفارغة.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Sets criteria to column B that only shows cells that aren't empty. let criteria = SpreadsheetApp.newFilterCriteria() .whenCellNotEmpty() .build(); filter.setColumnFilterCriteria(2, criteria);
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenDateAfter(date)
لضبط معايير الفلترة التي تعرض الخلايا التي تحتوي على تواريخ تقع بعد التاريخ المحدّد.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له تاريخًا. إذا كانت البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له يجب أن يكون تاريخًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates after June 1, 2022 // and sets it to column A. let date = new Date("June 1, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateAfter(date) .build(); filter.setColumnFilterCriteria(1, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | Date | أحدث تاريخ للإخفاء |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenDateAfter(date)
لضبط معايير الفلترة التي تعرض الخلايا التي تحتوي على تواريخ تقع بعد التاريخ النسبي المحدّد. إلى
يمكنك الاطّلاع على خيارات التاريخ النسبية، راجِع التعداد RelativeDate
.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له تاريخًا. إذا كانت البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له يجب أن يكون تاريخًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates after today's date // and sets it to column A. let date = SpreadsheetApp.RelativeDate.TODAY; let criteria = SpreadsheetApp.newFilterCriteria() .whenDateAfter(date) .build(); filter.setColumnFilterCriteria(1, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | RelativeDate | أحدث تاريخ نسبي. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenDateBefore(date)
لضبط معايير الفلترة التي تعرض الخلايا التي تحتوي على تواريخ تقع قبل التاريخ المحدّد.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له تاريخًا. إذا كانت البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له يجب أن يكون تاريخًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates before June 1, 2022 // and sets it to column A. let date = new Date("June 1, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateBefore(date) .build(); filter.setColumnFilterCriteria(1, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | Date | أقرب تاريخ تريد إخفاؤه. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenDateBefore(date)
لضبط معايير الفلترة التي تعرض الخلايا التي تحتوي على تواريخ تقع قبل التاريخ النسبي المحدّد.
لعرض خيارات التاريخ النسبية، راجِع التعداد RelativeDate
.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له تاريخًا. إذا كانت البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له يجب أن يكون تاريخًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates before today's date // and sets it to column A. let date = SpreadsheetApp.RelativeDate.TODAY; let criteria = SpreadsheetApp.newFilterCriteria() .whenDateBefore(date) .build(); filter.setColumnFilterCriteria(1, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | RelativeDate | أقرب تاريخ نسبي لإخفائها. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenDateEqualTo(date)
لضبط معايير الفلترة التي تعرض الخلايا التي تحتوي على تواريخ تساوي التاريخ المحدّد.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له تاريخًا. إذا كانت البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له يجب أن يكون تاريخًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates equal to June 1, 2022 // and sets it to column A. let date = new Date("June 1, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateEqualTo(date) .build(); filter.setColumnFilterCriteria(1, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | Date | التاريخ الذي يجب أن تتطابق فيه قيم الخلية. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenDateEqualTo(date)
لضبط معايير الفلترة التي تعرض الخلايا التي تحتوي على تواريخ تساوي التاريخ النسبي المحدّد.
لعرض خيارات التاريخ النسبية، راجِع التعداد RelativeDate
.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له تاريخًا. إذا كانت البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له يجب أن يكون تاريخًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the range. const ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); let filter = range.getFilter(); // Creates criteria that only shows cells with dates that fall within the past month // and sets it to column A. let date = SpreadsheetApp.RelativeDate.PAST_MONTH; let criteria = SpreadsheetApp.newFilterCriteria() .whenDateEqualTo(date) .build(); filter.setColumnFilterCriteria(1, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | RelativeDate | التاريخ النسبي الذي يجب أن تتطابق فيه قيم الخلية. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenDateEqualToAny(dates)
لضبط معايير الفلاتر لعرض الخلايا التي تحتوي على تواريخ تساوي أيًّا من التواريخ المحدّدة.
يمكنك فقط استخدام هذه المعايير مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدم هذه
معايير تحتوي على فلاتر في ورقة DataSource
، وهي ورقة مرتبطة
أو DataSourcePivotTable
، وهو جدول محوري تم إنشاؤه من ورقة DataSource
.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "date" column that shows cells with any of the below dates. let date1 = new Date("June 1, 2022"); let date2 = new Date("June 2, 2022"); let date3 = new Date("June 3, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateEqualToAny([date1, date2, date3]) .build(); dataSheet.addFilter("date", criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
dates | Date[] | التواريخ التي سيتم عرضها. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenDateNotEqualTo(date)
لضبط معايير الفلاتر لعرض الخلايا غير المساوية للتاريخ المحدّد.
يمكنك فقط استخدام هذه المعايير مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدم هذه
معايير تحتوي على فلاتر في ورقة DataSource
، وهي ورقة بيانات مرتبطة
أو DataSourcePivotTable
، وهو جدول محوري تم إنشاؤه من ورقة DataSource
.
يجب أن يكون نوع بيانات العمود الذي تعمل على الفلترة حسبه عبارة عن تاريخ.
// Gets a pivot table that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Pivot Table Sheet"); let dataPivotTable = ss.getDataSourcePivotTables()[0]; // Creates criteria that only shows cells that don't equal June 16, 2022 // and sets it to the "date" column. let date = new Date("June 16, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateNotEqualTo(date) .build(); dataPivotTable.addFilter("date", criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | Date | التاريخ الذي تريد إخفاءه. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenDateNotEqualToAny(dates)
لضبط معايير الفلاتر لعرض الخلايا التي تحتوي على تواريخ لا تساوي أيًا من القيم المحددة التواريخ.
يمكنك فقط استخدام هذه المعايير مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدم هذه
معايير تحتوي على فلاتر في ورقة DataSource
، وهي ورقة مرتبطة
أو DataSourcePivotTable
، وهو جدول محوري تم إنشاؤه من ورقة DataSource
.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "date" column that hides cells with any of the below dates. let date1 = new Date("June 1, 2022"); let date2 = new Date("June 2, 2022"); let date3 = new Date("June 3, 2022"); let criteria = SpreadsheetApp.newFilterCriteria() .whenDateNotEqualToAny([date1, date2, date3]) .build(); dataSheet.addFilter("date", criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
dates | Date[] | التواريخ التي تريد إخفاءها. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenFormulaSatisfied(formula)
تضبط معايير الفلترة لعرض الخلايا ذات صيغة محدّدة (مثل =B:B<C:C
)
يتم تقييمه على true
.
يمكنك فقط استخدام هذه المعايير لفلترة البيانات غير المرتبطة بقاعدة بيانات.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows the rows where the value in column B is less than the value in // column C and sets it to column A. let formula = "=B:B<C:C"; let criteria = SpreadsheetApp.newFilterCriteria() .whenFormulaSatisfied(formula) .build(); filter.setColumnFilterCriteria(1, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
formula | String | صيغة مخصّصة يتم تقييمها إلى true إذا كان الإدخال صالحًا. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenNumberBetween(start, end)
لضبط معايير التصفية لإظهار الخلايا التي تحتوي على عدد يقع بين 2 أو يتوسطه أي منهما أرقام محددة.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that only shows cells with numbers that fall between 1-25, inclusively, // and sets it to column A. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberBetween(1, 25) .build(); filter.setColumnFilterCriteria(1, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
start | Number | أقل رقم يمكن عرضه. |
end | Number | أكبر رقم لعرضه. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenNumberEqualTo(number)
لضبط معايير الفلترة لعرض الخلايا ذات رقم يساوي الرقم المحدَّد.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that only shows cells that are equal to 25 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberEqualTo(25) .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | الرقم المطلوب عرضه. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenNumberEqualToAny(numbers)
لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم يساوي أيًا من القيم المحددة الأرقام.
يمكنك فقط استخدام هذه المعايير مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدم هذه
معايير تحتوي على فلاتر في ورقة DataSource
، وهي ورقة بيانات مرتبطة
أو DataSourcePivotTable
، وهو جدول محوري تم إنشاؤه من ورقة DataSource
.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "amount" column that only shows cells with the number 10, 20, or 30. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberEqualToAny([10,20,30]) .build(); dataSheet.addFilter("amount", criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
numbers | Number[] | الأرقام المراد عرضها. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenNumberGreaterThan(number)
لضبط معايير التصفية لعرض الخلايا التي تحتوي على رقم أكبر من الرقم المحدد
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells greater than 10 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberGreaterThan(10) .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | أكبر رقم تريد إخفاؤه. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenNumberGreaterThanOrEqualTo(number)
لضبط معايير الفلترة لعرض الخلايا التي تحتوي على رقم أكبر من الرقم المحدَّد أو مساوٍ له الصف.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells greater than or equal to 10 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberGreaterThanOrEqualTo(10) .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | أقل رقم يمكن عرضه. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenNumberLessThan(number)
لضبط معايير الفلترة لعرض الخلايا ذات رقم أقل من الرقم المحدَّد.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells less than 10 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberLessThan(10) .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | أقل رقم تريد إخفاؤه. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenNumberLessThanOrEqualTo(number)
لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم أقل من الرقم المحدَّد أو مساوٍ له الصف.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells less than or equal to 10 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberLessThanOrEqualTo(10) .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | أكبر رقم لعرضه. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenNumberNotBetween(start, end)
لضبط معايير الفلتر لإظهار الخلايا التي تحتوي على رقم لا تقع بين القيم 2 ولا تنتمي إلى أي منهما أرقام محددة.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that hides cells with numbers that fall between 1-25, inclusively, // and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberNotBetween(1, 25) .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
start | Number | إخفاء أقل رقم. |
end | Number | أكبر رقم تريد إخفاؤه. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenNumberNotEqualTo(number)
لضبط معايير الفلتر لعرض الخلايا التي تحتوي على رقم لا يساوي العدد المحدّد.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر. إذا كنت تستخدم هذه المعايير مع بيانات متصل بقاعدة بيانات، يجب أن يكون نوع بيانات العمود الذي تقوم بالتصفية وفقًا له رقمًا. في حال حذف البيانات غير مرتبطة بقاعدة بيانات، فإن نوع بيانات العمود الذي تقوم بالتصفية وفقًا له ينبغي أن يكون رقمًا، ولكن إذا لم يكن كذلك، فقد تحصل على نتائج غير متوقعة.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that hides cells that are equal to 25 and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberNotEqualTo(25) .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | الرقم المطلوب إخفاءه. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenNumberNotEqualToAny(numbers)
لضبط معايير الفلتر لعرض الخلايا ذات رقم لا يساوي أيًّا من القيم المحدَّدة الأرقام.
يمكنك فقط استخدام هذه المعايير مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدم هذه
معايير تحتوي على فلاتر في ورقة DataSource
، وهي ورقة مرتبطة
أو DataSourcePivotTable
، وهو جدول محوري تم إنشاؤه من ورقة DataSource
.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "amount" column that hides cells with the number 10, 20, or 30. let criteria = SpreadsheetApp.newFilterCriteria() .whenNumberNotEqualToAny([10,20,30]) .build(); dataSheet.addFilter("amount", criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
numbers | Number[] | الأرقام المطلوب إخفائها. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenTextContains(text)
لضبط معايير الفلاتر لعرض الخلايا التي تحتوي على نص يحتوي على النص المحدَّد النص غير حساس لحالة الأحرف.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells that contain "Northwest" and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenTextContains("Northwest") .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | النص الذي يجب أن تحتوي عليه الخلية. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenTextDoesNotContain(text)
لضبط معايير الفلاتر لعرض الخلايا التي تحتوي على نص لا يحتوي على النص المحدَّد. تشير رسالة الأشكال البيانية النص غير حساس لحالة الأحرف.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that hides cells that contain "Northwest" and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenTextDoesNotContain("Northwest") .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | النص الذي يجب ألا تحتويه الخلية |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenTextEndsWith(text)
لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص ينتهي بالنص المحدّد. النص غير حساس لحالة الأحرف.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells with text that ends with "est" and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenTextEndsWith("est") .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | نص يجب أن تحتوي عليه نهاية نص الخلية. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenTextEqualTo(text)
لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص يساوي النص المحدَّد. النص غير حساس لحالة الأحرف.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells with text that equals "hello" and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenTextEqualTo("hello") .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | النص الذي يجب أن يساويه نص الخلية. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenTextEqualToAny(texts)
لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص يساوي أيًا من النص المحدَّد القيم. النص غير حساس لحالة الأحرف.
يمكنك فقط استخدام هذه المعايير مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدم هذه
معايير تحتوي على فلاتر في ورقة DataSource
، وهي ورقة بيانات مرتبطة
أو DataSourcePivotTable
، وهو جدول محوري تم إنشاؤه من ورقة DataSource
.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "category" column that shows cells with the text "tech" or "business." let criteria = SpreadsheetApp.newFilterCriteria() .whenTextEqualToAny(["tech","business"]) .build(); dataSheet.addFilter("category", criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
texts | String[] | يشير ذلك المصطلح إلى القيم النصية التي يجب أن تساويها الخلية. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenTextNotEqualTo(text)
لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص لا يساوي النص المحدَّد. تشير رسالة الأشكال البيانية النص غير حساس لحالة الأحرف.
يمكنك فقط استخدام هذه المعايير مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدم هذه
معايير تحتوي على فلاتر في ورقة DataSource
، وهي ورقة مرتبطة
أو DataSourcePivotTable
، وهو جدول محوري تم إنشاؤه من ورقة DataSource
.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "category" column that hides cells with text equal to "tech." let criteria = SpreadsheetApp.newFilterCriteria() .whenTextNotEqualTo("tech") .build(); dataSheet.addFilter("category", criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | النص الذي لا يمكن أن يساويه نص الخلية. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenTextNotEqualToAny(texts)
لضبط معايير الفلتر لعرض الخلايا التي تحتوي على نص لا يساوي أيًا من القيم المحددة القيم. النص غير حساس لحالة الأحرف.
يمكنك فقط استخدام هذه المعايير مع البيانات المرتبطة بقاعدة بيانات. على سبيل المثال، استخدم هذه
معايير تحتوي على فلاتر في ورقة DataSource
، وهي ورقة مرتبطة
أو DataSourcePivotTable
، وهو جدول محوري تم إنشاؤه من ورقة DataSource
.
// Gets the sheet that's connected to a database. let ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data Sheet"); let dataSheet = ss.asDataSourceSheet(); // Adds criteria to the "category" column that hides cells with the text "tech" or "business." let criteria = SpreadsheetApp.newFilterCriteria() .whenTextNotEqualToAny(["tech","business"]) .build(); dataSheet.addFilter("category", criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
texts | String[] | يشير ذلك المصطلح إلى القيم النصية التي لا يمكن أن تساويها خلية. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
whenTextStartsWith(text)
لضبط معايير الفلترة لعرض الخلايا التي تحتوي على نص يبدأ بالنص المحدَّد. النص غير حساس لحالة الأحرف.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر.
// Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Creates criteria that shows cells with text that starts with "pre" and sets it to column B. let criteria = SpreadsheetApp.newFilterCriteria() .whenTextStartsWith("pre") .build(); filter.setColumnFilterCriteria(2, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | نص يجب أن تحتوي عليه بداية نص الخلية. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل
withCriteria(criteria, args)
لضبط معايير الفلتر على شرط منطقي تحدده قيم BooleanCriteria
، مثل
باسم CELL_EMPTY
أو NUMBER_GREATER_THAN
. لنسخ الشرط المنطقي من
هناك معايير حالية، حدِّد المعلمات لهذه الطريقة باستخدام getCriteriaType()
وgetCriteriaValues()
على
المعايير الحالية.
يمكنك استخدام هذه المعايير مع أي نوع من الفلاتر، ولكن لا يتم استخدام بعض BooleanCriteria
.
قابلة للتطبيق على جميع الفلاتر.
// Builds a filter criteria that is based on existing boolean conditions from another criteria. // Gets the existing filter on the sheet. const ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); // Gets the existing boolean conditions applied to Column B and adds criteria to column C that // has the same boolean conditions and additional criteria that hides the value, "Northwest." let filter = ss.getFilter(); let filterCriteria = filter.getColumnFilterCriteria(2); let criteria = SpreadsheetApp.newFilterCriteria() .withCriteria(filterCriteria.getCriteriaType(), filterCriteria.getCriteriaValues()) .setHiddenValues(["Northwest"]) .build(); filter.setColumnFilterCriteria(3, criteria);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
criteria | BooleanCriteria | نوع المعايير المنطقية. |
args | Object[] | يشير ذلك المصطلح إلى مصفوفة من الوسيطات المناسبة لنوع المعايير. عدد الوسيطات
يتطابق نوعها مع طرق when...() المقابلة أعلاه. |
الإرجاع
FilterCriteriaBuilder
— أداة الإنشاء هذه، للسلاسل