Trang này được dịch bởi Cloud Translation API.

Class FilterCriteriaBuilder

Để thêm tiêu chí vào bộ lọc, bạn phải làm như sau:

Tạo trình tạo tiêu chí bằng SpreadsheetApp.newFilterCriteria().
Thêm chế độ cài đặt vào trình tạo bằng các phương thức trong lớp này.
Sử dụng build() để tập hợp các tiêu chí với chế độ cài đặt bạn chỉ định.

Các cách dùng phổ biến

Ẩn giá trị trên trang tính

Mẫu sau đây lấy bộ lọc hiện có của một trang tính và thêm tiêu chí ẩn các ô trong cột C chứa "hello" hoặc "world". Bạn chỉ có thể sử dụng tiêu chí trong mẫu này với các bộ lọc trên trang tính Grid, loại trang tính mặc định.

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

Chỉ hiển thị các ô không trống

Mẫu sau đây thêm một bộ lọc vào trang tính DataSource, một trang tính được kết nối với cơ sở dữ liệu, với tiêu chí chỉ hiển thị các ô trong cột "Danh mục" không trống.

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

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`build()`	`FilterCriteria`	Tập hợp các tiêu chí bộ lọc bằng cách sử dụng các chế độ cài đặt mà bạn thêm vào trình tạo tiêu chí.
`copy()`	`FilterCriteriaBuilder`	Sao chép tiêu chí bộ lọc này và tạo một trình tạo tiêu chí mà bạn có thể áp dụng cho một bộ lọc khác.
`getCriteriaType()`	`BooleanCriteria`	Trả về loại boolean của tiêu chí, ví dụ: `CELL_EMPTY`.
`getCriteriaValues()`	`Object[]`	Trả về một mảng đối số cho tiêu chí boolean.
`getHiddenValues()`	`String[]`	Trả về các giá trị mà bộ lọc ẩn.
`getVisibleBackgroundColor()`	`Color`	Trả về màu nền được dùng làm tiêu chí lọc.
`getVisibleForegroundColor()`	`Color`	Trả về màu nền trước được dùng làm tiêu chí lọc.
`getVisibleValues()`	`String[]`	Trả về các giá trị mà bộ lọc bảng tổng hợp hiển thị.
`setHiddenValues(values)`	`FilterCriteriaBuilder`	Đặt các giá trị cần ẩn.
`setVisibleBackgroundColor(visibleBackgroundColor)`	`FilterCriteriaBuilder`	Đặt màu nền được dùng làm tiêu chí lọc.
`setVisibleForegroundColor(visibleForegroundColor)`	`FilterCriteriaBuilder`	Đặt màu nền trước dùng làm tiêu chí lọc.
`setVisibleValues(values)`	`FilterCriteriaBuilder`	Đặt các giá trị cần hiển thị trên bảng tổng hợp.
`whenCellEmpty()`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô trống.
`whenCellNotEmpty()`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô không trống.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	Đặt tiêu chí bộ lọc cho thấy các ô có ngày sau ngày được chỉ định.
`whenDateAfter(date)`	`FilterCriteriaBuilder`	Đặt tiêu chí bộ lọc hiển thị các ô có ngày sau ngày tương đối được chỉ định.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc cho thấy các ô có ngày trước ngày được chỉ định.
`whenDateBefore(date)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc cho thấy các ô có ngày trước ngày tương đối đã chỉ định.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc cho thấy các ô có ngày bằng với ngày đã chỉ định.
`whenDateEqualTo(date)`	`FilterCriteriaBuilder`	Đặt tiêu chí bộ lọc cho thấy các ô có ngày bằng với ngày tương đối đã chỉ định.
`whenDateEqualToAny(dates)`	`FilterCriteriaBuilder`	Đặt tiêu chí bộ lọc để hiển thị các ô có ngày bằng với bất kỳ ngày nào được chỉ định.
`whenDateNotEqualTo(date)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô không bằng ngày đã chỉ định.
`whenDateNotEqualToAny(dates)`	`FilterCriteriaBuilder`	Đặt tiêu chí bộ lọc để hiển thị các ô có ngày không bằng bất kỳ ngày nào được chỉ định.
`whenFormulaSatisfied(formula)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có công thức được chỉ định (chẳng hạn như `=B:B<C:C`) có giá trị là `true`.
`whenNumberBetween(start, end)`	`FilterCriteriaBuilder`	Đặt tiêu chí bộ lọc để hiển thị các ô có số nằm giữa hoặc là một trong 2 số được chỉ định.
`whenNumberEqualTo(number)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có số bằng với số đã chỉ định.
`whenNumberEqualToAny(numbers)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có số bằng bất kỳ số nào đã chỉ định.
`whenNumberGreaterThan(number)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có số lớn hơn số đã chỉ định
`whenNumberGreaterThanOrEqualTo(number)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có số lớn hơn hoặc bằng số được chỉ định.
`whenNumberLessThan(number)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có số nhỏ hơn số đã chỉ định.
`whenNumberLessThanOrEqualTo(number)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có số nhỏ hơn hoặc bằng số đã chỉ định.
`whenNumberNotBetween(start, end)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có số không nằm giữa và không phải là một trong 2 số đã chỉ định.
`whenNumberNotEqualTo(number)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có số không bằng số đã chỉ định.
`whenNumberNotEqualToAny(numbers)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có số không bằng bất kỳ số nào đã chỉ định.
`whenTextContains(text)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có văn bản chứa văn bản đã chỉ định.
`whenTextDoesNotContain(text)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có văn bản không chứa văn bản đã chỉ định.
`whenTextEndsWith(text)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có văn bản kết thúc bằng văn bản đã chỉ định.
`whenTextEqualTo(text)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có văn bản bằng văn bản đã chỉ định.
`whenTextEqualToAny(texts)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có văn bản bằng bất kỳ giá trị văn bản nào được chỉ định.
`whenTextNotEqualTo(text)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có văn bản không bằng văn bản đã chỉ định.
`whenTextNotEqualToAny(texts)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có văn bản không bằng bất kỳ giá trị nào được chỉ định.
`whenTextStartsWith(text)`	`FilterCriteriaBuilder`	Đặt tiêu chí lọc để hiển thị các ô có văn bản bắt đầu bằng văn bản đã chỉ định.
`withCriteria(criteria, args)`	`FilterCriteriaBuilder`	Đặt tiêu chí bộ lọc thành một điều kiện boolean do các giá trị `BooleanCriteria` xác định, chẳng hạn như `CELL_EMPTY` hoặc `NUMBER_GREATER_THAN`.

Tài liệu chi tiết

`build()`

Tập hợp các tiêu chí bộ lọc bằng cách sử dụng các chế độ cài đặt mà bạn thêm vào trình tạo tiêu chí.

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

Cầu thủ trả bóng

FilterCriteria – Biểu thị tiêu chí lọc.

`copy()`

Sao chép tiêu chí bộ lọc này và tạo một trình tạo tiêu chí mà bạn có thể áp dụng cho một bộ lọc khác.

Bạn có thể sử dụng phương thức này với bất kỳ loại bộ lọc nào. Nếu đang sử dụng bộ lọc trang tính, bạn có thể sao chép tiêu chí vào một cột khác.

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

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo tiêu chí bộ lọc dựa trên tiêu chí bộ lọc này.

`getCriteriaType()`

Trả về loại boolean của tiêu chí, ví dụ: CELL_EMPTY. Để tìm hiểu về các loại tiêu chí boolean, hãy xem enum BooleanCriteria.

Mọi người thường sử dụng phương thức này để thêm tiêu chí điều kiện boolean vào bộ lọc mà không thay thế tiêu chí hiện có.

Để lấy các đối số cho tiêu chí, hãy sử dụng getCriteriaValues().
Để sử dụng loại tiêu chí và giá trị tiêu chí nhằm tạo hoặc sửa đổi tiêu chí bộ lọc, hãy xem phần withCriteria(criteria, args).

Bạn có thể sử dụng phương thức này cho bất kỳ loại bộ lọc nào. Nếu tiêu chí lọc không phải là điều kiện boolean, hãy trả về 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);

Cầu thủ trả bóng

BooleanCriteria – Loại tiêu chí boolean hoặc null nếu tiêu chí không phải là điều kiện boolean.

`getCriteriaValues()`

Trả về một mảng đối số cho tiêu chí boolean. Một số loại tiêu chí boolean không có đối số và trả về một mảng trống, ví dụ: CELL_NOT_EMPTY.

Mọi người thường sử dụng phương thức này để thêm tiêu chí điều kiện boolean vào bộ lọc mà không thay thế tiêu chí hiện có.

Để lấy loại tiêu chí boolean, hãy sử dụng getCriteriaType().
Để sử dụng loại tiêu chí và giá trị tiêu chí nhằm tạo hoặc sửa đổi tiêu chí bộ lọc, hãy xem phần withCriteria(criteria, args).
Bạn có thể sử dụng phương thức này cho bất kỳ loại bộ lọc nào.
```
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);
```
Cầu thủ trả bóng

Object[] – Một mảng các đối số phù hợp với loại tiêu chí boolean. Số lượng đối số và loại đối số khớp với phương thức when...() tương ứng của lớp FilterCriteriaBuilder.

`getHiddenValues()`

Trả về các giá trị mà bộ lọc ẩn.

Sử dụng tiêu chí này với bộ lọc trên trang tính Grid, loại trang tính mặc định. Trả về null nếu bạn gọi phương thức này cho các loại bộ lọc khác.

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

Cầu thủ trả bóng

String[] – Một mảng các giá trị mà bộ lọc ẩn.

`getVisibleBackgroundColor()`

Trả về màu nền được dùng làm tiêu chí lọc. Các ô có màu nền này vẫn hiển thị.

Sử dụng tiêu chí này với bộ lọc trên trang tính Grid, loại trang tính mặc định. Trả về null nếu bạn gọi phương thức này cho các loại bộ lọc khác.

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

Cầu thủ trả bóng

Color – Màu nền được dùng làm tiêu chí lọc.

`getVisibleForegroundColor()`

Trả về màu nền trước được dùng làm tiêu chí lọc. Các ô có màu nền trước này vẫn hiển thị.

Sử dụng tiêu chí này với bộ lọc trên trang tính Grid, loại trang tính mặc định. Trả về null nếu bạn gọi phương thức này cho các loại bộ lọc khác.

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

Cầu thủ trả bóng

Color – Màu nền trước được dùng làm tiêu chí lọc.

`getVisibleValues()`

Trả về các giá trị mà bộ lọc bảng tổng hợp hiển thị.

Tiêu chí này chỉ dành cho bộ lọc trên các bảng tổng hợp không được kết nối với cơ sở dữ liệu. Trả về một mảng trống cho các loại bộ lọc khác.

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

Cầu thủ trả bóng

String[] – Một mảng các giá trị mà bộ lọc bảng tổng hợp hiển thị.

`setHiddenValues(values)`

Đặt các giá trị cần ẩn. Xoá mọi giá trị hiện có, hiển thị hoặc ẩn.

Bạn chỉ có thể sử dụng tiêu chí này cho bộ lọc trên các trang tính Grid, loại trang tính mặc định.

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

Tham số

Tên	Loại	Mô tả
`values`	`String[]`	Danh sách các giá trị cần ẩn.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

Gửi

Error – Nếu có bất kỳ giá trị nào là null.

`setVisibleBackgroundColor(visibleBackgroundColor)`

Đặt màu nền được dùng làm tiêu chí lọc. Các ô có màu nền này vẫn hiển thị. Việc đặt tiêu chí bộ lọc màu nền sẽ xoá mọi tiêu chí bộ lọc màu hiện tại khỏi trình tạo này.

Bạn chỉ có thể sử dụng tiêu chí này cho bộ lọc trên các trang tính Grid, loại trang tính mặc định.

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

Tham số

Tên	Loại	Mô tả
`visibleBackgroundColor`	`Color`	Màu nền cần đặt. Màu phải là màu theo kiểu RGB. Phương thức này không hỗ trợ màu giao diện.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`setVisibleForegroundColor(visibleForegroundColor)`

Đặt màu nền trước dùng làm tiêu chí lọc. Các ô có màu nền trước này vẫn hiển thị. Việc đặt tiêu chí bộ lọc màu nền trước sẽ xoá mọi tiêu chí bộ lọc màu hiện tại khỏi trình tạo này.

Bạn chỉ có thể sử dụng tiêu chí này cho bộ lọc trên các trang tính Grid, loại trang tính mặc định.

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

Tham số

Tên	Loại	Mô tả
`visibleForegroundColor`	`Color`	Màu nền trước cần đặt. Màu phải là màu theo kiểu RGB. Phương thức này không hỗ trợ màu giao diện.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`setVisibleValues(values)`

Đặt các giá trị sẽ hiển thị trên bảng tổng hợp. Xoá mọi giá trị hiện có, hiển thị hoặc ẩn.

Bạn chỉ có thể sử dụng tiêu chí này cho bộ lọc trên các bảng tổng hợp không được kết nối với cơ sở dữ liệu.

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

Tham số

Tên	Loại	Mô tả
`values`	`String[]`	Danh sách các giá trị cần hiển thị.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

Gửi

Error – Nếu có bất kỳ giá trị nào là null.

`whenCellEmpty()`

Đặt tiêu chí lọc để hiển thị các ô trống.

Bạn có thể sử dụng tiêu chí này với bất kỳ loại bộ lọc nào.

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

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenCellNotEmpty()`

Đặt tiêu chí lọc để hiển thị các ô không trống.

Bạn có thể sử dụng tiêu chí này với bất kỳ loại bộ lọc nào.

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

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenDateAfter(date)`

Đặt tiêu chí bộ lọc cho thấy các ô có ngày sau ngày được chỉ định.

Bạn có thể sử dụng tiêu chí này với bất kỳ loại bộ lọc nào. Nếu bạn sử dụng tiêu chí này với dữ liệu được kết nối với cơ sở dữ liệu, thì loại dữ liệu của cột mà bạn đang lọc theo phải là ngày. Nếu dữ liệu không được kết nối với cơ sở dữ liệu, thì kiểu dữ liệu của cột mà bạn đang lọc theo không cần phải là ngày. Tuy nhiên, nếu không phải là ngày, bạn có thể nhận được kết quả không mong muốn.

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

Tham số

Tên	Loại	Mô tả
`date`	`Date`	Ngày gần đây nhất cần ẩn.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenDateAfter(date)`

Đặt tiêu chí bộ lọc hiển thị các ô có ngày sau ngày tương đối đã chỉ định. Để xem các tuỳ chọn ngày tương đối, hãy tham khảo Enum RelativeDate.

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

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

Tham số

Tên	Loại	Mô tả
`date`	`RelativeDate`	Ngày tương đối mới nhất.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenDateBefore(date)`

Đặt tiêu chí lọc cho thấy các ô có ngày trước ngày được chỉ định.

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

Tham số

Tên	Loại	Mô tả
`date`	`Date`	Ngày sớm nhất để ẩn.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenDateBefore(date)`

Đặt tiêu chí lọc cho thấy các ô có ngày trước ngày tương đối đã chỉ định. Để xem các tuỳ chọn ngày tương đối, hãy tham khảo Enum RelativeDate.

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

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

Tham số

Tên	Loại	Mô tả
`date`	`RelativeDate`	Ngày tương đối sớm nhất cần ẩn.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenDateEqualTo(date)`

Đặt tiêu chí lọc cho thấy các ô có ngày bằng với ngày đã chỉ định.

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

Tham số

Tên	Loại	Mô tả
`date`	`Date`	Ngày mà giá trị ô phải khớp.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenDateEqualTo(date)`

Đặt tiêu chí bộ lọc cho thấy các ô có ngày bằng với ngày tương đối đã chỉ định. Để xem các tuỳ chọn ngày tương đối, hãy tham khảo Enum RelativeDate.

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

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

Tham số

Tên	Loại	Mô tả
`date`	`RelativeDate`	Ngày tương đối mà các giá trị ô phải khớp.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenDateEqualToAny(dates)`

Đặt tiêu chí bộ lọc để hiển thị các ô có ngày bằng với bất kỳ ngày nào được chỉ định.

Bạn chỉ có thể sử dụng tiêu chí này với dữ liệu được kết nối với cơ sở dữ liệu. Ví dụ: sử dụng tiêu chí này với bộ lọc trên trang tính DataSource, trang tính được kết nối với cơ sở dữ liệu hoặc DataSourcePivotTable, bảng tổng hợp được tạo từ trang tính 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);

Tham số

Tên	Loại	Mô tả
`dates`	`Date[]`	Ngày cần hiển thị.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenDateNotEqualTo(date)`

Đặt tiêu chí lọc để hiển thị các ô không bằng ngày đã chỉ định.

Loại dữ liệu của cột mà bạn đang lọc theo phải là ngày.

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

Tham số

Tên	Loại	Mô tả
`date`	`Date`	Ngày cần ẩn.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenDateNotEqualToAny(dates)`

Đặt tiêu chí bộ lọc để hiển thị các ô có ngày không bằng bất kỳ ngày nào được chỉ định.

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

Tham số

Tên	Loại	Mô tả
`dates`	`Date[]`	Ngày cần ẩn.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenFormulaSatisfied(formula)`

Đặt tiêu chí lọc để hiển thị các ô có công thức được chỉ định (chẳng hạn như =B:B<C:C) có giá trị là true.

Bạn chỉ có thể sử dụng tiêu chí này để lọc dữ liệu không được kết nối với cơ sở dữ liệu.

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

Tham số

Tên	Loại	Mô tả
`formula`	`String`	Một công thức tuỳ chỉnh đánh giá là `true` nếu dữ liệu đầu vào hợp lệ.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenNumberBetween(start, end)`

Đặt tiêu chí bộ lọc để hiển thị các ô có số nằm giữa hoặc là một trong 2 số được chỉ định.

Bạn có thể sử dụng tiêu chí này với bất kỳ loại bộ lọc nào. Nếu bạn sử dụng tiêu chí này với dữ liệu được kết nối với cơ sở dữ liệu, thì kiểu dữ liệu của cột mà bạn đang lọc theo phải là số. Nếu dữ liệu không được kết nối với cơ sở dữ liệu, thì kiểu dữ liệu của cột mà bạn đang lọc theo không cần phải là số, nhưng nếu không phải là số, bạn có thể nhận được kết quả không mong muốn.

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

Tham số

Tên	Loại	Mô tả
`start`	`Number`	Số thấp nhất cần hiển thị.
`end`	`Number`	Số cao nhất cần hiển thị.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenNumberEqualTo(number)`

Đặt tiêu chí lọc để hiển thị các ô có số bằng với số đã chỉ định.

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

Tham số

Tên	Loại	Mô tả
`number`	`Number`	Số cần hiển thị.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenNumberEqualToAny(numbers)`

Đặt tiêu chí lọc để hiển thị các ô có số bằng bất kỳ số nào đã chỉ định.

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

Tham số

Tên	Loại	Mô tả
`numbers`	`Number[]`	Số cần hiển thị.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenNumberGreaterThan(number)`

Đặt tiêu chí lọc để hiển thị các ô có số lớn hơn số đã chỉ định

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

Tham số

Tên	Loại	Mô tả
`number`	`Number`	Số cao nhất cần ẩn.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenNumberGreaterThanOrEqualTo(number)`

Đặt tiêu chí lọc để hiển thị các ô có số lớn hơn hoặc bằng số được chỉ định.

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

Tham số

Tên	Loại	Mô tả
`number`	`Number`	Số thấp nhất cần hiển thị.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenNumberLessThan(number)`

Đặt tiêu chí lọc để hiển thị các ô có số nhỏ hơn số đã chỉ định.

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

Tham số

Tên	Loại	Mô tả
`number`	`Number`	Số thấp nhất cần ẩn.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenNumberLessThanOrEqualTo(number)`

Đặt tiêu chí lọc để hiển thị các ô có số nhỏ hơn hoặc bằng số đã chỉ định.

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

Tham số

Tên	Loại	Mô tả
`number`	`Number`	Số cao nhất cần hiển thị.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenNumberNotBetween(start, end)`

Đặt tiêu chí lọc để hiển thị các ô có số không nằm giữa và không phải là một trong 2 số đã chỉ định.

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

Tham số

Tên	Loại	Mô tả
`start`	`Number`	Số thấp nhất sẽ bị ẩn.
`end`	`Number`	Số cao nhất cần ẩn.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenNumberNotEqualTo(number)`

Đặt tiêu chí lọc để hiển thị các ô có số không bằng số đã chỉ định.

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

Tham số

Tên	Loại	Mô tả
`number`	`Number`	Số cần ẩn.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenNumberNotEqualToAny(numbers)`

Đặt tiêu chí lọc để hiển thị các ô có số không bằng bất kỳ số nào đã chỉ định.

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

Tham số

Tên	Loại	Mô tả
`numbers`	`Number[]`	Số cần ẩn.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenTextContains(text)`

Đặt tiêu chí lọc để hiển thị các ô có văn bản chứa văn bản đã chỉ định. Văn bản không phân biệt chữ hoa chữ thường.

Bạn có thể sử dụng tiêu chí này với bất kỳ loại bộ lọc nào.

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

Tham số

Tên	Loại	Mô tả
`text`	`String`	Văn bản mà ô phải chứa.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenTextDoesNotContain(text)`

Đặt tiêu chí lọc để hiển thị các ô có văn bản không chứa văn bản đã chỉ định. Văn bản không phân biệt chữ hoa chữ thường.

Bạn có thể sử dụng tiêu chí này với bất kỳ loại bộ lọc nào.

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

Tham số

Tên	Loại	Mô tả
`text`	`String`	Văn bản mà ô không được chứa.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenTextEndsWith(text)`

Đặt tiêu chí lọc để hiển thị các ô có văn bản kết thúc bằng văn bản đã chỉ định. Văn bản không phân biệt chữ hoa chữ thường.

Bạn có thể sử dụng tiêu chí này với bất kỳ loại bộ lọc nào.

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

Tham số

Tên	Loại	Mô tả
`text`	`String`	Văn bản mà phần cuối của văn bản trong ô phải chứa.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenTextEqualTo(text)`

Đặt tiêu chí lọc để hiển thị các ô có văn bản bằng văn bản đã chỉ định. Văn bản không phân biệt chữ hoa chữ thường.

Bạn có thể sử dụng tiêu chí này với bất kỳ loại bộ lọc nào.

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

Tham số

Tên	Loại	Mô tả
`text`	`String`	Văn bản mà văn bản của ô phải bằng.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenTextEqualToAny(texts)`

Đặt tiêu chí lọc để hiển thị các ô có văn bản bằng bất kỳ giá trị văn bản nào được chỉ định. Văn bản không phân biệt chữ hoa chữ thường.

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

Tham số

Tên	Loại	Mô tả
`texts`	`String[]`	Giá trị văn bản mà một ô phải bằng.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenTextNotEqualTo(text)`

Đặt tiêu chí lọc để hiển thị các ô có văn bản không bằng văn bản đã chỉ định. Văn bản không phân biệt chữ hoa chữ thường.

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

Tham số

Tên	Loại	Mô tả
`text`	`String`	Văn bản mà văn bản của ô không được bằng.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenTextNotEqualToAny(texts)`

Đặt tiêu chí lọc để hiển thị các ô có văn bản không bằng bất kỳ giá trị nào được chỉ định. Văn bản không phân biệt chữ hoa chữ thường.

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

Tham số

Tên	Loại	Mô tả
`texts`	`String[]`	Giá trị văn bản mà ô không được bằng.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`whenTextStartsWith(text)`

Đặt tiêu chí lọc để hiển thị các ô có văn bản bắt đầu bằng văn bản đã chỉ định. Văn bản không phân biệt chữ hoa chữ thường.

Bạn có thể sử dụng tiêu chí này với bất kỳ loại bộ lọc nào.

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

Tham số

Tên	Loại	Mô tả
`text`	`String`	Văn bản mà phần đầu văn bản của ô phải chứa.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.

`withCriteria(criteria, args)`

Đặt tiêu chí bộ lọc thành một điều kiện boolean do các giá trị BooleanCriteria xác định, chẳng hạn như CELL_EMPTY hoặc NUMBER_GREATER_THAN. Để sao chép điều kiện boolean từ tiêu chí hiện có, hãy xác định các tham số cho phương thức này bằng cách sử dụng getCriteriaType() và getCriteriaValues() trên tiêu chí hiện có.

Bạn có thể sử dụng tiêu chí này với bất kỳ loại bộ lọc nào, nhưng một số BooleanCriteria không áp dụng cho tất cả bộ lọc.

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

Tham số

Tên	Loại	Mô tả
`criteria`	`BooleanCriteria`	Loại tiêu chí boolean.
`args`	`Object[]`	Một mảng đối số phù hợp với loại tiêu chí; số lượng đối số và loại đối số khớp với các phương thức `when...()` tương ứng ở trên.

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo này, để tạo chuỗi.