لإضافة معايير إلى فلتر، يجب إجراء ما يلي:
- أنشِئ أداة إنشاء المعايير باستخدام
SpreadsheetApp.newFilterCriteria()
. - يمكنك إضافة الإعدادات إلى أداة الإنشاء باستخدام الطرق من هذه الفئة.
- استخدِم
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 | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
formula | String | صيغة مخصّصة يتم تقييمها إلى 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 | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
number | Number | أعلى رقم يمكن عرضه. |
استرجاع الكرة
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 | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
criteria | BooleanCriteria | نوع المعايير المنطقية. |
args | Object[] | تمثّل هذه السمة مصفوفة من الوسيطات المناسبة لنوع المعايير ويتطابق عدد الوسيطات ونوعها مع طرق when...() المقابلة أعلاه. |
استرجاع الكرة
FilterCriteriaBuilder
: أداة الإنشاء هذه مخصّصة للسلاسل