Class FilterCriteriaBuilder

FilterCriteriaBuilder

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

1. Tạo trình tạo tiêu chí bằng SpreadsheetApp.newFilterCriteria().
2. Thêm chế độ cài đặt cho trình tạo bằng các phương thức từ lớp này.
3. Sử dụng build() để tập hợp tiêu chí với chế độ cài đặt mà 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í giúp ẩn các ô trong cột C có chứa từ "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).

let ss = SpreadsheetApp.getActiveSheet();
let filter = ss.getFilter();
let 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 bộ lọc vào một trang tính DataSource, một trang tính được kết nối với một 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.
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);

Phương thức

Phương thức	Kiểu dữ liệu trả về	Mô tả ngắn
build()	FilterCriteria	Tập hợp tiêu chí lọc bằng cách sử dụng các chế độ cài đặt bạn thêm vào trình tạo tiêu chí.
copy()	FilterCriteriaBuilder	Sao chép tiêu chí lọc này và tạo một trình tạo tiêu chí để 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 các đố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 cho thấy.
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 đượ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í lọc để cho thấy các ô có ngày sau ngày đã chỉ định.
whenDateAfter(date)	FilterCriteriaBuilder	Đặt tiêu chí lọc để cho thấy các ô có ngày sau ngày tương đối đã chỉ định.
whenDateBefore(date)	FilterCriteriaBuilder	Đặt tiêu chí lọc để hiển thị các ô có ngày trước ngày đã chỉ định.
whenDateBefore(date)	FilterCriteriaBuilder	Đặt tiêu chí lọc để hiển thị các ô có ngày trước ngày tương đối đã chỉ định.
whenDateEqualTo(date)	FilterCriteriaBuilder	Đặt tiêu chí lọc để hiển thị các ô có ngày bằng với ngày đã chỉ định.
whenDateEqualTo(date)	FilterCriteriaBuilder	Đặt tiêu chí lọc để hiển thị các ô có ngày bằng với ngày tương đối đã chỉ định.
whenDateEqualToAny(dates)	FilterCriteriaBuilder	Đặt tiêu chí lọc để hiện các ô có ngày bằng với bất kỳ ngày nào đã 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í lọc để hiển thị các ô có ngày không bằng với 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 chỉ định (chẳng hạn như =B:B<C:C) có đánh giá là true.
whenNumberBetween(start, end)	FilterCriteriaBuilder	Đặt tiêu chí lọc để hiển thị các ô có số nằm trong khoảng 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 với bất kỳ số nào được 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ố đã 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ố được chỉ định.
whenNumberNotBetween(start, end)	FilterCriteriaBuilder	Đặt tiêu chí lọc để hiển thị các ô có số không nằm trong khoảng và không thuộc 2 số được 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 với bất kỳ số nào được chỉ định.
whenTextContains(text)	FilterCriteriaBuilder	Đặt tiêu chí lọc để hiển thị các ô có 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 được chỉ định.
whenTextEqualTo(text)	FilterCriteriaBuilder	Đặt tiêu chí lọc để hiển thị các ô có văn bản bằng với văn bản được chỉ định.
whenTextEqualToAny(texts)	FilterCriteriaBuilder	Đặt tiêu chí lọc để hiển thị các ô có văn bản bằng với bất kỳ giá trị văn bản được chỉ định nào.
whenTextNotEqualTo(text)	FilterCriteriaBuilder	Đặt tiêu chí lọc để hiển thị các ô có văn bản không bằng với văn bản được 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 với bất kỳ giá trị đã chỉ định nào.
whenTextStartsWith(text)	FilterCriteriaBuilder	Đặt tiêu chí lọc để hiển thị các ô chứa văn bản bắt đầu bằng văn bản đã chỉ định.
withCriteria(criteria, args)	FilterCriteriaBuilder	Đặt tiêu chí lọc thành điều kiện boolean được xác định bởi các giá trị BooleanCriteria, chẳng hạn như CELL_EMPTY hoặc NUMBER_GREATER_THAN.

Tài liệu chi tiết

build()

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

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

Cầu thủ trả bóng

FilterCriteria – Trình bày tiêu chí lọc.

---

copy()

Sao chép tiêu chí lọc này và tạo một trình tạo tiêu chí để 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 dùng bộ lọc trang tính, bạn có thể sao chép tiêu chí sang một cột khác.

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

Cầu thủ trả bóng

FilterCriteriaBuilder – Trình tạo tiêu chí lọc dựa trên tiêu chí 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ế các tiêu chí hiện có.

• Để lấy đối số cho tiêu chí, hãy sử dụng getCriteriaValues().
• Để 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í lọc, hãy xem withCriteria(criteria, args).

Bạn có thể sử dụng phương pháp 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à một điều kiện boolean, hãy trả về 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);

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 các đố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, chẳng hạn như 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ế các tiêu chí hiện có.

• Để nhận loại tiêu chí boolean, hãy sử dụng getCriteriaType().
• Để 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í lọc, hãy xem withCriteria(criteria, args).

  Bạn có thể sử dụng phương pháp này cho bất kỳ loại bộ lọc nào.

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

  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 của các đối số này 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 các 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.

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

Cầu thủ trả bóng

String[] – Mảng các giá trị mà bộ lọc sẽ ẩ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 các 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.

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

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 các 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.

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

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 cho thấy.

Tiêu chí này chỉ áp dụng cho các bộ lọc trên bảng tổng hợp không 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.

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

Cầu thủ trả bóng

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

---

setHiddenValues(values)

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

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

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

Các tham số

Tên	Loại	Nội dung 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.

---

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í lọc màu nền sẽ xoá mọi tiêu chí 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 các bộ lọc trên trang tính Grid, loại trang tính mặc định.

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

Các tham số

Tên	Loại	Nội dung mô tả
visibleBackgroundColor	Color	Màu nền cần đặt. Màu phải là màu 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 đượ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í lọc màu nền trước sẽ xoá mọi tiêu chí 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 các bộ lọc trên trang tính Grid, loại trang tính mặc định.

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

Các tham số

Tên	Loại	Nội dung mô tả
visibleForegroundColor	Color	Màu nền trước cần đặt. Màu phải là màu 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ị cần hiển thị trên bảng tổng hợp. Xóa mọi giá trị hiển thị hoặc giá trị bị ẩn hiện có.

Bạn chỉ có thể sử dụng tiêu chí này cho các bộ lọc trên bảng tổng hợp không được kết nối với một 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."
let pivotTable = ss.getPivotTables()[0];
let criteria = SpreadsheetApp.newFilterCriteria()
                             .setVisibleValues(["Northeast", "Southwest"])
                             .build();
pivotTable.addFilter(2, criteria);

Các tham số

Tên	Loại	Nội dung mô tả
values	String[]	Danh sách giá trị để hiển thị.

Cầu thủ trả bóng

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

---

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

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

Cầu thủ trả bóng

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

---

whenDateAfter(date)

Đặt tiêu chí lọc để cho thấy các ô có ngày sau ngày đã 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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc 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 đang lọc không nhất thiết phải là ngày, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
date	Date	Ngày ẩn gần nhất.

Cầu thủ trả bóng

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

---

whenDateAfter(date)

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

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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc 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 đang lọc không nhất thiết phải là ngày, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung 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 để hiển thị các ô có ngày trước ngày đã 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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc 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 đang lọc không nhất thiết phải là ngày, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
date	Date	Ngày ẩn sớm 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 để hiển thị các ô có ngày trước ngày tương đối đã chỉ định. Để xem các lựa chọn về ngày tương đối, hãy tham khảo Enum RelativeDate.

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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc 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 đang lọc không nhất thiết phải là ngày, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
date	RelativeDate	Ngày tương đối sớm nhất để ẩ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 để hiển thị các ô có ngày bằng với ngày đã 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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc 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 đang lọc không nhất thiết phải là ngày, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
date	Date	Ngày phải khớp với các giá trị trong ô.

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 để hiển thị các ô có ngày bằng với ngày tương đối đã chỉ định. Để xem các lựa chọn về ngày tương đối, hãy tham khảo Enum RelativeDate.

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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc 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 đang lọc không nhất thiết phải là ngày, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
date	RelativeDate	Ngày tháng tương đối mà các giá trị trong ô 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í lọc để hiện các ô có ngày bằng với bất kỳ ngày nào đã 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 các 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.
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);

Các tham số

Tên	Loại	Nội dung mô tả
dates	Date[]	Ngày 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.

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 các 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.

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

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

Các tham số

Tên	Loại	Nội dung mô tả
date	Date	Ngày ẩn.

Cầu thủ trả bóng

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

---

whenDateNotEqualToAny(dates)

Đặt tiêu chí lọc để hiển thị các ô có ngày không 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 các 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.
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);

Các tham số

Tên	Loại	Nội dung mô tả
dates	Date[]	Ngày ẩ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 chỉ định (chẳng hạn như =B:B<C:C) có đánh giá 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
formula	String	Một công thức tuỳ chỉnh đánh giá là true nếu giá trị nhập vào là 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í lọc để hiển thị các ô có số nằm trong khoảng 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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc phải là một số. Nếu dữ liệu không được kết nối với cơ sở dữ liệu, loại dữ liệu của cột bạn đang lọc không nhất thiết phải là số, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
start	Number	Số thấp nhất để hiển thị.
end	Number	Số cao nhất để 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.

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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc phải là một số. Nếu dữ liệu không được kết nối với cơ sở dữ liệu, loại dữ liệu của cột bạn đang lọc không nhất thiết phải là số, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
number	Number	Số để 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 với bất kỳ số 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 các 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.
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);

Các tham số

Tên	Loại	Nội dung mô tả
numbers	Number[]	Các con số sẽ 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

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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc phải là một số. Nếu dữ liệu không được kết nối với cơ sở dữ liệu, loại dữ liệu của cột bạn đang lọc không nhất thiết phải là số, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung 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ố đã 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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc phải là một số. Nếu dữ liệu không được kết nối với cơ sở dữ liệu, loại dữ liệu của cột bạn đang lọc không nhất thiết phải là số, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
number	Number	Số thấp nhất để 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.

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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc phải là một số. Nếu dữ liệu không được kết nối với cơ sở dữ liệu, loại dữ liệu của cột bạn đang lọc không nhất thiết phải là số, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung 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ố đượ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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc phải là một số. Nếu dữ liệu không được kết nối với cơ sở dữ liệu, loại dữ liệu của cột bạn đang lọc không nhất thiết phải là số, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
number	Number	Số cao nhất để 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 trong khoảng và không thuộc 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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc phải là một số. Nếu dữ liệu không được kết nối với cơ sở dữ liệu, loại dữ liệu của cột bạn đang lọc không nhất thiết phải là số, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
start	Number	Số thấp nhất sẽ ẩ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.

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 một cơ sở dữ liệu, thì kiểu dữ liệu của cột bạn đang lọc phải là một số. Nếu dữ liệu không được kết nối với cơ sở dữ liệu, loại dữ liệu của cột bạn đang lọc không nhất thiết phải là số, nhưng nếu không, 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
number	Number	Số muố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 với bất kỳ số 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 các 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.
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);

Các tham số

Tên	Loại	Nội dung mô tả
numbers	Number[]	Các 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ó 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();
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);

Các tham số

Tên	Loại	Nội dung 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();
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);

Các tham số

Tên	Loại	Nội dung 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 được 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
text	String	Văn bản ở cuối văn bản của ô phải có.

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ới văn bản được 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();
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);

Các tham số

Tên	Loại	Nội dung 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 với bất kỳ giá trị văn bản được chỉ định nào. Văn bản không phân biệt chữ hoa chữ thường.

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 các 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.
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);

Các tham số

Tên	Loại	Nội dung mô tả
texts	String[]	Các 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ới văn bản được chỉ định. Văn bản không phân biệt chữ hoa chữ thường.

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 các 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.
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);

Các tham số

Tên	Loại	Nội dung 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 với bất kỳ giá trị đã chỉ định nào. Văn bản không phân biệt chữ hoa chữ thường.

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 các 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.
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);

Các tham số

Tên	Loại	Nội dung mô tả
texts	String[]	Các giá trị văn bản mà một ô không thể lấy 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 ô chứa 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
text	String	Văn bản ở phần đầu của ô phải có.

Cầu thủ trả bóng

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

---

withCriteria(criteria, args)

Đặt tiêu chí lọc thành điều kiện boolean được xác định bởi các giá trị BooleanCriteria, chẳng hạn như CELL_EMPTY hoặc NUMBER_GREATER_THAN. Để sao chép điều kiện boolean từ các 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 một tiêu chí hiện có.

Bạn có thể 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 mọi 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();
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);

Các tham số

Tên	Loại	Nội dung mô tả
criteria	BooleanCriteria	Loại tiêu chí boolean.
args	Object[]	Một mảng các đối số phù hợp với loại tiêu chí; số lượng đối số và loại của các đố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.