Class FilterCriteriaBuilder

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Kreator kryteriów kryteriów

Aby dodać kryteria do filtra, musisz:

  1. Utwórz kreator kryteriów za pomocą narzędzia SpreadsheetApp.newFilterCriteria().
  2. Dodaj ustawienia do konstruktora, korzystając z metod z tej klasy.
  3. Użyj operatora build(), aby utworzyć kryteria o określonych ustawieniach.

Typowe zastosowania

Ukrywanie wartości w arkuszu

Poniższy przykład powoduje pobranie arkusza i dodanie kryteriów, które ukrywają komórki w kolumnie C zawierające "hello" lub "world." Kryteria z tej próby mogą być używane tylko z filtrami w arkuszach Grid, domyślnym typie arkusza.
let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setHiddenValues(["hello", "world"])
                             .build();
filter.setColumnFilterCriteria(3, criteria);

Pokaż tylko niepuste komórki

Poniższy przykładowy kod dodaje do arkusza DataSource arkusz, który jest połączony z bazą danych, i zawiera kryteria, które pokazują tylko kolumny z kolumny „Kategoria”.
// Gets the sheet named "Connected sheet," which is connected to a database.
let sheet = SpreadsheetApp.getActiveSpreadsheet()
                          .getSheetByName("Connected sheet")
                          .asDataSourceSheet();
// Creates criteria that only shows non-empty cells.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenCellNotEmpty()
                             .build();
// Applies the criteria to the column named "Category."
sheet.addFilter("Category", criteria);

Metody

MetodaZwracany typKrótki opis
build()FilterCriteriaPrzygotuj kryteria filtra, korzystając z ustawień dodanych do kreatora kryteriów.
copy()FilterCriteriaBuilderKopiuje te kryteria filtrowania i tworzy narzędzie do ich stosowania.
getCriteriaType()BooleanCriteriaZwraca typ logiczny kryteriów, np. CELL_EMPTY.
getCriteriaValues()Object[]Zwraca tablicę argumentów na potrzeby kryteriów logicznych.
getHiddenValues()String[]Zwraca wartości ukryte przez filtr.
getVisibleBackgroundColor()ColorZwraca kolor tła używany jako kryterium filtra.
getVisibleForegroundColor()ColorZwraca kolor pierwszego planu używany jako kryterium filtra.
getVisibleValues()String[]Zwraca wartości wyświetlane przez filtr tabeli przestawnej.
setHiddenValues(values)FilterCriteriaBuilderUstawia wartości do ukrycia.
setVisibleBackgroundColor(visibleBackgroundColor)FilterCriteriaBuilderUstawia kolor tła używany jako kryterium filtra.
setVisibleForegroundColor(visibleForegroundColor)FilterCriteriaBuilderUstawia kolor pierwszego planu używany jako kryterium filtra.
setVisibleValues(values)FilterCriteriaBuilderUstawia wartości wyświetlane w tabeli przestawnej.
whenCellEmpty()FilterCriteriaBuilderUstawia kryteria filtrowania na puste komórki.
whenCellNotEmpty()FilterCriteriaBuilderUstawia kryteria filtrowania tak, aby wyświetlały się komórki, które nie są puste.
whenDateAfter(date)FilterCriteriaBuilderUstawia kryteria filtrowania zawierające komórki z datami po określonej dacie.
whenDateAfter(date)FilterCriteriaBuilderUstawia kryteria filtra zawierające komórki z datami późniejszymi niż określona data względna.
whenDateBefore(date)FilterCriteriaBuilderUstawia kryteria filtrowania zawierające komórki z datami sprzed określonej daty.
whenDateBefore(date)FilterCriteriaBuilderUstawia kryteria filtrowania zawierające komórki z datami poprzedzającymi określoną datę względną.
whenDateEqualTo(date)FilterCriteriaBuilderUstawia kryteria filtrowania zawierające komórki z datą równą określonej dacie.
whenDateEqualTo(date)FilterCriteriaBuilderUstawia kryteria filtrowania zawierające komórki z datami określonymi w przypadku określonej daty względnej.
whenDateEqualToAny(dates)FilterCriteriaBuilderUstawia kryteria filtrowania, tak aby wyświetlały się komórki, których data jest równa dowolnej z podanych dat.
whenDateNotEqualTo(date)FilterCriteriaBuilderUstawia kryteria filtrowania tak, aby wyświetlały się komórki, które nie są równe określonej dacie.
whenDateNotEqualToAny(dates)FilterCriteriaBuilderUstawia kryteria filtra tak, aby wyświetlały się komórki, których data nie jest równa żadnej z określonych dat.
whenFormulaSatisfied(formula)FilterCriteriaBuilderUstawia kryteria filtra tak, aby wyświetlały komórki z określoną formułą (np. =B:B<C:C), która ocenia true.
whenNumberBetween(start, end)FilterCriteriaBuilderUstawia kryteria filtrowania, tak aby wyświetlały się komórki, w których liczba mieści się w 2 zakresach lub jest jedną z tych wartości.
whenNumberEqualTo(number)FilterCriteriaBuilderUstawia kryteria filtrowania, tak aby wyświetlały się komórki z liczbą równą określonej liczbie.
whenNumberEqualToAny(numbers)FilterCriteriaBuilderUstawia kryteria filtrowania tak, aby wyświetlały się komórki z liczbą, która jest równa dowolnej z określonych liczb.
whenNumberGreaterThan(number)FilterCriteriaBuilderUstawia kryteria filtrowania, tak aby wyświetlały się komórki o liczbie większej niż określona
whenNumberGreaterThanOrEqualTo(number)FilterCriteriaBuilderUstawia kryteria filtra, aby wyświetlić komórki z liczbą większą lub równą określonej liczbie.
whenNumberLessThan(number)FilterCriteriaBuilderUstawia kryteria filtrowania, tak aby wyświetlały się komórki, w przypadku których liczba jest mniejsza od określonej liczby.
whenNumberLessThanOrEqualTo(number)FilterCriteriaBuilderUstawia kryteria filtra, aby wyświetlić komórki z liczbą mniejszą lub równą określonej liczbie.
whenNumberNotBetween(start, end)FilterCriteriaBuilderUstawia kryteria filtra, tak aby wyświetlały się w komórce liczby, które nie należą do żadnej z dwóch liczb.
whenNumberNotEqualTo(number)FilterCriteriaBuilderUstawia kryteria filtra tak, aby były wyświetlane komórki z liczbą, która nie jest równa określonej liczbie.
whenNumberNotEqualToAny(numbers)FilterCriteriaBuilderUstawia kryteria filtra tak, aby były wyświetlane komórki z liczbą, która nie jest równa żadnej z określonych liczb.
whenTextContains(text)FilterCriteriaBuilderUstawia kryteria filtrowania, tak aby wyświetlały komórki zawierające tekst.
whenTextDoesNotContain(text)FilterCriteriaBuilderUstawia kryteria filtra tak, aby wyświetlały się komórki z tekstem, który nie zawiera podanego tekstu.
whenTextEndsWith(text)FilterCriteriaBuilderUstawia kryteria filtrowania, tak aby wyświetlały się komórki z tekstem kończącym się na określonym tekście.
whenTextEqualTo(text)FilterCriteriaBuilderUstawia kryteria filtrowania, tak aby wyświetlały się komórki z tekstem równym określonemu tekstowi.
whenTextEqualToAny(texts)FilterCriteriaBuilderUstawia kryteria filtra tak, aby wyświetlały się komórki z tekstem, który jest równy dowolnej z określonych wartości tekstowych.
whenTextNotEqualTo(text)FilterCriteriaBuilderUstawia kryteria filtrowania w celu wyświetlania komórek z tekstem, który nie jest równy określonemu tekstowi.
whenTextNotEqualToAny(texts)FilterCriteriaBuilderUstawia kryteria filtra tak, aby wyświetlały się komórki z tekstem, który nie jest zgodny z określoną wartością.
whenTextStartsWith(text)FilterCriteriaBuilderUstawia kryteria filtrowania, tak aby wyświetlały się komórki z tekstem zaczynającym się od określonego tekstu.
withCriteria(criteria, args)FilterCriteriaBuilderUstawia warunek filtra na wartość logiczną zdefiniowaną przez wartości BooleanCriteria, np. CELL_EMPTY lub NUMBER_GREATER_THAN.

Szczegółowa dokumentacja

build()

Przygotuj kryteria filtra, korzystając z ustawień dodanych do kreatora kryteriów.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
let criteria = SpreadsheetApp.newFilterCriteria() // Creates a criteria builder.
                             .whenCellNotEmpty() // Adds settings to the builder.
                             .build();          // Assembles the criteria.
filter.setColumnFilterCriteria(2, criteria);

Zwróć

FilterCriteria – przedstawienie kryteriów filtrowania.


copy()

Kopiuje te kryteria filtrowania i tworzy narzędzie do ich stosowania.

Tej metody możesz używać z różnymi typami filtrów. Jeśli używasz filtra arkusza, możesz skopiować kryteria do innej kolumny.

let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Makes a copy of the filter criteria applied to column C.
let criteria = filter.getColumnFilterCriteria(3).copy().build();
// Applies the copied criteria to column B. The copied criteria overwrites any existing
// criteria on column B.
filter.setColumnFilterCriteria(2, criteria);

Zwróć

FilterCriteriaBuilder – narzędzie do tworzenia kryteriów filtrowania oparte na tych kryteriach.


getCriteriaType()

Zwraca typ logiczny kryteriów, np. CELL_EMPTY. Aby dowiedzieć się więcej o typach kryteriów logicznych, zobacz wyliczenie BooleanCriteria.

Użytkownicy często używają tej metody, aby dodać do filtra kryteria warunków logicznych bez zastępowania dotychczasowych.

Możesz użyć tej metody w przypadku dowolnego typu filtra. Jeśli kryterium filtra jest warunku logicznem, zwraca null.

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

Zwróć

BooleanCriteria – typ kryteriów logicznych, a null – jeśli warunek jest wartością logiczną.


getCriteriaValues()

Zwraca tablicę argumentów na potrzeby kryteriów logicznych. Niektóre typy kryteriów logicznych nie zawierają argumentów i zwracają pustą tablicę, na przykład CELL_NOT_EMPTY.

Użytkownicy często używają tej metody, aby dodać do filtra kryteria warunków logicznych bez zastępowania dotychczasowych.

  • Aby uzyskać typ kryterium logicznego, użyj getCriteriaType().
  • Aby użyć typu i wartości kryteriów do tworzenia lub modyfikowania kryteriów filtra, zapoznaj się z artykułem withCriteria(criteria, args).

    Możesz użyć tej metody w przypadku dowolnego typu filtra.

    let ss = SpreadsheetApp.getActiveSheet();
    let filter = ss.getFilter();
    // Gets the values of the boolean criteria and logs them. For example, if the boolean
    // condition is whenNumberGreaterThan(10), then the logged value is 10.
    let criteriaValues = filter.getColumnFilterCriteria(2).getCriteriaValues();
    console.log(criteriaValues);

    Zwróć

    Object[] – tablica argumentów odpowiednich dla typu kryteriów logicznych. Liczba argumentów i ich typu są zgodne z odpowiednią metodą when...() klasy FilterCriteriaBuilder.


getHiddenValues()

Zwraca wartości ukryte przez filtr.

Użyj tych kryteriów w filtrach w arkuszach Grid – domyślnym typie arkusza. Zwraca null, jeśli wywołasz tę metodę w przypadku innych typów filtrów.

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

Zwróć

String[] – tablica wartości ukrywanych przez filtr.


getVisibleBackgroundColor()

Zwraca kolor tła używany jako kryterium filtra. Komórki z tym kolorem tła są nadal widoczne.

Użyj tych kryteriów w filtrach w arkuszach Grid – domyślnym typie arkusza. Zwraca null, jeśli wywołasz tę metodę w przypadku innych typów filtrów.

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

Zwróć

Color – kolor tła używany jako kryterium filtrowania;


getVisibleForegroundColor()

Zwraca kolor pierwszego planu używany jako kryterium filtra. Komórki z tym kolorem na pierwszym planie pozostają widoczne.

Użyj tych kryteriów w filtrach w arkuszach Grid – domyślnym typie arkusza. Zwraca null, jeśli wywołasz tę metodę w przypadku innych typów filtrów.

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

Zwróć

Color – kolor pierwszego planu używany jako kryterium filtra.


getVisibleValues()

Zwraca wartości wyświetlane przez filtr tabeli przestawnej.

Te kryteria dotyczą tylko filtrów w tabelach przestawnych, które nie są połączone z bazą danych. Zwraca pustą tablicę w przypadku innych typów filtrów.

let ss = SpreadsheetApp.getActiveSheet();
// Gets the first pivot table on the sheet, then gets the visible values of its first filter.
pivotTable = ss.getPivotTables()[0];
pivotFilterValues = pivotTable.getFilters()[0].getFilterCriteria().getVisibleValues();
// Logs the visible values.
console.log(pivotFilterValues);

Zwróć

String[] – tablica wartości wyświetlanych przez filtr tabeli przestawnej.


setHiddenValues(values)

Ustawia wartości do ukrycia. Usuwa wszystkie widoczne lub ukryte wartości.

Tench kryteriów można używać tylko w filtrach arkuszy Grid – domyślnego typu arkusza.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Sets the values to hide and applies the criteria to column C.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setHiddenValues(["Hello", "World"])
                             .build();
filter.setColumnFilterCriteria(3, criteria);

Parametry

NazwaTypOpis
valuesString[]Lista wartości do ukrycia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


setVisibleBackgroundColor(visibleBackgroundColor)

Ustawia kolor tła używany jako kryterium filtra. Komórki z tym kolorem tła są nadal widoczne. Ustawienie kryteriów filtrowania kolorów tła spowoduje usunięcie z tego kreatora wszystkich bieżących filtrów.

Tench kryteriów można używać tylko w filtrach arkuszy Grid – domyślnego typu arkusza.

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

Parametry

NazwaTypOpis
visibleBackgroundColorColorKolor tła do ustawienia. Musi być to kolor RGB. Ta metoda nie obsługuje kolorów motywu.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


setVisibleForegroundColor(visibleForegroundColor)

Ustawia kolor pierwszego planu używany jako kryterium filtra. Komórki z tym kolorem na pierwszym planie pozostają widoczne. Ustawienie kryteriów filtrowania kolorów pierwszego planu spowoduje usunięcie z tego kreatora wszystkich bieżących kryteriów filtrowania kolorów.

Tench kryteriów można używać tylko w filtrach arkuszy Grid – domyślnego typu arkusza.

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

Parametry

NazwaTypOpis
visibleForegroundColorColorKolor pierwszego planu do ustawienia. Musi być to kolor RGB. Ta metoda nie obsługuje kolorów motywu.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


setVisibleValues(values)

Ustawia wartości wyświetlane w tabeli przestawnej. Usuwa wszystkie widoczne lub ukryte wartości.

Tego kryterium możesz użyć tylko w przypadku filtrów w tabelach przestawnych, które nie są połączone z bazą danych.

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

Parametry

NazwaTypOpis
valuesString[]Lista wartości do wyświetlenia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenCellEmpty()

Ustawia kryteria filtrowania na puste komórki.

Tych kryteriów możesz użyć z dowolnym typem filtra.

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

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenCellNotEmpty()

Ustawia kryteria filtrowania tak, aby wyświetlały się komórki, które nie są puste.

Tych kryteriów możesz użyć z dowolnym typem filtra.

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

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenDateAfter(date)

Ustawia kryteria filtrowania zawierające komórki z datami po określonej dacie.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być datą, ale jeśli tego nie zrobisz, mogą pojawić się nieoczekiwane wyniki.

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

Parametry

NazwaTypOpis
dateDateNajnowsza data do ukrycia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenDateAfter(date)

Ustawia kryteria filtra zawierające komórki z datami późniejszymi niż określona data względna. Informacje o względnych opcjach dat znajdziesz w sekcji Enum RelativeDate.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być datą, ale jeśli tego nie zrobisz, mogą pojawić się nieoczekiwane wyniki.

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

Parametry

NazwaTypOpis
dateRelativeDateNajnowsza data względna.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenDateBefore(date)

Ustawia kryteria filtrowania zawierające komórki z datami sprzed określonej daty.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być datą, ale jeśli tego nie zrobisz, mogą pojawić się nieoczekiwane wyniki.

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

Parametry

NazwaTypOpis
dateDateNajwcześniejsza data ukrycia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenDateBefore(date)

Ustawia kryteria filtrowania zawierające komórki z datami poprzedzającymi określoną datę względną. Aby wyświetlić względne opcje dat, przeczytaj artykuł Wyliczenie RelativeDate.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być datą, ale jeśli tego nie zrobisz, mogą pojawić się nieoczekiwane wyniki.

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

Parametry

NazwaTypOpis
dateRelativeDateNajwcześniejsza data względna do ukrycia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenDateEqualTo(date)

Ustawia kryteria filtrowania zawierające komórki z datą równą określonej dacie.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być datą, ale jeśli tego nie zrobisz, mogą pojawić się nieoczekiwane wyniki.

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

Parametry

NazwaTypOpis
dateDateData, którą wartości muszą się zgadzać.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenDateEqualTo(date)

Ustawia kryteria filtrowania zawierające komórki z datami określonymi w przypadku określonej daty względnej. Aby wyświetlić względne opcje dat, przeczytaj artykuł Wyliczenie RelativeDate.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być datą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być datą, ale jeśli tego nie zrobisz, mogą pojawić się nieoczekiwane wyniki.

// Gets the existing filter on the range.
const ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
let filter = range.getFilter();
// Creates criteria that only shows cells with dates that fall within the past month
// and sets it to column A.
let date = SpreadsheetApp.RelativeDate.PAST_MONTH;
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenDateEqualTo(date)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parametry

NazwaTypOpis
dateRelativeDateWzględna data, dla której wartości komórek muszą się zgadzać.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenDateEqualToAny(dates)

Ustawia kryteria filtrowania, tak aby wyświetlały się komórki, których data jest równa dowolnej z podanych dat.

Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable, która została utworzona na podstawie arkusza DataSource.

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

Parametry

NazwaTypOpis
datesDate[]Daty do wyświetlenia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenDateNotEqualTo(date)

Ustawia kryteria filtrowania tak, aby wyświetlały się komórki, które nie są równe określonej dacie.

Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable, która została utworzona na podstawie arkusza DataSource.

Typ danych w kolumnie, według której filtrujesz, musi być datą.

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

Parametry

NazwaTypOpis
dateDateData ukrycia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenDateNotEqualToAny(dates)

Ustawia kryteria filtra tak, aby wyświetlały się komórki, których data nie jest równa żadnej z określonych dat.

Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable, która została utworzona na podstawie arkusza DataSource.

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

Parametry

NazwaTypOpis
datesDate[]Daty do ukrycia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenFormulaSatisfied(formula)

Ustawia kryteria filtra tak, aby wyświetlały komórki z określoną formułą (np. =B:B<C:C), która ocenia true.

Te kryteria możesz stosować tylko do filtrowania danych, które nie są połączone z bazą danych.

// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Creates criteria that shows the rows where the value in column B is less than the value in
// column C and sets it to column A.
let formula = "=B:B<C:C";
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenFormulaSatisfied(formula)
                             .build();
filter.setColumnFilterCriteria(1, criteria);

Parametry

NazwaTypOpis
formulaStringNiestandardowa formuła, która zwraca wartość true, jeśli dane wejściowe są prawidłowe.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenNumberBetween(start, end)

Ustawia kryteria filtrowania, tak aby wyświetlały się komórki, w których liczba mieści się w 2 zakresach lub jest jedną z tych wartości.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.

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

Parametry

NazwaTypOpis
startNumberNajniższa liczba do wyświetlenia.
endNumberNajwyższa liczba do wyświetlenia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenNumberEqualTo(number)

Ustawia kryteria filtrowania, tak aby wyświetlały się komórki z liczbą równą określonej liczbie.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.

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

Parametry

NazwaTypOpis
numberNumberNumer do wyświetlenia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenNumberEqualToAny(numbers)

Ustawia kryteria filtrowania tak, aby wyświetlały się komórki z liczbą, która jest równa dowolnej z określonych liczb.

Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable, która została utworzona na podstawie arkusza DataSource.

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

Parametry

NazwaTypOpis
numbersNumber[]Numery do pokazania.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenNumberGreaterThan(number)

Ustawia kryteria filtrowania, tak aby wyświetlały się komórki o liczbie większej niż określona

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.

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

Parametry

NazwaTypOpis
numberNumberNajwyższa liczba do ukrycia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenNumberGreaterThanOrEqualTo(number)

Ustawia kryteria filtra, aby wyświetlić komórki z liczbą większą lub równą określonej liczbie.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.

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

Parametry

NazwaTypOpis
numberNumberNajniższa liczba do wyświetlenia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenNumberLessThan(number)

Ustawia kryteria filtrowania, tak aby wyświetlały się komórki, w przypadku których liczba jest mniejsza od określonej liczby.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.

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

Parametry

NazwaTypOpis
numberNumberNajniższa liczba do ukrycia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenNumberLessThanOrEqualTo(number)

Ustawia kryteria filtra, aby wyświetlić komórki z liczbą mniejszą lub równą określonej liczbie.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.

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

Parametry

NazwaTypOpis
numberNumberNajwyższa liczba do wyświetlenia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenNumberNotBetween(start, end)

Ustawia kryteria filtra, tak aby wyświetlały się w komórce liczby, które nie należą do żadnej z dwóch liczb.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.

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

Parametry

NazwaTypOpis
startNumberUkryj najniższy numer.
endNumberNajwyższa liczba do ukrycia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenNumberNotEqualTo(number)

Ustawia kryteria filtra tak, aby były wyświetlane komórki z liczbą, która nie jest równa określonej liczbie.

Tych kryteriów możesz użyć z dowolnym typem filtra. Jeśli używasz tych kryteriów w danych, które są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być liczbą. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, którą filtrujesz, nie musi być liczbą, ale może się zdarzyć, że wyniki będą nieoczekiwane.

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

Parametry

NazwaTypOpis
numberNumberNumer do ukrycia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenNumberNotEqualToAny(numbers)

Ustawia kryteria filtra tak, aby były wyświetlane komórki z liczbą, która nie jest równa żadnej z określonych liczb.

Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable, która została utworzona na podstawie arkusza DataSource.

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

Parametry

NazwaTypOpis
numbersNumber[]Numery do ukrycia.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenTextContains(text)

Ustawia kryteria filtrowania, tak aby wyświetlały komórki zawierające tekst. W tekście nie jest rozróżniana wielkość liter.

Tych kryteriów możesz użyć z dowolnym typem filtra.

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

Parametry

NazwaTypOpis
textStringTekst zawierający komórkę.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenTextDoesNotContain(text)

Ustawia kryteria filtra tak, aby wyświetlały się komórki z tekstem, który nie zawiera podanego tekstu. W tekście nie jest rozróżniana wielkość liter.

Tych kryteriów możesz użyć z dowolnym typem filtra.

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

Parametry

NazwaTypOpis
textStringTekst, który nie może zawierać komórki.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenTextEndsWith(text)

Ustawia kryteria filtrowania, tak aby wyświetlały się komórki z tekstem kończącym się na określonym tekście. W tekście nie jest rozróżniana wielkość liter.

Tych kryteriów możesz użyć z dowolnym typem filtra.

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

Parametry

NazwaTypOpis
textStringTekst, który musi zawierać koniec komórki.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenTextEqualTo(text)

Ustawia kryteria filtrowania, tak aby wyświetlały się komórki z tekstem równym określonemu tekstowi. W tekście nie jest rozróżniana wielkość liter.

Tych kryteriów możesz użyć z dowolnym typem filtra.

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

Parametry

NazwaTypOpis
textStringTekst w komórce musi być taki sam.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenTextEqualToAny(texts)

Ustawia kryteria filtra tak, aby wyświetlały się komórki z tekstem, który jest równy dowolnej z określonych wartości tekstowych. W tekście nie jest rozróżniana wielkość liter.

Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable, która została utworzona na podstawie arkusza DataSource.

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

Parametry

NazwaTypOpis
textsString[]Wartości tekstowe, które komórka musi być równa.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenTextNotEqualTo(text)

Ustawia kryteria filtrowania w celu wyświetlania komórek z tekstem, który nie jest równy określonemu tekstowi. W tekście nie jest rozróżniana wielkość liter.

Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable, która została utworzona na podstawie arkusza DataSource.

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

Parametry

NazwaTypOpis
textStringTekst, którego komórka nie jest równa.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenTextNotEqualToAny(texts)

Ustawia kryteria filtra tak, aby wyświetlały się komórki z tekstem, który nie jest zgodny z określoną wartością. W tekście nie jest rozróżniana wielkość liter.

Te kryteria można stosować tylko w przypadku danych połączonych z bazą danych. Możesz użyć tych kryteriów na przykład przy użyciu filtrów w arkuszu DataSource, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable, która została utworzona na podstawie arkusza DataSource.

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

Parametry

NazwaTypOpis
textsString[]Wartości tekstowe, których komórka nie może być równa.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


whenTextStartsWith(text)

Ustawia kryteria filtrowania, tak aby wyświetlały się komórki z tekstem zaczynającym się od określonego tekstu. W tekście nie jest rozróżniana wielkość liter.

Tych kryteriów możesz użyć z dowolnym typem filtra.

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

Parametry

NazwaTypOpis
textStringTekst, który musi zawierać początek komórki.

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.


withCriteria(criteria, args)

Ustawia warunek filtra na wartość logiczną zdefiniowaną przez wartości BooleanCriteria, np. CELL_EMPTY lub NUMBER_GREATER_THAN. Aby skopiować warunek logiczny z istniejących kryteriów, zdefiniuj parametry tej metody za pomocą właściwości getCriteriaType() i getCriteriaValues().

Te kryteria można stosować z dowolnym typem filtra, ale niektóre filtry (BooleanCriteria) nie mają zastosowania do wszystkich filtrów.

// Builds a filter criteria that is based on existing boolean conditions from another criteria.
// Gets the existing filter on the sheet.
const ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
// Gets the existing boolean conditions applied to Column B and adds criteria to column C that
// has the same boolean conditions and additional criteria that hides the value, "Northwest."
let filter = ss.getFilter();
let filterCriteria = filter.getColumnFilterCriteria(2);
let criteria = SpreadsheetApp.newFilterCriteria()
    .withCriteria(filterCriteria.getCriteriaType(), filterCriteria.getCriteriaValues())
    .setHiddenValues(["Northwest"])
    .build();
filter.setColumnFilterCriteria(3, criteria);

Parametry

NazwaTypOpis
criteriaBooleanCriteriaTyp kryteriów logicznych.
argsObject[]Tablica argumentów odpowiednich dla typu kryterium. Liczba argumentów i ich typu odpowiada danym when...().

Zwróć

FilterCriteriaBuilder – ten łańcuch do tworzenia łańcuchów.