Class FilterCriteriaBuilder

FilterCriteriaBuilder

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

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

सामान्य तौर पर क्वेरी की सूची का इस्तेमाल इस तरह किया जाता है

किसी शीट पर वैल्यू छिपाना

यहां दिए गए सैंपल में, किसी शीट के मौजूदा फ़िल्टर को पाने और ऐसे मानदंड जोड़ने का तरीका बताया गया है जिनसे कॉलम C में मौजूद "hello" या "world" वाले सेल छिप जाते हैं. इस सैंपल में दिए गए मानदंड का इस्तेमाल सिर्फ़ Grid शीट पर फ़िल्टर के साथ किया जा सकता है. यह डिफ़ॉल्ट रूप से इस्तेमाल की जाने वाली शीट होती है. 
const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setHiddenValues(['hello', 'world'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

सिर्फ़ वे सेल दिखाएं जिनमें कोई वैल्यू मौजूद है

यहां दिए गए सैंपल में, DataSource शीट में एक फ़िल्टर जोड़ा गया है. यह शीट, डेटाबेस से कनेक्ट होती है. इसमें ऐसी शर्त दी गई है कि "कैटेगरी" कॉलम में सिर्फ़ वे सेल दिखें जिनमें कोई वैल्यू मौजूद है. 
// Gets the sheet named "Connected sheet," which is connected to a database.
const sheet = SpreadsheetApp.getActiveSpreadsheet()
                  .getSheetByName('Connected sheet')
                  .asDataSourceSheet();
// Creates criteria that only shows non-empty cells.
const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();
// Applies the criteria to the column named "Category."
sheet.addFilter('Category', criteria);

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
build()FilterCriteriaयह फ़ंक्शन, मानदंड बिल्डर में जोड़ी गई सेटिंग का इस्तेमाल करके फ़िल्टर के मानदंड बनाता है.
copy()FilterCriteriaBuilderयह फ़िल्टर करने की शर्त को कॉपी करता है और एक शर्त बनाने वाला टूल बनाता है. इस टूल को किसी दूसरे फ़िल्टर पर लागू किया जा सकता है.
getCriteriaType()BooleanCriteria|nullयह मानदंड के बूलियन टाइप को दिखाता है. उदाहरण के लिए, CELL_EMPTY.
getCriteriaValues()Object[]यह फ़ंक्शन, बूलियन शर्तों के लिए आर्ग्युमेंट की एक सरणी दिखाता है.
getHiddenValues()String[]यह फ़ंक्शन, उन वैल्यू को दिखाता है जिन्हें फ़िल्टर छिपा देता है.
getVisibleBackgroundColor()Color|nullयह फ़िल्टर के मानदंड के तौर पर इस्तेमाल किए गए बैकग्राउंड के रंग को दिखाता है.
getVisibleForegroundColor()Color|nullयह फ़ंक्शन, फ़िल्टर करने की शर्त के तौर पर इस्तेमाल किए गए फ़ोरग्राउंड कलर को दिखाता है.
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();
const filter = ss.getFilter();
const criteria = SpreadsheetApp
                     .newFilterCriteria()  // Creates a criteria builder.
                     .whenCellNotEmpty()   // Adds settings to the builder.
                     .build();             // Assembles the criteria.
filter.setColumnFilterCriteria(2, criteria);

वापसी का टिकट

FilterCriteria — फ़िल्टर करने की शर्त को दिखाता है.

copy()

यह फ़िल्टर करने की शर्त को कॉपी करता है और एक शर्त बनाने वाला टूल बनाता है. इस टूल को किसी दूसरे फ़िल्टर पर लागू किया जा सकता है.

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

const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
// Makes a copy of the filter criteria applied to column C.
const 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 दिखाता है. 

const ss = SpreadsheetApp.getActiveSheet();
// Gets the filter on the active sheet.
const filter = ss.getFilter();
// Gets the criteria type and returns a string representing the criteria type
// object.
const criteriaType =
    filter.getColumnFilterCriteria(2).getCriteriaType().toString();
// Logs the criteria type.
console.log(criteriaType);

वापसी का टिकट

BooleanCriteria|null — बूलियन मानदंड का टाइप या null, अगर मानदंड बूलियन शर्त नहीं है.

getCriteriaValues()

यह फ़ंक्शन, बूलियन शर्तों के लिए आर्ग्युमेंट की एक सरणी दिखाता है. कुछ बूलियन शर्तों के टाइप में आर्ग्युमेंट नहीं होते और वे एक खाली अरे दिखाते हैं. उदाहरण के लिए, CELL_NOT_EMPTY.

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

  • बूलियन मानदंड टाइप पाने के लिए, getCriteriaType() का इस्तेमाल करें.
  • फ़िल्टर की शर्त बनाने या उसमें बदलाव करने के लिए, शर्त के टाइप और शर्त की वैल्यू का इस्तेमाल करने के बारे में जानने के लिए, withCriteria(criteria, args) देखें.

    इस तरीके का इस्तेमाल, किसी भी तरह के फ़िल्टर के लिए किया जा सकता है. 

    const ss = SpreadsheetApp.getActiveSheet();
const 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.
const criteriaValues = filter.getColumnFilterCriteria(2).getCriteriaValues();
console.log(criteriaValues);

    वापसी का टिकट

    Object[] — बूलियन मानदंड टाइप के लिए सही आर्ग्युमेंट की एक कैटगरी. ऑर्ग्युमेंट की संख्या और उनका टाइप, FilterCriteriaBuilder क्लास के when...() तरीके से मेल खाता हो.

getHiddenValues()

यह फ़ंक्शन, उन वैल्यू को दिखाता है जिन्हें फ़िल्टर छिपा देता है.

इस शर्त का इस्तेमाल, Grid शीट पर फ़िल्टर के साथ करें. यह शीट का डिफ़ॉल्ट टाइप होता है. अगर इस तरीके को अन्य तरह के फ़िल्टर के लिए कॉल किया जाता है, तो यह null दिखाता है. 

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Gets the filter criteria applied to column B, then gets the hidden values.
const filterCriteria = filter.getColumnFilterCriteria(2).getHiddenValues();
// Logs the hidden values.
console.log(filterCriteria);

वापसी का टिकट

String[] — वैल्यू की ऐसी सरणी जिसे फ़िल्टर छिपाता है.

getVisibleBackgroundColor()

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

इस शर्त का इस्तेमाल, Grid शीट पर फ़िल्टर के साथ करें. यह शीट का डिफ़ॉल्ट टाइप होता है. अगर इस तरीके को अन्य तरह के फ़िल्टर के लिए कॉल किया जाता है, तो यह null दिखाता है. 

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
// Logs the background color that column B is filtered by as a hexadecimal
// string.
const filter = range.getFilter();
const color = filter.getColumnFilterCriteria(2)
                  .getVisibleBackgroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

वापसी का टिकट

Color|null — फ़िल्टर के मानदंड के तौर पर इस्तेमाल किया गया बैकग्राउंड कलर.

getVisibleForegroundColor()

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

इस शर्त का इस्तेमाल, Grid शीट पर फ़िल्टर के साथ करें. यह शीट का डिफ़ॉल्ट टाइप होता है. अगर इस तरीके को अन्य तरह के फ़िल्टर के लिए कॉल किया जाता है, तो यह null दिखाता है. 

const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
// Logs the foreground color that column B is filtered by as a hexadecimal
// string.
const filter = range.getFilter();
const color = filter.getColumnFilterCriteria(2)
                  .getVisibleForegroundColor()
                  .asRgbColor()
                  .asHexString();
console.log(color);

वापसी का टिकट

Color|null — फ़ोरग्राउंड कलर, जिसका इस्तेमाल फ़िल्टर के तौर पर किया जाता है.

getVisibleValues()

यह फ़ंक्शन, पिवट टेबल फ़िल्टर में दिखने वाली वैल्यू दिखाता है.

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

const ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet, then gets the visible values of its
// first filter.
const pivotTable = ss.getPivotTables()[0];
const 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();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Sets the values to hide and applies the criteria to column C.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setHiddenValues(['Hello', 'World'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

पैरामीटर

नामटाइपब्यौरा
valuesString[]छुपाई जाने वाली वैल्यू की सूची.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

थ्रो

Error — अगर कोई भी वैल्यू null है.

setVisibleBackgroundColor(visibleBackgroundColor)

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

इस शर्त का इस्तेमाल सिर्फ़ Grid शीट पर मौजूद फ़िल्टर के लिए किया जा सकता है. यह शीट का डिफ़ॉल्ट टाइप होता है. 

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

पैरामीटर

नामटाइपब्यौरा
visibleBackgroundColorColorसेट करने के लिए बैकग्राउंड का रंग. रंग, आरजीबी स्टाइल वाला होना चाहिए. इस तरीके में थीम के रंगों का इस्तेमाल नहीं किया जा सकता.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

setVisibleForegroundColor(visibleForegroundColor)

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

इस शर्त का इस्तेमाल सिर्फ़ Grid शीट पर मौजूद फ़िल्टर के लिए किया जा सकता है. यह शीट का डिफ़ॉल्ट टाइप होता है. 

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

पैरामीटर

नामटाइपब्यौरा
visibleForegroundColorColorसेट किया जाने वाला फ़ोरग्राउंड रंग. रंग, आरजीबी स्टाइल वाला होना चाहिए. इस तरीके में थीम के रंगों का इस्तेमाल नहीं किया जा सकता.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

setVisibleValues(values)

इससे पिवट टेबल में दिखने वाली वैल्यू सेट की जाती हैं. इससे दिखने वाली या छिपी हुई सभी मौजूदा वैल्यू मिट जाती हैं.

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

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

पैरामीटर

नामटाइपब्यौरा
valuesString[]दिखाई जाने वाली वैल्यू की सूची.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

थ्रो

Error — अगर कोई भी वैल्यू null है.

whenCellEmpty()

इस विकल्प का इस्तेमाल, खाली सेल दिखाने के लिए फ़िल्टर करने की शर्तें सेट करने के लिए किया जाता है.

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. 

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

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenCellNotEmpty()

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. 

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

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenDateAfter(date)

यह फ़िल्टर करने की ऐसी शर्त सेट करता है जिससे उन सेल को दिखाया जा सके जिनमें दी गई तारीख के बाद की तारीखें मौजूद हैं.

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, तारीख होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, तारीख होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

पैरामीटर

नामटाइपब्यौरा
dateDateछिपाने की आखिरी तारीख.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenDateAfter(date)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, तारीख होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, तारीख होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

पैरामीटर

नामटाइपब्यौरा
dateRelativeDateतुलनात्मक तारीख की सबसे नई वैल्यू.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenDateBefore(date)

यह फ़िल्टर करने की ऐसी शर्त सेट करता है जिससे उन सेल को दिखाया जाता है जिनमें दी गई तारीख से पहले की तारीखें मौजूद हैं.

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, तारीख होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, तारीख होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

पैरामीटर

नामटाइपब्यौरा
dateDateवह तारीख जिसके बाद का डेटा छिपाना है.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenDateBefore(date)

यह फ़िल्टर करने की ऐसी शर्त सेट करता है जिससे उन सेल को दिखाया जाता है जिनमें तारीखें, तय की गई तारीख से पहले की हैं. तुलनात्मक तारीख के विकल्प देखने के लिए, Enum RelativeDate देखें.

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, तारीख होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, तारीख होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

पैरामीटर

नामटाइपब्यौरा
dateRelativeDateछिपाने के लिए सबसे पुरानी तारीख.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenDateEqualTo(date)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, तारीख होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, तारीख होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

पैरामीटर

नामटाइपब्यौरा
dateDateवह तारीख जिससे सेल की वैल्यू मेल खानी चाहिए.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenDateEqualTo(date)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, तारीख होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, तारीख होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
const range = ss.getRange('A1:C20');
const filter = range.getFilter();
// Creates criteria that only shows cells with dates that fall within the past
// month and sets it to column A.

const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateEqualTo(SpreadsheetApp.RelativeDate.PAST_MONTH)
                     .build();
filter.setColumnFilterCriteria(1, criteria);

पैरामीटर

नामटाइपब्यौरा
dateRelativeDateवह तारीख जिससे सेल की वैल्यू मेल खानी चाहिए.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenDateEqualToAny(dates)

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

इस शर्त का इस्तेमाल सिर्फ़ डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जा सकता है. उदाहरण के लिए, इस मानदंड का इस्तेमाल DataSource शीट, डेटाबेस से कनेक्ट की गई शीट या DataSource शीट से बनाई गई पिवट टेबल DataSourcePivotTable पर फ़िल्टर के साथ करें. 

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that shows cells with any of the below
// dates.
const date1 = new Date('June 1, 2022');
const date2 = new Date('June 2, 2022');
const date3 = new Date('June 3, 2022');
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateEqualToAny([date1, date2, date3])
                     .build();
dataSheet.addFilter('date', criteria);

पैरामीटर

नामटाइपब्यौरा
datesDate[]दिखाने के लिए तारीखें.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenDateNotEqualTo(date)

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

इस शर्त का इस्तेमाल सिर्फ़ डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जा सकता है. उदाहरण के लिए, इस मानदंड का इस्तेमाल DataSource शीट, डेटाबेस से कनेक्ट की गई शीट या DataSource शीट से बनाई गई पिवट टेबल DataSourcePivotTable पर फ़िल्टर के साथ करें.

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

// Gets a pivot table that's connected to a database.
const ss =
    SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Pivot Table Sheet');
const dataPivotTable = ss.getDataSourcePivotTables()[0];
// Creates criteria that only shows cells that don't equal June 16, 2022
// and sets it to the "date" column.
const date = new Date('June 16, 2022');
const criteria =
    SpreadsheetApp.newFilterCriteria().whenDateNotEqualTo(date).build();
dataPivotTable.addFilter('date', criteria);

पैरामीटर

नामटाइपब्यौरा
dateDateछिपाने की तारीख.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenDateNotEqualToAny(dates)

यह फ़िल्टर की शर्त सेट करता है, ताकि उन सेल को दिखाया जा सके जिनमें ऐसी तारीखें मौजूद हैं जो बताई गई किसी भी तारीख के बराबर नहीं हैं.

इस शर्त का इस्तेमाल सिर्फ़ डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जा सकता है. उदाहरण के लिए, इस मानदंड का इस्तेमाल DataSource शीट, डेटाबेस से कनेक्ट की गई शीट या DataSource शीट से बनाई गई पिवट टेबल DataSourcePivotTable पर फ़िल्टर के साथ करें. 

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "date" column that hides cells with any of the below
// dates.
const date1 = new Date('June 1, 2022');
const date2 = new Date('June 2, 2022');
const date3 = new Date('June 3, 2022');
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenDateNotEqualToAny([date1, date2, date3])
                     .build();
dataSheet.addFilter('date', criteria);

पैरामीटर

नामटाइपब्यौरा
datesDate[]छुपाने की तारीखें.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenFormulaSatisfied(formula)

यह फ़िल्टर करने की शर्तें सेट करता है, ताकि किसी फ़ॉर्मूले (जैसे, =B:B<C:C) वाली सेल दिखाई जा सकें. इस फ़ॉर्मूले का आकलन true के तौर पर किया जाता है.

इस शर्त का इस्तेमाल सिर्फ़ ऐसे डेटा को फ़िल्टर करने के लिए किया जा सकता है जो किसी डेटाबेस से कनेक्ट नहीं है. 

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const 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.
const formula = '=B:B<C:C';
const criteria =
    SpreadsheetApp.newFilterCriteria().whenFormulaSatisfied(formula).build();
filter.setColumnFilterCriteria(1, criteria);

पैरामीटर

नामटाइपब्यौरा
formulaStringयह एक कस्टम फ़ॉर्मूला है. अगर इनपुट मान्य है, तो यह true के तौर पर नतीजे दिखाता है.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenNumberBetween(start, end)

यह फ़िल्टर करने की शर्त सेट करता है, ताकि उन सेल को दिखाया जा सके जिनमें मौजूद संख्या, तय की गई दो संख्याओं के बीच में हो या उनमें से कोई एक हो.

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, संख्या होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप संख्या होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

पैरामीटर

नामटाइपब्यौरा
startNumberदिखाने के लिए सबसे कम संख्या.
endNumberदिखाने के लिए सबसे बड़ी संख्या.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenNumberEqualTo(number)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, संख्या होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप संख्या होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

पैरामीटर

नामटाइपब्यौरा
numberNumberदिखाने के लिए नंबर.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenNumberEqualToAny(numbers)

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

इस शर्त का इस्तेमाल सिर्फ़ डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जा सकता है. उदाहरण के लिए, इस मानदंड का इस्तेमाल DataSource शीट, डेटाबेस से कनेक्ट की गई शीट या DataSource शीट से बनाई गई पिवट टेबल DataSourcePivotTable पर फ़िल्टर के साथ करें. 

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that only shows cells with the number
// 10, 20, or 30.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenNumberEqualToAny([10, 20, 30])
                     .build();
dataSheet.addFilter('amount', criteria);

पैरामीटर

नामटाइपब्यौरा
numbersNumber[]दिखाने के लिए नंबर.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenNumberGreaterThan(number)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, संख्या होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप संख्या होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

पैरामीटर

नामटाइपब्यौरा
numberNumberछिपाने के लिए सबसे बड़ी संख्या.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenNumberGreaterThanOrEqualTo(number)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, संख्या होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप संख्या होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

पैरामीटर

नामटाइपब्यौरा
numberNumberदिखाने के लिए सबसे कम संख्या.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenNumberLessThan(number)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, संख्या होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप संख्या होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

पैरामीटर

नामटाइपब्यौरा
numberNumberसबसे कम संख्या जिसे छिपाना है.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenNumberLessThanOrEqualTo(number)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, संख्या होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप संख्या होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

पैरामीटर

नामटाइपब्यौरा
numberNumberदिखाने के लिए सबसे बड़ी संख्या.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenNumberNotBetween(start, end)

यह फ़िल्टर करने की शर्त तय करता है. इससे ऐसी सेल दिखती हैं जिनमें मौजूद संख्या, तय की गई दो संख्याओं के बीच की नहीं होती है और न ही उनमें से कोई एक होती है.

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, संख्या होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप संख्या होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

पैरामीटर

नामटाइपब्यौरा
startNumberसबसे कम संख्या छिपाएं.
endNumberछिपाने के लिए सबसे बड़ी संख्या.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenNumberNotEqualTo(number)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. अगर इस शर्त का इस्तेमाल, डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जाता है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप, संख्या होना चाहिए. अगर डेटा किसी डेटाबेस से कनेक्ट नहीं है, तो जिस कॉलम के हिसाब से फ़िल्टर किया जा रहा है उसका डेटा टाइप संख्या होना ज़रूरी नहीं है. हालांकि, ऐसा न होने पर आपको उम्मीद के मुताबिक नतीजे नहीं मिल सकते हैं. 

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

पैरामीटर

नामटाइपब्यौरा
numberNumberवह संख्या जिसे छिपाना है.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenNumberNotEqualToAny(numbers)

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

इस शर्त का इस्तेमाल सिर्फ़ डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जा सकता है. उदाहरण के लिए, इस मानदंड का इस्तेमाल DataSource शीट, डेटाबेस से कनेक्ट की गई शीट या DataSource शीट से बनाई गई पिवट टेबल DataSourcePivotTable पर फ़िल्टर के साथ करें. 

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "amount" column that hides cells with the number 10, 20,
// or 30.
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenNumberNotEqualToAny([10, 20, 30])
                     .build();
dataSheet.addFilter('amount', criteria);

पैरामीटर

नामटाइपब्यौरा
numbersNumber[]वे नंबर जिन्हें छिपाना है.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenTextContains(text)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. 

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

पैरामीटर

नामटाइपब्यौरा
textStringवह टेक्स्ट जो सेल में शामिल होना चाहिए.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenTextDoesNotContain(text)

इस विकल्प से, फ़िल्टर करने की शर्तें सेट की जाती हैं. इससे ऐसी सेल दिखती हैं जिनमें ऐसा टेक्स्ट होता है जो तय किए गए टेक्स्ट से मेल नहीं खाता. टेक्स्ट केस-सेंसिटिव नहीं होता है.

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. 

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

पैरामीटर

नामटाइपब्यौरा
textStringवह टेक्स्ट जो सेल में शामिल नहीं होना चाहिए.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenTextEndsWith(text)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. 

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

पैरामीटर

नामटाइपब्यौरा
textStringवह टेक्स्ट जो सेल के टेक्स्ट के आखिर में मौजूद होना चाहिए.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenTextEqualTo(text)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. 

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

पैरामीटर

नामटाइपब्यौरा
textStringवह टेक्स्ट जिसके बराबर सेल का टेक्स्ट होना चाहिए.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenTextEqualToAny(texts)

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

इस शर्त का इस्तेमाल सिर्फ़ डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जा सकता है. उदाहरण के लिए, इस मानदंड का इस्तेमाल DataSource शीट, डेटाबेस से कनेक्ट की गई शीट या DataSource शीट से बनाई गई पिवट टेबल DataSourcePivotTable पर फ़िल्टर के साथ करें. 

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that shows cells with the text "tech"
// or "business."
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenTextEqualToAny(['tech', 'business'])
                     .build();
dataSheet.addFilter('category', criteria);

पैरामीटर

नामटाइपब्यौरा
textsString[]टेक्स्ट वैल्यू, जिनके बराबर सेल होनी चाहिए.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenTextNotEqualTo(text)

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

इस शर्त का इस्तेमाल सिर्फ़ डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जा सकता है. उदाहरण के लिए, इस मानदंड का इस्तेमाल DataSource शीट, डेटाबेस से कनेक्ट की गई शीट या DataSource शीट से बनाई गई पिवट टेबल DataSourcePivotTable पर फ़िल्टर के साथ करें. 

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with text equal to
// "tech."
const criteria =
    SpreadsheetApp.newFilterCriteria().whenTextNotEqualTo('tech').build();
dataSheet.addFilter('category', criteria);

पैरामीटर

नामटाइपब्यौरा
textStringवह टेक्स्ट जो सेल के टेक्स्ट के बराबर नहीं हो सकता.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenTextNotEqualToAny(texts)

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

इस शर्त का इस्तेमाल सिर्फ़ डेटाबेस से कनेक्ट किए गए डेटा के साथ किया जा सकता है. उदाहरण के लिए, इस मानदंड का इस्तेमाल DataSource शीट, डेटाबेस से कनेक्ट की गई शीट या DataSource शीट से बनाई गई पिवट टेबल DataSourcePivotTable पर फ़िल्टर के साथ करें. 

// Gets the sheet that's connected to a database.
const ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Data Sheet');
const dataSheet = ss.asDataSourceSheet();
// Adds criteria to the "category" column that hides cells with the text "tech"
// or "business."
const criteria = SpreadsheetApp.newFilterCriteria()
                     .whenTextNotEqualToAny(['tech', 'business'])
                     .build();
dataSheet.addFilter('category', criteria);

पैरामीटर

नामटाइपब्यौरा
textsString[]टेक्स्ट वैल्यू, जिनके बराबर कोई सेल नहीं हो सकती.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

whenTextStartsWith(text)

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

इस मानदंड का इस्तेमाल, किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. 

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

पैरामीटर

नामटाइपब्यौरा
textStringवह टेक्स्ट जो सेल के टेक्स्ट की शुरुआत में होना चाहिए.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.

withCriteria(criteria, args)

यह फ़िल्टर के लिए, बूलियन कंडीशन के तौर पर BooleanCriteria वैल्यू सेट करता है. जैसे, CELL_EMPTY या NUMBER_GREATER_THAN. मौजूदा शर्तों से बूलियन शर्त कॉपी करने के लिए, मौजूदा शर्तों पर getCriteriaType() और getCriteriaValues() का इस्तेमाल करके, इस तरीके के लिए पैरामीटर तय करें.

इस मानदंड का इस्तेमाल किसी भी तरह के फ़िल्टर के साथ किया जा सकता है. हालांकि, कुछ BooleanCriteria सभी फ़िल्टर पर लागू नहीं होते. 

// Builds a filter criteria that is based on existing boolean conditions from
// another criteria. Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
const 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."
const filterCriteria = filter.getColumnFilterCriteria(2);
const criteria = SpreadsheetApp.newFilterCriteria()
                     .withCriteria(
                         filterCriteria.getCriteriaType(),
                         filterCriteria.getCriteriaValues(),
                         )
                     .setHiddenValues(['Northwest'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

पैरामीटर

नामटाइपब्यौरा
criteriaBooleanCriteriaबूलियन मानदंड का टाइप.
argsObject[]मानदंड के टाइप के हिसाब से, ऑर्ग्युमेंट की एक ऐरे. ऑर्ग्युमेंट की संख्या और उनका टाइप, ऊपर दिए गए when...() तरीकों से मेल खाता है.

वापसी का टिकट

FilterCriteriaBuilder — यह बिल्डर, चेनिंग के लिए है.