इस पेज का अनुवाद Cloud Translation API से किया गया है.

Class FilterCriteriaBuilder

किसी फ़िल्टर में शर्तें जोड़ने के लिए, आपको ये काम करने होंगे:

SpreadsheetApp.newFilterCriteria() का इस्तेमाल करके, मानदंड बनाएं.
इस क्लास के तरीकों का इस्तेमाल करके, बिल्डर में सेटिंग जोड़ें.
अपनी तय की गई सेटिंग के साथ शर्तें जोड़ने के लिए, build() का इस्तेमाल करें.

सामान्य इस्तेमाल

शीट पर वैल्यू छिपाएं

नीचे दिए गए नमूने को शीट का मौजूदा फ़िल्टर दिया गया है. इसमें ऐसी शर्तें जोड़ी गई हैं जो कॉलम C में उन सेल को छिपा देती हैं जिनमें "नमस्ते" या "दुनिया" शामिल है. इस सैंपल में दी गई शर्तों का इस्तेमाल, सिर्फ़ 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`	फ़िल्टर में `CELL_EMPTY` या `NUMBER_GREATER_THAN` जैसी `BooleanCriteria` वैल्यू से तय की गई बूलियन कंडिशन को सेट करता है.

ज़्यादा जानकारी के साथ दस्तावेज़

`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 enum देखें.

अक्सर लोग इस तरीके का इस्तेमाल, किसी फ़िल्टर में बूलियन कंडीशनल शर्त जोड़ने के लिए करते हैं. इसके लिए, उन्हें मौजूदा शर्त को बदलना नहीं पड़ता.

शर्तों के तर्क पाने के लिए, 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[] — बूलियन मानदंड टाइप के हिसाब से सही तर्कों का कलेक्शन. तर्कों की संख्या और उनके टाइप, FilterCriteriaBuilder क्लास के when...() तरीके से मेल खाते हैं.

`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()`

फ़िल्टर की शर्तों के तौर पर इस्तेमाल किया गया बैकग्राउंड कलर दिखाता है. इस रंग के बैकग्राउंड वाली सेल दिखती रहेंगी.

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()`

फ़िल्टर की शर्तों के तौर पर इस्तेमाल किए गए फ़ोरग्राउंड रंग को दिखाता है. इस फ़ोरग्राउंड रंग वाली सेल दिखती रहेंगी.

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

फ़िल्टर की शर्तों के तौर पर इस्तेमाल किया जाने वाला बैकग्राउंड कलर सेट करता है. इस रंग के बैकग्राउंड वाली सेल दिखती रहेंगी. बैकग्राउंड कलर फ़िल्टर की शर्तें सेट करने से, इस बिल्डर से कलर फ़िल्टर से जुड़ी मौजूदा शर्तें हट जाती हैं.

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

फ़िल्टर की शर्तों के तौर पर इस्तेमाल किए जाने वाले फ़ोरग्राउंड का रंग सेट करता है. इस फ़ोरग्राउंड रंग वाली सेल दिखती रहेंगी. फ़ोरग्राउंड कलर फ़िल्टर की शर्तें सेट करने पर, इस बिल्डर से कलर फ़िल्टर से जुड़ी मौजूदा शर्तें हट जाती हैं.

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

फ़िल्टर की शर्तें सेट करता है, जो तय की गई मिलती-जुलती तारीख के बाद की तारीखों वाली सेल दिखाता है. मिलती-जुलती तारीख के विकल्प देखने के लिए, Enum 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)`

फ़िल्टर की शर्तें सेट करता है. इससे तय की गई तारीख से पहले की तारीखों वाली सेल दिखती हैं. मिलती-जुलती तारीख के विकल्प देखने के लिए, Enum 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)`

फ़िल्टर की शर्तें सेट करता है. इससे उन सेल को दिखाया जाता है जिनकी तारीख तय की गई तारीख के बराबर होती है. मिलती-जुलती तारीख के विकल्प देखने के लिए, Enum 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)`

यह फ़िल्टर मानदंड सेट करके, उन सेल को दिखाता है जो तय तारीख के बराबर नहीं हैं.

जिस कॉलम के लिए फ़िल्टर लगाया जा रहा है उसके डेटा टाइप में तारीख होनी चाहिए.

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

यह फ़िल्टर मानदंड सेट करके, उन सेल को दिखाता है जिनकी तारीख तय की गई तारीख से अलग होती है.

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

किसी भी तय की गई संख्या के बराबर संख्या वाले सेल दिखाने के लिए, फ़िल्टर के लिए शर्तें सेट करता है.

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

यह फ़िल्टर, बताई गई किसी भी संख्या से मेल न खाने वाली संख्या वाली सेल दिखाने के लिए, फ़िल्टर के लिए शर्तें सेट करता है.

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

तय किए गए किसी भी टेक्स्ट वैल्यू के बराबर टेक्स्ट वाले सेल दिखाने के लिए, फ़िल्टर करने की शर्त सेट करता है. टेक्स्ट केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) नहीं होता है.

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

तय किए गए टेक्स्ट के बराबर न होने वाले टेक्स्ट वाले सेल दिखाने के लिए, फ़िल्टर करने की शर्त सेट करता है. टेक्स्ट केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) नहीं होता है.

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

तय की गई किसी भी वैल्यू से मेल न खाने वाले टेक्स्ट वाले सेल दिखाने के लिए, फ़िल्टर करने की शर्त सेट करता है. टेक्स्ट केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) नहीं होता है.

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

फ़िल्टर में CELL_EMPTY या NUMBER_GREATER_THAN जैसी BooleanCriteria वैल्यू से तय की गई बूलियन कंडिशन को सेट करता है. मौजूदा शर्त से बूलियन कंडिशन को कॉपी करने के लिए, मौजूदा शर्त पर 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 — यह बिल्डर, चेन बनाने के लिए है.