Class FilterCriteriaBuilder

FiltrKryteriaBuilder

Aby dodać kryteria do filtra, wykonaj te czynności:

1. Utwórz konstruktor kryteriów za pomocą SpreadsheetApp.newFilterCriteria().
2. Dodaj ustawienia do kreatora, korzystając z metod tej klasy.
3. Użyj elementu build(), aby utworzyć kryteria z określonymi ustawieniami.

Typowe zastosowania

Ukrywanie wartości w arkuszu

Ten przykładowy arkusz pobiera istniejący filtr arkusza i dodaje kryteria, które ukrywa komórki w kolumnie C, które zawierają „hello” lub „world”. Kryteriów w tym przykładzie można używać tylko z filtrami w arkuszach Grid, czyli domyślnego typu arkusza.

const ss = SpreadsheetApp.getActiveSheet();
const filter = ss.getFilter();
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setHiddenValues(['hello', 'world'])
                     .build();
filter.setColumnFilterCriteria(3, criteria);

Pokaż tylko niepuste komórki

W tym przykładzie do arkusza DataSource, który jest połączony z bazą danych, dodajemy filtr z kryteriami, które uwzględniają tylko komórki w kolumnie „Kategoria”, które nie są puste.

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

Metody

Metoda	Zwracany typ	Krótki opis
build()	FilterCriteria	Tworzy kryteria filtra na podstawie ustawień dodanych do kreatora kryteriów.
copy()	FilterCriteriaBuilder	Kopiuje to kryterium filtra i tworzy kreator kryteriów, który możesz zastosować do innego filtra.
getCriteriaType()	BooleanCriteria	Zwraca typ logiczny kryterium, np. CELL_EMPTY.
getCriteriaValues()	Object[]	Zwraca tablicę argumentów dla kryteriów logicznych.
getHiddenValues()	String[]	Zwraca wartości, które filtr ukrywa.
getVisibleBackgroundColor()	Color	Zwraca kolor tła użyty jako kryterium filtra.
getVisibleForegroundColor()	Color	Zwraca kolor pierwszego planu użyty jako kryterium filtra.
getVisibleValues()	String[]	Zwraca wartości wyświetlane przez filtr tabeli przestawnej.
setHiddenValues(values)	FilterCriteriaBuilder	Określa wartości do ukrycia.
setVisibleBackgroundColor(visibleBackgroundColor)	FilterCriteriaBuilder	Umożliwia ustawienie koloru tła używanego jako kryterium filtra.
setVisibleForegroundColor(visibleForegroundColor)	FilterCriteriaBuilder	Ustawia kolor pierwszego planu używany jako kryterium filtra.
setVisibleValues(values)	FilterCriteriaBuilder	Ustawia wartości do wyświetlania w tabeli przestawnej.
whenCellEmpty()	FilterCriteriaBuilder	Ustawia kryteria filtra tak, aby wyświetlały puste komórki.
whenCellNotEmpty()	FilterCriteriaBuilder	Ustawia kryteria filtrowania tak, aby wyświetlać komórki, które nie są puste.
whenDateAfter(date)	FilterCriteriaBuilder	Ustawia kryteria filtra, które powodują wyświetlanie komórek z datami po wybranej dacie.
whenDateAfter(date)	FilterCriteriaBuilder	Ustawia kryteria filtra, które pokazują komórki z datami po wybranej dacie względnej.
whenDateBefore(date)	FilterCriteriaBuilder	Ustawia kryteria filtra, które pokazują komórki z datami wcześniejszymi niż wybrana data.
whenDateBefore(date)	FilterCriteriaBuilder	Ustawia kryteria filtra, które powodują wyświetlanie komórek z datami poprzedzającymi wybraną datę względną.
whenDateEqualTo(date)	FilterCriteriaBuilder	Ustawia kryteria filtra, które wyświetlają komórki z datami równymi podanej dacie.
whenDateEqualTo(date)	FilterCriteriaBuilder	Ustawia kryteria filtra, które pokazują komórki z datami równymi podanej względnej dacie.
whenDateEqualToAny(dates)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlać komórki z datami równymi dowolnej z podanych dat.
whenDateNotEqualTo(date)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlić komórki, które nie są równe podanej dacie.
whenDateNotEqualToAny(dates)	FilterCriteriaBuilder	Ustawia kryteria filtra tak, aby wyświetlały komórki z datami, które nie są równe żadnej z określonych dat.
whenFormulaSatisfied(formula)	FilterCriteriaBuilder	Ustawia kryteria filtra tak, aby wyświetlać komórki z określoną formułą (np. =B:B<C:C), która zwraca wartość true.
whenNumberBetween(start, end)	FilterCriteriaBuilder	Ustawia kryteria filtra tak, aby wyświetlać komórki z liczbą, która mieści się między 2 określonymi liczbami lub jest jedną z tych liczb.
whenNumberEqualTo(number)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlić komórki z liczbą równą podanej liczbie.
whenNumberEqualToAny(numbers)	FilterCriteriaBuilder	Ustawia kryteria filtra tak, aby wyświetlać komórki z liczbą równą dowolnej z określonych liczb.
whenNumberGreaterThan(number)	FilterCriteriaBuilder	Ustawia kryteria filtra tak, aby wyświetlać komórki z liczbą większą niż określona liczba
whenNumberGreaterThanOrEqualTo(number)	FilterCriteriaBuilder	Ustawia kryteria filtra tak, aby wyświetlać komórki z liczbą większą lub równą określonej liczbie.
whenNumberLessThan(number)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlić komórki z liczbą mniejszą niż określona.
whenNumberLessThanOrEqualTo(number)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlić komórki z liczbą mniejszą lub równą określonej liczbie.
whenNumberNotBetween(start, end)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlić komórki z liczbą, która nie mieści się w zakresie 2 określonych liczb.
whenNumberNotEqualTo(number)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlać komórki z liczbą, która nie jest równa określonej liczbie.
whenNumberNotEqualToAny(numbers)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlać komórki z liczbą, która nie jest równa żadnej z określonych liczb.
whenTextContains(text)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlać komórki z tekstem zawierającym określony tekst.
whenTextDoesNotContain(text)	FilterCriteriaBuilder	Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem, który nie zawiera określonego tekstu.
whenTextEndsWith(text)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlać komórki z tekstem, który kończy się określonym tekstem.
whenTextEqualTo(text)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlać komórki z tekstem równym podanemu tekstowi.
whenTextEqualToAny(texts)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlać komórki z tekstem równym dowolnej z określonych wartości tekstowych.
whenTextNotEqualTo(text)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlać komórki z tekstem, który nie jest równy podanemu tekstowi.
whenTextNotEqualToAny(texts)	FilterCriteriaBuilder	Ustawia kryteria filtra tak, aby wyświetlać komórki z tekstem, który nie jest równy żadnej z określonych wartości.
whenTextStartsWith(text)	FilterCriteriaBuilder	Ustawia kryteria filtra, aby wyświetlać komórki z tekstem, który zaczyna się od określonego tekstu.
withCriteria(criteria, args)	FilterCriteriaBuilder	Ustawia kryteria filtrowania na warunek logiczny zdefiniowany za pomocą wartości BooleanCriteria, takich jak CELL_EMPTY lub NUMBER_GREATER_THAN.

Szczegółowa dokumentacja

build()

Tworzy kryteria filtra na podstawie ustawień dodanych do kreatora kryteriów.

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

Powrót

FilterCriteria – reprezentacja kryteriów filtra.

---

copy()

Kopiuje to kryterium filtra i tworzy kreator kryteriów, który możesz zastosować do innego filtra.

Z tej metody możesz korzystać w przypadku dowolnego typu filtra. Jeśli używasz filtra arkusza, możesz skopiować kryteria do innej kolumny.

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

Powrót

FilterCriteriaBuilder – kreator kryteriów filtra oparty na tych kryteriach.

---

getCriteriaType()

Zwraca typ logiczny kryterium, np. CELL_EMPTY. Więcej informacji o typach kryteriów logicznych znajdziesz w enumeracji BooleanCriteria.

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

• Aby uzyskać argumenty dla kryteriów, użyj getCriteriaValues().
• Aby utworzyć lub zmodyfikować kryteria filtrowania, korzystając z typu kryteriów i ich wartości, zapoznaj się z artykułem withCriteria(criteria, args).

Możesz używać tej metody w przypadku dowolnego typu filtra. Jeśli kryteria filtra nie są warunkiem logicznym, zwracają wartość 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);

Powrót

BooleanCriteria – typ kryterium logicznego lub null, jeśli kryterium nie jest warunkiem logicznym.

---

getCriteriaValues()

Zwraca tablicę argumentów dla kryteriów logicznych. Niektóre typy kryteriów logicznych nie mają argumentów i zwracają pusty tablic, np. CELL_NOT_EMPTY.

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

• Aby uzyskać typ kryteriów logicznych, użyj getCriteriaType().
• Aby utworzyć lub zmodyfikować kryterium filtra, korzystając z typu kryterium i jego wartości, zapoznaj się z artykułem withCriteria(criteria, args).

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

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

  Powrót

  Object[] – tablica argumentów odpowiednich do typu kryteriów logicznych. Liczba argumentów i ich typ odpowiadają odpowiedniej metodzie when...() klasy FilterCriteriaBuilder.

---

getHiddenValues()

Zwraca wartości, które filtr ukrywa.

Użyj tego kryterium z filtrami w arkuszach Grid, czyli arkuszach o domyślnym typie. Zwraca null, jeśli wywołujesz tę metodę w przypadku innych typów filtrów.

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

Powrót

String[] – tablica wartości, które filtr ukrywa.

---

getVisibleBackgroundColor()

Zwraca kolor tła użyty jako kryterium filtra. Komórki o tym kolorze tła pozostają widoczne.

Użyj tego kryterium z filtrami w arkuszach Grid, czyli arkuszach o domyślnym typie. Zwraca null, jeśli wywołujesz tę metodę w przypadku innych typów filtrów.

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

Powrót

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

---

getVisibleForegroundColor()

Zwraca kolor pierwszego planu użyty jako kryterium filtra. Komórki o tym kolorze pierwszego planu pozostają widoczne.

Użyj tego kryterium z filtrami w arkuszach Grid, czyli arkuszach o domyślnym typie. Zwraca null, jeśli wywołujesz tę metodę w przypadku innych typów filtrów.

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

Powrót

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

---

getVisibleValues()

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

To kryterium dotyczy tylko filtrów w tabelach przestawnych, które nie są połączone z bazą danych. W przypadku innych typów filtrów zwraca pustą tablicę.

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

Powrót

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

---

setHiddenValues(values)

Określa wartości do ukrycia. Czyści wszystkie istniejące widoczne lub ukryte wartości.

Tego kryterium możesz używać tylko w przypadku filtrów w arkuszach Grid, które są domyślnym typem arkusza.

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

Parametry

Nazwa	Typ	Opis
values	String[]	Lista wartości do ukrycia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Rzuty

Error – jeśli jakakolwiek z wartości to null.

---

setVisibleBackgroundColor(visibleBackgroundColor)

Umożliwia ustawienie koloru tła używanego jako kryterium filtra. Komórki o tym kolorze tła pozostają widoczne. Ustawienie kryteriów filtra koloru tła powoduje usunięcie wszystkich bieżących kryteriów filtra koloru z tego kreatora.

Tego kryterium możesz używać tylko w przypadku filtrów w arkuszach Grid, które są domyślnym typem arkusza.

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

Parametry

Nazwa	Typ	Opis
visibleBackgroundColor	Color	Kolor tła do ustawienia. Kolor musi być w stylu RGB. Ta metoda nie obsługuje kolorów motywu.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

setVisibleForegroundColor(visibleForegroundColor)

Ustawia kolor pierwszego planu używany jako kryterium filtra. Komórki o tym kolorze pierwszego planu pozostają widoczne. Ustawienie kryteriów filtra koloru pierwszego planu spowoduje usunięcie wszystkich bieżących kryteriów filtra koloru z tego kreatora.

Tego kryterium możesz używać tylko w przypadku filtrów w arkuszach Grid, które są domyślnym typem arkusza.

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

Parametry

Nazwa	Typ	Opis
visibleForegroundColor	Color	Kolor pierwszego planu do ustawienia. Kolor musi być w stylu RGB. Ta metoda nie obsługuje kolorów motywu.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

setVisibleValues(values)

Ustawia wartości do wyświetlania w tabeli przestawnej. Czyści wszystkie istniejące widoczne lub ukryte wartości.

Tego kryterium możesz używać 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."
const pivotTable = ss.getPivotTables()[0];
const criteria = SpreadsheetApp.newFilterCriteria()
                     .setVisibleValues(['Northeast', 'Southwest'])
                     .build();
pivotTable.addFilter(2, criteria);

Parametry

Nazwa	Typ	Opis
values	String[]	Lista wartości do wyświetlenia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

Rzuty

Error – jeśli jakakolwiek z wartości to null.

---

whenCellEmpty()

Ustawia kryteria filtra tak, aby wyświetlały puste komórki.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenCellNotEmpty()

Ustawia kryteria filtrowania tak, aby wyświetlać komórki, które nie są puste.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenDateAfter(date)

Ustawia kryteria filtra, które powodują wyświetlanie komórek z datami po wybranej dacie.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu data. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być datą. Jeśli jednak tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
date	Date	Najnowsza data do ukrycia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenDateAfter(date)

Ustawia kryteria filtra, które pokazują komórki z datami po wybranej dacie względnej. Opcje daty względnej znajdziesz w sekcji Enum RelativeDate.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu data. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być datą. Jeśli jednak tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
date	RelativeDate	Najnowsza data względna.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenDateBefore(date)

Ustawia kryteria filtra, które pokazują komórki z datami wcześniejszymi niż wybrana data.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu data. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być datą. Jeśli jednak tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
date	Date	Najwcześniejsza data ukrycia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenDateBefore(date)

Ustawia kryteria filtra, które powodują wyświetlanie komórek z datami poprzedzającymi wybraną datę względną. Opcje daty względnej znajdziesz w enumeracji RelativeDate.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu data. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być datą. Jeśli jednak tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
date	RelativeDate	Najwcześniejsza data względna do ukrycia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenDateEqualTo(date)

Ustawia kryteria filtra, które wyświetlają komórki z datami równymi podanej dacie.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu data. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być datą. Jeśli jednak tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
date	Date	Data, której wartości komórek muszą być zgodne.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenDateEqualTo(date)

Ustawia kryteria filtra, które pokazują komórki z datami równymi podanej względnej dacie. Opcje daty względnej znajdziesz w enumeracji RelativeDate.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu data. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być datą. Jeśli jednak tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
date	RelativeDate	Data względna, która musi być zgodna z wartościami komórek.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenDateEqualToAny(dates)

Ustawia kryteria filtra, aby wyświetlać komórki z datami równymi dowolnej z podanych dat.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza 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);

Parametry

Nazwa	Typ	Opis
dates	Date[]	Daty do wyświetlenia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenDateNotEqualTo(date)

Ustawia kryteria filtra, aby wyświetlić komórki, które nie są równe podanej dacie.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza DataSource.

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

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

Parametry

Nazwa	Typ	Opis
date	Date	Data, którą chcesz ukryć.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenDateNotEqualToAny(dates)

Ustawia kryteria filtra tak, aby wyświetlały komórki z datami, które nie są równe żadnej z określonych dat.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza 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);

Parametry

Nazwa	Typ	Opis
dates	Date[]	Daty, które chcesz ukryć.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenFormulaSatisfied(formula)

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

Tego kryterium możesz używać tylko do filtrowania danych, które nie są połączone z bazą danych.

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

Parametry

Nazwa	Typ	Opis
formula	String	Formuła niestandardowa, która zwraca wartość true, jeśli dane wejściowe są prawidłowe.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenNumberBetween(start, end)

Ustawia kryteria filtra tak, aby wyświetlać komórki z liczbą, która mieści się między 2 określonymi liczbami lub jest jedną z tych liczb.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
start	Number	Najniższa liczba do wyświetlenia.
end	Number	Największa liczba do wyświetlenia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenNumberEqualTo(number)

Ustawia kryteria filtra, aby wyświetlić komórki z liczbą równą podanej liczbie.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
number	Number	Numer do wyświetlenia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenNumberEqualToAny(numbers)

Ustawia kryteria filtra tak, aby wyświetlać komórki z liczbą równą dowolnej z określonych liczb.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza 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);

Parametry

Nazwa	Typ	Opis
numbers	Number[]	Wyświetlane liczby.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenNumberGreaterThan(number)

Ustawia kryteria filtra tak, aby wyświetlać komórki z liczbą większą niż określona liczba

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
number	Number	Największa liczba do ukrycia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenNumberGreaterThanOrEqualTo(number)

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

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
number	Number	Najniższa liczba do wyświetlenia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenNumberLessThan(number)

Ustawia kryteria filtra, aby wyświetlić komórki z liczbą mniejszą niż określona.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
number	Number	Najmniejsza liczba do ukrycia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenNumberLessThanOrEqualTo(number)

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

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
number	Number	Największa liczba do wyświetlenia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenNumberNotBetween(start, end)

Ustawia kryteria filtra, aby wyświetlić komórki z liczbą, która nie mieści się w zakresie 2 określonych liczb.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
start	Number	Najmniejsza liczba ukryj.
end	Number	Największa liczba do ukrycia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenNumberNotEqualTo(number)

Ustawia kryteria filtra, aby wyświetlać komórki z liczbą, która nie jest równa określonej liczbie.

Tego kryterium możesz używać z dowolnym typem filtra. Jeśli używasz tego kryterium w przypadku danych połączonych z bazą danych, typ danych w kolumnie, według której filtrujesz, musi być typu Liczba. Jeśli dane nie są połączone z bazą danych, typ danych w kolumnie, według której filtrujesz, nie musi być liczbą, ale jeśli tak nie jest, możesz uzyskać nieoczekiwane wyniki.

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

Parametry

Nazwa	Typ	Opis
number	Number	Numer do ukrycia.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenNumberNotEqualToAny(numbers)

Ustawia kryteria filtra, aby wyświetlać komórki z liczbą, która nie jest równa żadnej z określonych liczb.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza 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);

Parametry

Nazwa	Typ	Opis
numbers	Number[]	Numery, które mają być ukryte.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenTextContains(text)

Ustawia kryteria filtra, aby wyświetlać komórki z tekstem zawierającym określony tekst. Wielkość liter nie ma znaczenia.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Parametry

Nazwa	Typ	Opis
text	String	Tekst, który musi zawierać komórka.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenTextDoesNotContain(text)

Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem, który nie zawiera określonego tekstu. Wielkość liter w tekście nie ma znaczenia.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Parametry

Nazwa	Typ	Opis
text	String	Tekst, którego komórka nie może zawierać.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenTextEndsWith(text)

Ustawia kryteria filtra, aby wyświetlać komórki z tekstem, który kończy się określonym tekstem. Wielkość liter nie ma znaczenia.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Parametry

Nazwa	Typ	Opis
text	String	Tekst, który musi zawierać koniec tekstu komórki.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenTextEqualTo(text)

Ustawia kryteria filtra, aby wyświetlać komórki z tekstem równym podanemu tekstowi. Wielkość liter nie ma znaczenia.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Parametry

Nazwa	Typ	Opis
text	String	Tekst, który musi być zgodny z tekstem komórki.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenTextEqualToAny(texts)

Ustawia kryteria filtra, aby wyświetlać komórki z tekstem równym dowolnej z określonych wartości tekstowych. Wielkość liter w tekście nie ma znaczenia.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza 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);

Parametry

Nazwa	Typ	Opis
texts	String[]	Wartości tekstowe, które musi zawierać komórka.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenTextNotEqualTo(text)

Ustawia kryteria filtra, aby wyświetlać komórki z tekstem, który nie jest równy podanemu tekstowi. Wielkość liter w tekście nie ma znaczenia.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza 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);

Parametry

Nazwa	Typ	Opis
text	String	Tekst, który nie może być taki sam jak tekst w komórce.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenTextNotEqualToAny(texts)

Ustawia kryteria filtra tak, aby wyświetlać komórki z tekstem, który nie jest równy żadnej z określonych wartości. Wielkość liter nie ma znaczenia.

Tego kryterium możesz używać tylko w przypadku danych połączonych z bazą danych. Możesz na przykład użyć tych kryteriów z filtrami w arkuszu DataSource, arkuszu połączonym z bazą danych lub DataSourcePivotTable, tabeli przestawnej utworzonej na podstawie arkusza 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);

Parametry

Nazwa	Typ	Opis
texts	String[]	Wartości tekstowe, których komórka nie może zawierać.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

whenTextStartsWith(text)

Ustawia kryteria filtra, aby wyświetlać komórki z tekstem, który zaczyna się od określonego tekstu. Wielkość liter nie ma znaczenia.

Tego kryterium możesz używać z dowolnym typem filtra.

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

Parametry

Nazwa	Typ	Opis
text	String	Tekst, który musi zawierać początek tekstu komórki.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.

---

withCriteria(criteria, args)

Ustawia kryteria filtrowania na warunek logiczny zdefiniowany za pomocą wartości BooleanCriteria, takich jak CELL_EMPTY lub NUMBER_GREATER_THAN. Aby skopiować warunek logiczny z dotychczasowych kryteriów, zdefiniuj parametry tej metody za pomocą elementów getCriteriaType() i getCriteriaValues() w dotychczasowych kryteriach.

Tego kryterium możesz używać z dowolnym typem filtra, ale niektóre BooleanCriteria nie są stosowane 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();
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);

Parametry

Nazwa	Typ	Opis
criteria	BooleanCriteria	Typ kryterium logicznego.
args	Object[]	tablica argumentów odpowiednich do typu kryteriów; liczba argumentów i ich typ odpowiadają odpowiednim metodom when...() wymienionym powyżej.

Powrót

FilterCriteriaBuilder – ten kreator do łańcuchowania.