Aby dodać kryteria do filtra:
- Utwórz konstruktor kryteriów za pomocą polecenia
SpreadsheetApp.newFilterCriteria()
. - Dodaj ustawienia do kreatora za pomocą metod z tej klasy.
- Użyj narzędzia
build()
, aby utworzyć kryteria z wybranymi ustawieniami.
Typowe zastosowania
Ukrywanie wartości w arkuszu
Poniższy przykład pobiera istniejący filtr w arkuszu i dodaje kryteria ukrywające w kolumnie C komórki zawierające słowa „witaj” lub „świecie”. Kryteriów z tego przykładu można używać w filtrach tylko w arkuszachGrid
(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ład pokazuje dodanie filtra do arkuszaDataSource
połączonego z bazą danych, który ma kryteria wyświetlające tylko komórki z kolumny „Kategoria”, które nie są puste.
// 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
Metoda | Zwracany typ | Krótki opis |
---|---|---|
build() | FilterCriteria | Tworzy kryteria filtrowania za pomocą ustawień dodanych do kreatora kryteriów. |
copy() | FilterCriteriaBuilder | Kopiuje kryteria filtra i tworzy konstruktor kryteriów, który można stosować do innego filtra. |
getCriteriaType() | BooleanCriteria | Zwraca typ wartości logicznej kryterium, np. CELL_EMPTY . |
getCriteriaValues() | Object[] | Zwraca tablicę argumentów kryteriów logicznych. |
getHiddenValues() | String[] | Zwraca wartości ukryte przez filtr. |
getVisibleBackgroundColor() | Color | Zwraca kolor tła używany jako kryterium filtra. |
getVisibleForegroundColor() | Color | Zwraca kolor pierwszego planu używany jako kryterium filtra. |
getVisibleValues() | String[] | Zwraca wartości wyświetlane przez filtr tabeli przestawnej. |
setHiddenValues(values) | FilterCriteriaBuilder | Ustawia wartości do ukrycia. |
setVisibleBackgroundColor(visibleBackgroundColor) | FilterCriteriaBuilder | Ustawia kolor tła używany jako kryteria filtrowania. |
setVisibleForegroundColor(visibleForegroundColor) | FilterCriteriaBuilder | Ustawia kolor pierwszego planu używany jako kryteria filtrowania. |
setVisibleValues(values) | FilterCriteriaBuilder | Ustawia wartości wyświetlane w tabeli przestawnej. |
whenCellEmpty() | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlać puste komórki. |
whenCellNotEmpty() | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki, które nie są puste. |
whenDateAfter(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z datami przypadającymi po określonej dacie. |
whenDateAfter(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z datami przypadającymi po określonej dacie względnej. |
whenDateBefore(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z datami sprzed określonej daty. |
whenDateBefore(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z datami sprzed określonej daty względnej. |
whenDateEqualTo(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania zawierające komórki z datami zgodnymi z określoną datą. |
whenDateEqualTo(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z datami równymi określonej daty względnej. |
whenDateEqualToAny(dates) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z datami takimi jak dowolna z podanych dat. |
whenDateNotEqualTo(date) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlały się komórki, które nie są zgodne z określoną datą. |
whenDateNotEqualToAny(dates) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z datami, które nie są takie same jak żadna z podanych dat. |
whenFormulaSatisfied(formula) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlać komórki z określoną formułą (np. =B:B<C:C ), która daje wartość true . |
whenNumberBetween(start, end) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z liczbą mieszczącą się między 2 określonymi liczbami lub któraś z nich. |
whenNumberEqualTo(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą równą określonej liczbie. |
whenNumberEqualToAny(numbers) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbami równą dowolnej z określonych liczb. |
whenNumberGreaterThan(number) | FilterCriteriaBuilder | Ustala kryteria filtrowania, aby wyświetlić komórki z liczbą większą od określonej wartości |
whenNumberGreaterThanOrEqualTo(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania w taki sposób, aby wyświetlane były komórki o liczbie większej lub równej określonej liczbie. |
whenNumberLessThan(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą mniejszą niż określona liczba. |
whenNumberLessThanOrEqualTo(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania w taki sposób, aby wyświetlane były komórki o liczbie mniejszej niż lub równej określonej liczbie. |
whenNumberNotBetween(start, end) | FilterCriteriaBuilder | Ustawia kryteria filtrowania w taki sposób, aby komórki z liczbą nie należącą do zakresu 2 określonych liczb nie znajdowały się między nimi. |
whenNumberNotEqualTo(number) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą, która nie jest równa określonej liczbie. |
whenNumberNotEqualToAny(numbers) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą, która nie jest równa żadnej z określonych liczb. |
whenTextContains(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki zawierające tekst zawierający określony tekst. |
whenTextDoesNotContain(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który nie zawiera określonego tekstu. |
whenTextEndsWith(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem, który kończy się określonym tekstem. |
whenTextEqualTo(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem równym określonemu tekstowi. |
whenTextEqualToAny(texts) | FilterCriteriaBuilder | Ustawia kryteria filtrowania w taki sposób, aby wyświetlać komórki z tekstem, który jest równy dowolnej z podanych wartości tekstowych. |
whenTextNotEqualTo(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem, który nie jest równy określonemu tekstowi. |
whenTextNotEqualToAny(texts) | FilterCriteriaBuilder | Ustawia kryteria filtrowania tak, aby wyświetlać komórki z tekstem, który nie jest równy żadnej z podanych wartości. |
whenTextStartsWith(text) | FilterCriteriaBuilder | Ustawia kryteria filtrowania, 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 przez wartości BooleanCriteria , np. CELL_EMPTY lub NUMBER_GREATER_THAN . |
Szczegółowa dokumentacja
build()
Tworzy kryteria filtrowania za pomocą 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);
Powroty
FilterCriteria
– kryteria filtrowania.
copy()
Kopiuje kryteria filtra i tworzy konstruktor kryteriów, który można stosować do innego filtra.
Tej metody możesz używać z każdym typem filtra. Jeśli używasz filtra arkusza, możesz je skopiować 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);
Powroty
FilterCriteriaBuilder
– kreator kryteriów filtrowania oparty na tych kryteriach.
getCriteriaType()
Zwraca typ wartości logicznej kryterium, np. CELL_EMPTY
. Informacje o typach kryteriów logicznych znajdziesz w artykule o wyliczeniu BooleanCriteria
.
Użytkownicy często używają tej metody, aby dodawać do filtra kryteria warunku logicznego bez zastępowania dotychczasowych kryteriów.
- Aby uzyskać argumenty kryterium, użyj funkcji
getCriteriaValues()
. - Aby użyć typu i wartości kryteriów do tworzenia lub modyfikowania kryteriów filtra, przeczytaj sekcję
withCriteria(criteria, args)
.
Tej metody możesz używać w przypadku każdego typu filtra. Jeśli kryterium filtra nie jest warunkiem logicznym, 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);
Powroty
BooleanCriteria
– typ kryterium logicznego lub null
, jeśli kryterium nie jest warunkiem logicznym.
getCriteriaValues()
Zwraca tablicę argumentów kryteriów logicznych. Niektóre typy kryteriów logicznych nie mają argumentów i zwracają pustą tablicę, np. CELL_NOT_EMPTY
.
Użytkownicy często używają tej metody, aby dodawać do filtra kryteria warunku logicznego bez zastępowania dotychczasowych kryteriów.
- Aby pobrać typ kryteriów logicznych, użyj
getCriteriaType()
. - Aby użyć typu i wartości kryteriów do utworzenia lub zmiany kryteriów filtra, przeczytaj sekcję
withCriteria(criteria, args)
.Tej metody możesz używać w przypadku każdego 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);
Powroty
Object[]
– tablica argumentów odpowiednich dla typu kryteriów logicznych. Liczba argumentów i ich typ są zgodne z odpowiednią metodąwhen...()
klasyFilterCriteriaBuilder
.
getHiddenValues()
Zwraca wartości ukryte przez filtr.
Użyj tego kryterium w filtrach w Grid
arkuszach (domyślnym typem arkusza).
Zwraca wartość null
, jeśli wywołujesz tę metodę w przypadku innych rodzajó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);
Powroty
String[]
– tablica wartości ukrywanych przez filtr.
getVisibleBackgroundColor()
Zwraca kolor tła używany jako kryterium filtra. Komórki z tym kolorem tła pozostają widoczne.
Użyj tego kryterium w filtrach w Grid
arkuszach (domyślnym typem arkusza).
Zwraca wartość null
, jeśli wywołujesz tę metodę w przypadku innych rodzajó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);
Powroty
Color
– kolor tła używany jako kryterium filtra.
getVisibleForegroundColor()
Zwraca kolor pierwszego planu używany jako kryterium filtra. Komórki z tym kolorem pierwszego planu pozostają widoczne.
Użyj tego kryterium w filtrach w Grid
arkuszach (domyślnym typem arkusza).
Zwraca wartość null
, jeśli wywołujesz tę metodę w przypadku innych rodzajó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);
Powroty
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. 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);
Powroty
String[]
– tablica wartości pokazywanych przez filtr tabeli przestawnej.
setHiddenValues(values)
Ustawia wartości do ukrycia. Usuwa wszystkie istniejące i ukryte wartości.
Tych kryteriów możesz używać do filtrów tylko w Grid
arkuszach (domyślnym typem 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
Nazwa | Typ | Opis |
---|---|---|
values | String[] | Lista wartości do ukrycia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
setVisibleBackgroundColor(visibleBackgroundColor)
Ustawia kolor tła używany jako kryteria filtrowania. Komórki z tym kolorem tła pozostają widoczne. Ustawienie kryteriów filtrowania kolorów tła powoduje usunięcie z tego kreatora wszystkich bieżących kryteriów filtra kolorów.
Tych kryteriów możesz używać do filtrów tylko w Grid
arkuszach (domyślnym typem 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
Nazwa | Typ | Opis |
---|---|---|
visibleBackgroundColor | Color | Kolor tła do ustawienia. Kolor musi być w stylu RGB. Ta metoda nie obsługuje kolorów motywu. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
setVisibleForegroundColor(visibleForegroundColor)
Ustawia kolor pierwszego planu używany jako kryteria filtrowania. Komórki z tym kolorem pierwszego planu pozostają widoczne. Ustawienie kryteriów filtrowania kolorów pierwszego planu powoduje usunięcie z tego kreatora wszystkich bieżących kryteriów filtra kolorów.
Tych kryteriów możesz używać do filtrów tylko w Grid
arkuszach (domyślnym typem 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
Nazwa | Typ | Opis |
---|---|---|
visibleForegroundColor | Color | Kolor pierwszego planu do ustawienia. Kolor musi być w stylu RGB. Ta metoda nie obsługuje kolorów motywu. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
setVisibleValues(values)
Ustawia wartości wyświetlane w tabeli przestawnej. Usuwa wszystkie istniejące i ukryte wartości.
Tych kryteriów możesz używać tylko do 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
Nazwa | Typ | Opis |
---|---|---|
values | String[] | Lista wartości do pokazania. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenCellEmpty()
Ustawia kryteria filtrowania tak, aby wyświetlać puste komórki.
Tego kryterium możesz używać z każdym 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);
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenCellNotEmpty()
Ustawia kryteria filtrowania, aby wyświetlać komórki, które nie są puste.
Tego kryterium możesz używać z każdym 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);
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenDateAfter(date)
Ustawia kryteria filtrowania, aby wyświetlać komórki z datami przypadającymi po określonej dacie.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typem danych w kolumnie, według której filtrujesz, musi być data. Jeśli dane nie są połączone z bazą danych, typ danych kolumny filtrowanej nie musi być datą, ale jeśli nie jest, możesz otrzymać 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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Ostatni dzień do ukrycia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenDateAfter(date)
Ustawia kryteria filtrowania, aby wyświetlać komórki z datami przypadającymi po określonej dacie względnej. Aby wyświetlić opcje dat względnych, zapoznaj się z tabelą Wyliczenie RelativeDate
.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typem danych w kolumnie, według której filtrujesz, musi być data. Jeśli dane nie są połączone z bazą danych, typ danych kolumny filtrowanej nie musi być datą, ale jeśli nie jest, możesz otrzymać 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
Nazwa | Typ | Opis |
---|---|---|
date | RelativeDate | Najnowsza względna data. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenDateBefore(date)
Ustawia kryteria filtrowania, aby wyświetlać komórki z datami sprzed określonej daty.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typem danych w kolumnie, według której filtrujesz, musi być data. Jeśli dane nie są połączone z bazą danych, typ danych kolumny filtrowanej nie musi być datą, ale jeśli nie jest, możesz otrzymać 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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Najwcześniejsza data do ukrycia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenDateBefore(date)
Ustawia kryteria filtrowania, aby wyświetlać komórki z datami sprzed określonej daty względnej.
Aby wyświetlić opcje dat względnych, zapoznaj się z sekcją Wyliczenie RelativeDate
.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typem danych w kolumnie, według której filtrujesz, musi być data. Jeśli dane nie są połączone z bazą danych, typ danych kolumny filtrowanej nie musi być datą, ale jeśli nie jest, możesz otrzymać 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
Nazwa | Typ | Opis |
---|---|---|
date | RelativeDate | Najwcześniejsza względna data do ukrycia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenDateEqualTo(date)
Ustawia kryteria filtrowania zawierające komórki z datami zgodnymi z określoną datą.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typem danych w kolumnie, według której filtrujesz, musi być data. Jeśli dane nie są połączone z bazą danych, typ danych kolumny filtrowanej nie musi być datą, ale jeśli nie jest, możesz otrzymać 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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Data, której wartości w komórkach muszą być zgodne. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenDateEqualTo(date)
Ustawia kryteria filtrowania, aby wyświetlać komórki z datami równymi określonej daty względnej.
Aby wyświetlić opcje dat względnych, zapoznaj się z sekcją Wyliczenie RelativeDate
.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych z bazą danych, typem danych w kolumnie, według której filtrujesz, musi być data. Jeśli dane nie są połączone z bazą danych, typ danych kolumny filtrowanej nie musi być datą, ale jeśli nie jest, możesz otrzymać 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
Nazwa | Typ | Opis |
---|---|---|
date | RelativeDate | Względna data, do której muszą pasować wartości w komórkach. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenDateEqualToAny(dates)
Ustawia kryteria filtrowania, aby wyświetlać komórki z datami takimi jak dowolna z podanych dat.
Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
utworzonej z 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
Nazwa | Typ | Opis |
---|---|---|
dates | Date[] | Daty do wyświetlenia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenDateNotEqualTo(date)
Ustawia kryteria filtrowania tak, aby wyświetlały się komórki, które nie są zgodne z określoną datą.
Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
utworzonej z 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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Data do ukrycia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenDateNotEqualToAny(dates)
Ustawia kryteria filtrowania, aby wyświetlać komórki z datami, które nie są takie same jak żadna z podanych dat.
Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
utworzonej z 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
Nazwa | Typ | Opis |
---|---|---|
dates | Date[] | Daty do ukrycia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenFormulaSatisfied(formula)
Ustawia kryteria filtrowania tak, aby wyświetlać komórki z określoną formułą (np. =B:B<C:C
), która daje wartość true
.
Tych kryteriów 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(); 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
Nazwa | Typ | Opis |
---|---|---|
formula | String | Formuła niestandardowa, która zwraca wartość true , jeśli dane wejściowe są prawidłowe. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenNumberBetween(start, end)
Ustawia kryteria filtrowania, aby wyświetlić komórki z liczbą mieszczącą się między 2 określonymi liczbami lub któraś z nich.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych 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 filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.
// 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
Nazwa | Typ | Opis |
---|---|---|
start | Number | Najniższa liczba do wyświetlenia. |
end | Number | Najwyższa liczba do wyświetlenia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenNumberEqualTo(number)
Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą równą określonej liczbie.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych 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 filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.
// 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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Liczba do wyświetlenia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenNumberEqualToAny(numbers)
Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbami równą dowolnej z określonych liczb.
Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
utworzonej z 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
Nazwa | Typ | Opis |
---|---|---|
numbers | Number[] | Liczby do pokazania. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenNumberGreaterThan(number)
Ustala kryteria filtrowania, aby wyświetlić komórki z liczbą większą od określonej wartości
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych 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 filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.
// 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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Największa liczba do ukrycia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenNumberGreaterThanOrEqualTo(number)
Ustawia kryteria filtrowania w taki sposób, aby wyświetlane były komórki o liczbie większej lub równej określonej liczbie.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych 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 filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.
// 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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najniższa liczba do wyświetlenia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenNumberLessThan(number)
Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą mniejszą niż określona liczba.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych 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 filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.
// 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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najniższa liczba do ukrycia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenNumberLessThanOrEqualTo(number)
Ustawia kryteria filtrowania w taki sposób, aby wyświetlane były komórki o liczbie mniejszej niż lub równej określonej liczbie.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych 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 filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.
// 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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najwyższa liczba do wyświetlenia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenNumberNotBetween(start, end)
Ustawia kryteria filtrowania w taki sposób, aby komórki z liczbą nie należącą do zakresu 2 określonych liczb nie znajdowały się między nimi.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych 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 filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.
// 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
Nazwa | Typ | Opis |
---|---|---|
start | Number | Ukryj najniższą liczbę. |
end | Number | Największa liczba do ukrycia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenNumberNotEqualTo(number)
Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą, która nie jest równa określonej liczbie.
Tego kryterium możesz używać z każdym typem filtra. Jeśli używasz tych kryteriów do danych połączonych 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 filtrowanej nie musi być liczbą, ale jeśli nie jest, możesz otrzymać nieoczekiwane wyniki.
// 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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Liczba do ukrycia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenNumberNotEqualToAny(numbers)
Ustawia kryteria filtrowania, aby wyświetlać komórki z liczbą, która nie jest równa żadnej z określonych liczb.
Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
utworzonej z 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
Nazwa | Typ | Opis |
---|---|---|
numbers | Number[] | Liczby do ukrycia. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenTextContains(text)
Ustawia kryteria filtrowania, aby wyświetlać komórki zawierające tekst zawierający określony tekst. Wielkość liter w tekście nie jest rozróżniana.
Tego kryterium możesz używać z każdym 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
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst, który musi zawierać komórka. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenTextDoesNotContain(text)
Ustawia kryteria filtrowania, aby wyświetlić komórki z tekstem, który nie zawiera określonego tekstu. Wielkość liter w tekście nie jest rozróżniana.
Tego kryterium możesz używać z każdym 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
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst, którego komórka nie może zawierać. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenTextEndsWith(text)
Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem, który kończy się określonym tekstem. Wielkość liter w tekście nie jest rozróżniana.
Tego kryterium możesz używać z każdym 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
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst, który musi zawierać koniec tekstu komórki. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenTextEqualTo(text)
Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem równym określonemu tekstowi. Wielkość liter w tekście nie jest rozróżniana.
Tego kryterium możesz używać z każdym 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
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst, którym musi równać się tekst komórki. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenTextEqualToAny(texts)
Ustawia kryteria filtrowania w taki sposób, aby wyświetlać komórki z tekstem, który jest równy dowolnej z podanych wartości tekstowych. Wielkość liter w tekście nie jest rozróżniana.
Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
utworzonej z 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
Nazwa | Typ | Opis |
---|---|---|
texts | String[] | Wartości tekstowe, które musi być równa komórka. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenTextNotEqualTo(text)
Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem, który nie jest równy określonemu tekstowi. Wielkość liter w tekście nie jest rozróżniana.
Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
utworzonej z 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
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst, którego tekst w komórce nie może się równać. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenTextNotEqualToAny(texts)
Ustawia kryteria filtrowania tak, aby wyświetlać komórki z tekstem, który nie jest równy żadnej z podanych wartości. Wielkość liter w tekście nie jest rozróżniana.
Tych kryteriów możesz używać tylko w przypadku danych połączonych z bazą danych. Tych kryteriów możesz na przykład użyć w filtrach w arkuszu DataSource
, arkuszu połączonym z bazą danych lub w tabeli przestawnej DataSourcePivotTable
utworzonej z 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
Nazwa | Typ | Opis |
---|---|---|
texts | String[] | Wartości tekstowe, które nie mogą być równe. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
whenTextStartsWith(text)
Ustawia kryteria filtrowania, aby wyświetlać komórki z tekstem, który zaczyna się od określonego tekstu. Wielkość liter w tekście nie jest rozróżniana.
Tego kryterium możesz używać z każdym 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
Nazwa | Typ | Opis |
---|---|---|
text | String | Tekst, który musi zawierać początek tekstu komórki. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.
withCriteria(criteria, args)
Ustawia kryteria filtrowania na warunek logiczny zdefiniowany przez wartości BooleanCriteria
, np. CELL_EMPTY
lub NUMBER_GREATER_THAN
. Aby skopiować warunek logiczny z istniejących kryteriów, określ parametry tej metody za pomocą funkcji getCriteriaType()
i getCriteriaValues()
w istniejących kryteriach.
Tego kryterium możesz używać z każdym typem filtra, ale niektóre właściwości 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
Nazwa | Typ | Opis |
---|---|---|
criteria | BooleanCriteria | Typ kryteriów logicznych. |
args | Object[] | Tablica argumentów odpowiednich do typu kryteriów; liczba argumentów i ich typ są zgodne z odpowiednimi metodami when...() powyżej. |
Powroty
FilterCriteriaBuilder
– kreator do tworzenia łańcuchów.