Class FilterCriteriaBuilder

फ़िल्टरशर्तबिल्डर

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

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

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

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

इस सैंपल में, शीट का मौजूदा फ़िल्टर लिया जाता है और कॉलम C में "नमस्ते" या "दुनिया" वाली सेल छिपाने के लिए शर्त जोड़ी जाती है. इस सैंपल में दी गई शर्तों का इस्तेमाल, सिर्फ़ 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शर्त का बूलियन टाइप दिखाता है, जैसे कि CELL_EMPTY.
getCriteriaValues()Object[]बूलियन शर्तों के लिए, आर्ग्युमेंट का ऐरे दिखाता है.
getHiddenValues()String[]फ़िल्टर की गई वैल्यू दिखाता है.
getVisibleBackgroundColor()Colorफ़िल्टर की शर्त के तौर पर इस्तेमाल किए गए बैकग्राउंड का रंग दिखाता है.
getVisibleForegroundColor()Colorफ़िल्टर की शर्त के तौर पर इस्तेमाल किया गया फ़ोरग्राउंड कलर दिखाता है.
getVisibleValues()String[]पिवट टेबल फ़िल्टर से दिखने वाली वैल्यू दिखाता है.
setHiddenValues(values)FilterCriteriaBuilderछिपाने के लिए वैल्यू सेट करता है.
setVisibleBackgroundColor(visibleBackgroundColor)FilterCriteriaBuilderफ़िल्टर की शर्त के तौर पर इस्तेमाल किए जाने वाले बैकग्राउंड का रंग सेट करता है.
setVisibleForegroundColor(visibleForegroundColor)FilterCriteriaBuilderफ़िल्टर की शर्त के तौर पर इस्तेमाल किया जाने वाला फ़ोरग्राउंड कलर सेट करता है.
setVisibleValues(values)FilterCriteriaBuilderपिवट टेबल पर दिखाने के लिए वैल्यू सेट करता है.
whenCellEmpty()FilterCriteriaBuilderखाली सेल दिखाने के लिए, फ़िल्टर की शर्तें सेट करता है.
whenCellNotEmpty()FilterCriteriaBuilderखाली नहीं होने वाली सेल दिखाने के लिए, फ़िल्टर की शर्त सेट करता है.
whenDateAfter(date)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि तय की गई तारीख के बाद की तारीखों वाली सेल दिखें.
whenDateAfter(date)FilterCriteriaBuilderफ़िल्टर की ऐसी शर्त सेट करता है जो तय की गई रिलेटिव तारीख के बाद की तारीखों वाली सेल दिखाता है.
whenDateBefore(date)FilterCriteriaBuilderफ़िल्टर की शर्त सेट करता है, जो तय तारीख से पहले की तारीखों वाली सेल दिखाता है.
whenDateBefore(date)FilterCriteriaBuilderफ़िल्टर की शर्त सेट करता है, जो तय की गई तारीख से पहले की तारीखों वाली सेल दिखाता है.
whenDateEqualTo(date)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि तारीख की जानकारी वाली सेल दिखें. ये सेल, तय की गई तारीख से मेल खाती हैं.
whenDateEqualTo(date)FilterCriteriaBuilderफ़िल्टर की शर्त सेट करता है, जो उन सेल को दिखाता है जिनकी तारीखें, दी गई रिलेटिव तारीख से मेल खाती हैं.
whenDateEqualToAny(dates)FilterCriteriaBuilderतारीखों की किसी भी तय सीमा से मेल खाने वाली सेल दिखाने के लिए, फ़िल्टर की शर्तें सेट करता है.
whenDateNotEqualTo(date)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि उन सेल को दिखाया जा सके जो तय की गई तारीख से मेल नहीं खाती हैं.
whenDateNotEqualToAny(dates)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि ऐसी सेल दिखाई जा सकें जिनकी तारीखें, बताई गई किसी भी तारीख से मेल न खाती हों.
whenFormulaSatisfied(formula)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि किसी खास फ़ॉर्मूला (जैसे, =B:B<C:C) वाली सेल दिखाई जा सकें, जिनका आकलन true के तौर पर किया गया हो.
whenNumberBetween(start, end)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि उन सेल को दिखाया जा सके जिनमें दी गई दो संख्याओं के बीच की संख्या हो या जो उनमें से कोई एक संख्या हो.
whenNumberEqualTo(number)FilterCriteriaBuilderतय की गई संख्या से मेल खाने वाली संख्या वाली सेल दिखाने के लिए, फ़िल्टर की शर्तें सेट करता है.
whenNumberEqualToAny(numbers)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि उन सेल को दिखाया जा सके जिनमें दी गई किसी भी संख्या के बराबर संख्या हो.
whenNumberGreaterThan(number)FilterCriteriaBuilderतय की गई संख्या से ज़्यादा संख्या वाली सेल दिखाने के लिए, फ़िल्टर की शर्तें सेट करता है
whenNumberGreaterThanOrEqualTo(number)FilterCriteriaBuilderतय की गई संख्या से ज़्यादा या उसके बराबर की संख्या वाली सेल दिखाने के लिए, फ़िल्टर की शर्तें सेट करता है.
whenNumberLessThan(number)FilterCriteriaBuilderतय की गई संख्या से कम संख्या वाली सेल दिखाने के लिए, फ़िल्टर की शर्तें सेट करता है.
whenNumberLessThanOrEqualTo(number)FilterCriteriaBuilderतय की गई संख्या से कम या उसके बराबर संख्या वाली सेल दिखाने के लिए, फ़िल्टर की शर्तें सेट करता है.
whenNumberNotBetween(start, end)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि ऐसी सेल दिखाई जा सकें जिनमें मौजूद संख्या, तय की गई दो संख्याओं के बीच न हो और न ही उनमें से कोई एक हो.
whenNumberNotEqualTo(number)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि ऐसी सेल दिखाई जा सकें जिनमें दी गई संख्या से अलग संख्या हो.
whenNumberNotEqualToAny(numbers)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि ऐसी सेल दिखाई जा सकें जिनमें दी गई किसी भी संख्या से अलग संख्या हो.
whenTextContains(text)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि टेक्स्ट वाली सेल दिखाई जा सकें.
whenTextDoesNotContain(text)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि टेक्स्ट वाली ऐसी सेल दिखाई जा सकें जिनमें तय किया गया टेक्स्ट न हो.
whenTextEndsWith(text)FilterCriteriaBuilderफ़िल्टर करने की शर्त सेट करता है, ताकि टेक्स्ट के साथ खत्म होने वाले टेक्स्ट वाली सेल दिखाई जा सकें.
whenTextEqualTo(text)FilterCriteriaBuilderयह फ़िल्टर की शर्तें सेट करता है, ताकि टेक्स्ट वाली उन सेल को दिखाया जा सके जो दिए गए टेक्स्ट से मेल खाती हैं.
whenTextEqualToAny(texts)FilterCriteriaBuilderटेक्स्ट की ऐसी सेल दिखाने के लिए फ़िल्टर की शर्तें सेट करता है जो बताई गई टेक्स्ट वैल्यू से मेल खाती हैं.
whenTextNotEqualTo(text)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि टेक्स्ट वाली ऐसी सेल दिखाई जा सकें जो दिए गए टेक्स्ट से मेल न खाती हों.
whenTextNotEqualToAny(texts)FilterCriteriaBuilderफ़िल्टर की शर्तें सेट करता है, ताकि ऐसी सेल दिखाई जा सकें जिनमें टेक्स्ट, बताई गई किसी भी वैल्यू से मेल न खाता हो.
whenTextStartsWith(text)FilterCriteriaBuilderयह फ़िल्टर की शर्तें सेट करता है, ताकि टेक्स्ट वाली उन सेल को दिखाया जा सके जो दिए गए टेक्स्ट से शुरू होती हैं.
withCriteria(criteria, args)FilterCriteriaBuilderफ़िल्टर की शर्तों को बूलियन कंडीशन पर सेट करता है. यह कंडीशन, BooleanCriteria वैल्यू से तय की जाती है, जैसे कि CELL_EMPTY या NUMBER_GREATER_THAN.

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

build()

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

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
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, अगर शर्त बूलियन शर्त नहीं है.


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 — फ़िल्टर की शर्त के तौर पर इस्तेमाल किया जाने वाला बैकग्राउंड कलर.


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 — फ़िल्टर की शर्त के तौर पर इस्तेमाल किया जाने वाला फ़ोरग्राउंड रंग.


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 शीट, डेटाबेस से कनेक्ट की गई शीट या DataSourcePivotTable, DataSource शीट से बनाई गई पिवट टेबल पर फ़िल्टर के साथ करें.

// 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 शीट, डेटाबेस से कनेक्ट की गई शीट या DataSourcePivotTable, DataSource शीट से बनाई गई पिवट टेबल पर फ़िल्टर के साथ करें.

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

// 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 शीट, डेटाबेस से कनेक्ट की गई शीट या DataSourcePivotTable, DataSource शीट से बनाई गई पिवट टेबल पर फ़िल्टर के साथ करें.

// 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 शीट, डेटाबेस से कनेक्ट की गई शीट या DataSourcePivotTable, DataSource शीट से बनाई गई पिवट टेबल पर फ़िल्टर के साथ करें.

// 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 शीट, डेटाबेस से कनेक्ट की गई शीट या DataSourcePivotTable, DataSource शीट से बनाई गई पिवट टेबल पर फ़िल्टर के साथ करें.

// 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 शीट, डेटाबेस से कनेक्ट की गई शीट या DataSourcePivotTable, DataSource शीट से बनाई गई पिवट टेबल पर फ़िल्टर के साथ करें.

// 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 शीट, डेटाबेस से कनेक्ट की गई शीट या DataSourcePivotTable, DataSource शीट से बनाई गई पिवट टेबल पर फ़िल्टर के साथ करें.

// 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 शीट, डेटाबेस से कनेक्ट की गई शीट या DataSourcePivotTable, DataSource शीट से बनाई गई पिवट टेबल पर फ़िल्टर के साथ करें.

// 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 — यह बिल्डर, चेन करने के लिए है.