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 vào trình tạo bằng các phương thức trong lớp này.
  3. Sử dụng build() để tập hợp tiêu chí với các 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 sử dụng 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 từ "hello" hoặc "thế giới". Các tiêu chí trong mẫu này chỉ có thể được sử dụng với trên Grid trang tính, 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 các ô không trống

Mẫu sau đây thêm một bộ lọc vào trang tính DataSource, đượ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 "Danh mục" cột 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ứcLoại dữ liệu trả vềMô tả ngắn
build()FilterCriteriaTập hợp tiêu chí bộ lọc bằng cách sử dụng chế độ cài đặt bạn thêm vào trình tạo tiêu chí.
copy()FilterCriteriaBuilderSao chép tiêu chí bộ lọc này và tạo một trình tạo tiêu chí để bạn có thể áp dụng cho tiêu chí khác .
getCriteriaType()BooleanCriteriaTrả về kiểu 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 đi.
getVisibleBackgroundColor()ColorTrả về màu nền được dùng làm tiêu chí lọc.
getVisibleForegroundColor()ColorTrả 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)FilterCriteriaBuilderThiết lập các giá trị cần hiển thị trên bảng tổng hợp.
whenCellEmpty()FilterCriteriaBuilderThiết lập tiêu chí bộ lọc để hiển thị các ô trống.
whenCellNotEmpty()FilterCriteriaBuilderThiết lập tiêu chí bộ lọc để hiển thị các ô không trống.
whenDateAfter(date)FilterCriteriaBuilderĐặt tiêu chí bộ lọc hiển thị những ô có ngày sau ngày đã chỉ định.
whenDateAfter(date)FilterCriteriaBuilderThiết lập tiêu chí bộ lọc hiển thị những ô có ngày sau ngày tương đối đã chỉ định.
whenDateBefore(date)FilterCriteriaBuilderĐặt tiêu chí bộ lọc hiển thị những ô có ngày trước ngày được chỉ định.
whenDateBefore(date)FilterCriteriaBuilderThiết lập tiêu chí bộ lọc hiển thị những ô có ngày trước ngày tương đối đã chỉ định.
whenDateEqualTo(date)FilterCriteriaBuilderĐặt tiêu chí bộ lọc hiển thị các ô có ngày bằng ngày đã chỉ định.
whenDateEqualTo(date)FilterCriteriaBuilderĐặt tiêu chí bộ lọc hiển thị các ô có ngày bằng với ngày tương đối đã chỉ định.
whenDateEqualToAny(dates)FilterCriteriaBuilderThiết lập tiêu chí lọc để hiển thị những ô có ngày bằng bất kỳ ngày nào được chỉ định.
whenDateNotEqualTo(date)FilterCriteriaBuilderThiết lập tiêu chí bộ lọc để hiển thị các ô không bằng ngày được chỉ định.
whenDateNotEqualToAny(dates)FilterCriteriaBuilderThiết lập tiêu chí bộ lọc để hiển thị những ô có ngày không bằng bất kỳ giá trị nào được chỉ định ngày tháng.
whenFormulaSatisfied(formula)FilterCriteriaBuilderĐặt tiêu chí bộ lọc để hiển thị các ô có công thức được chỉ định (chẳng hạn như =B:B<C:C) mà có giá trị true.
whenNumberBetween(start, end)FilterCriteriaBuilderĐặt tiêu chí bộ lọc để hiển thị các ô có một số nằm trong khoảng hoặc nằm trong số 2 các số cụ thể.
whenNumberEqualTo(number)FilterCriteriaBuilderThiết lập tiêu chí lọc để hiển thị các ô có một 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ỳ giá trị nào được chỉ định số.
whenNumberGreaterThan(number)FilterCriteriaBuilderĐặt tiêu chí bộ lọc để hiển thị các ô có số lớn hơn số đã chỉ định
whenNumberGreaterThanOrEqualTo(number)FilterCriteriaBuilderĐặt tiêu chí bộ lọc để hiển thị các ô có số lớn hơn hoặc bằng số đã chỉ định số.
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í bộ lọc để hiển thị các ô có số nhỏ hơn hoặc bằng số đã chỉ định số.
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 nằm trong số 2 các số cụ thể.
whenNumberNotEqualTo(number)FilterCriteriaBuilderĐặt tiêu chí lọc để hiển thị các ô có một số không bằng số đã chỉ định.
whenNumberNotEqualToAny(numbers)FilterCriteriaBuilderĐặt tiêu chí bộ lọc để hiển thị các ô có số không bằng bất kỳ số nào được chỉ định số.
whenTextContains(text)FilterCriteriaBuilderThiết lập tiêu chí bộ lọc để hiển thị các ô có văn bản chứa văn bản được chỉ định.
whenTextDoesNotContain(text)FilterCriteriaBuilderThiết lập tiêu chí bộ lọc để hiển thị các ô có văn bản không chứa văn bản được chỉ định.
whenTextEndsWith(text)FilterCriteriaBuilderThiết lập 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)FilterCriteriaBuilderThiết lập 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í bộ lọc để hiển thị các ô có văn bản bằng với bất kỳ văn bản nào được chỉ định giá trị.
whenTextNotEqualTo(text)FilterCriteriaBuilderThiết lập tiêu chí bộ 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í bộ 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 giá trị.
whenTextStartsWith(text)FilterCriteriaBuilderThiết lập tiêu chí lọc để hiển thị các ô có văn bản bắt đầu bằng văn bản được chỉ định.
withCriteria(criteria, args)FilterCriteriaBuilderĐặt tiêu chí bộ lọc thành một điều kiện boolean được xác định bằng các giá trị BooleanCriteria, chẳng hạn như dưới dạng CELL_EMPTY hoặc NUMBER_GREATER_THAN.

Tài liệu chi tiết

build()

Tập hợp tiêu chí bộ lọc bằng cách sử dụng 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 — Biểu thị các 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í để bạn có thể áp dụng cho tiêu chí khác .

Bạn có thể sử dụng phương pháp 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. 

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 — Một 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ề kiểu boolean của tiêu chí, ví dụ: CELL_EMPTY. Để tìm hiểu về các loại về 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 cần thay thế tiêu chí hiện tại.

  • Để nhận đối số cho các tiêu chí, hãy sử dụng getCriteriaValues().
  • Để sử dụng các giá trị tiêu chí và loại tiêu chí nhằm tạo hoặc sửa đổi tiêu chí bộ 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í bộ lọc không phải là một giá trị boolean điều kiện, 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à một giá trị 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 cần thay thế tiêu chí hiện tại.

  • Để lấy loại tiêu chí boolean, hãy sử dụng getCriteriaType().
  • Để sử dụng các giá trị tiêu chí và loại tiêu chí nhằm tạo hoặc sửa đổi tiêu chí bộ 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à kiểu của chúng 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 đi.

Sử dụng tiêu chí này bằng các bộ lọc trên Grid trang tính (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ột mảng các giá trị mà bộ lọc ẩn đi.

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 còn hiển thị.

Sử dụng tiêu chí này bằng các bộ lọc trên Grid trang tính (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 được giữ nguyên hiển thị.

Sử dụng tiêu chí này bằng các bộ lọc trên Grid trang tính (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 hiển thị.

Tiêu chí này chỉ dành cho các bộ lọc trên 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. 

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ột mảng giá trị mà bộ lọc của 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ó hoặc bị ẩn.

Bạn chỉ có thể sử dụng tiêu chí này cho bộ lọc trên Grid trang tính, chế độ mặc định trang tí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);

Tham số

TênLoạiMô tả
valuesString[]Danh sách các giá trị muốn ẩn.

Cầu thủ trả bóng

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

Gửi

Error – Nếu 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 còn hiển thị. Việc đặt tiêu chí lọc màu nền sẽ xóa mọi tiêu chí lọc màu hiện tại từ 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 Grid trang tính, chế độ mặc định trang tí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);

Tham số

TênLoạiMô tả
visibleBackgroundColorColorMàu nền cần đặt. Màu phải là 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 được giữ nguyê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 từ 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 Grid trang tính, chế độ mặc định trang tí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);

Tham số

TênLoạiMô tả
visibleForegroundColorColorMàu nền trước cần đặt. Màu phải là 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)

Thiết lập các giá trị cần hiển thị trên bảng tổng hợp. Xoá mọi giá trị hiện có hoặc bị ẩn.

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

Tham số

TênLoạiMô tả
valuesString[]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 bất kỳ giá trị nào là null.

whenCellEmpty()

Thiết lập tiêu chí bộ 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()

Thiết lập tiêu chí bộ 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í bộ lọc hiển thị những ô 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 kết nối với một cơ sở dữ liệu, thì loại dữ liệu của cột bạn đang lọc phải là ngày. Nếu và không được kết nối với một cơ sở dữ liệu, loại dữ liệu của cột bạn đang lọc theo không cần phải là ngày, nhưng 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();
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);

Tham số

TênLoạiMô tả
dateDateNgày gần đây nhất để ẩn.

Cầu thủ trả bóng

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

whenDateAfter(date)

Thiết lập tiêu chí bộ lọc hiển thị những ô có ngày sau ngày tương đối đã chỉ định. Người nhận 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 kết nối với một cơ sở dữ liệu, thì loại dữ liệu của cột bạn đang lọc phải là ngày. Nếu và không được kết nối với một cơ sở dữ liệu, loại dữ liệu của cột bạn đang lọc theo không cần phải là ngày, nhưng 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();
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);

Tham số

TênLoạiMô tả
dateRelativeDateNgày tương đối gần đây 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í bộ lọc hiển thị những ô có ngày trước 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 kết nối với một cơ sở dữ liệu, thì loại dữ liệu của cột bạn đang lọc phải là ngày. Nếu và không được kết nối với một cơ sở dữ liệu, loại dữ liệu của cột bạn đang lọc theo không cần phải là ngày, nhưng 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();
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);

Tham số

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

Tham số

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

Tham số

TênLoạiMô tả
dateDateNgày mà giá trị của ô 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 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 kết nối với một cơ sở dữ liệu, thì loại dữ liệu của cột bạn đang lọc phải là ngày. Nếu và không được kết nối với một cơ sở dữ liệu, loại dữ liệu của cột bạn đang lọc theo không cần phải là ngày, nhưng 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();
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);

Tham số

TênLoạiMô tả
dateRelativeDateNgày tương đối mà các giá trị của ô phải khớp.

Cầu thủ trả bóng

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

whenDateEqualToAny(dates)

Thiết lập tiêu chí lọc để hiển thị những ô có ngày bằng 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í có bộ lọc trên trang tính DataSource (trang tính được kết nối với một cơ sở dữ liệu hoặc DataSourcePivotTable, một 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);

Tham số

TênLoạiMô tả
datesDate[]Ngày hiển thị.

Cầu thủ trả bóng

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

whenDateNotEqualTo(date)

Thiết lập tiêu chí bộ lọc để hiển thị các ô không bằng ngày đượ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í có bộ lọc trên trang tính DataSource (trang tính được kết nối với một cơ sở dữ liệu hoặc DataSourcePivotTable, một bảng tổng hợp được tạo từ trang tính DataSource.

Loại dữ liệu của cột 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);

Tham số

TênLoạiMô tả
dateDateNgày ẩn.

Cầu thủ trả bóng

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

whenDateNotEqualToAny(dates)

Thiết lập tiêu chí bộ lọc để hiển thị những ô có ngày không bằng bất kỳ giá trị nào được chỉ định ngày 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í có bộ lọc trên trang tính DataSource (trang tính được kết nối với một cơ sở dữ liệu hoặc DataSourcePivotTable, một 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);

Tham số

TênLoạiMô tả
datesDate[]Ngày muố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) mà cho kết quả 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);

Tham số

TênLoạiMô tả
formulaStringMột công thức tuỳ chỉnh được đá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ó một số nằm trong khoảng hoặc nằm trong số 2 các số cụ thể.

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ì loại 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 theo không cần phải là một 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();
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);

Tham số

TênLoạiMô tả
startNumberSố nhỏ nhất để hiển thị.
endNumberSố 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)

Thiết lập tiêu chí lọc để hiển thị các ô có một 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ì loại 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 theo không cần phải là một 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();
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);

Tham số

TênLoạiMô tả
numberNumberSố 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 với bất kỳ giá trị nào được chỉ định số.

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í có bộ lọc trên trang tính DataSource (trang tính được kết nối với một cơ sở dữ liệu hoặc DataSourcePivotTable, một 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);

Tham số

TênLoạiMô tả
numbersNumber[]Các 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í bộ 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ì loại 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 theo không cần phải là một 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();
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);

Tham số

TênLoạiMô tả
numberNumberSố 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í bộ lọc để hiển thị các ô có số lớn hơn hoặc bằng số đã chỉ định số.

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ì loại 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 theo không cần phải là một 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();
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);

Tham số

TênLoạiMô tả
numberNumberSố nhỏ 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ì loại 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 theo không cần phải là một 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();
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);

Tham số

TênLoạiMô tả
numberNumberSố thấp nhất để ẩn.

Cầu thủ trả bóng

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

whenNumberLessThanOrEqualTo(number)

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

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ì loại 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 theo không cần phải là một 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();
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);

Tham số

TênLoạiMô tả
numberNumberSố 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 nằm trong số 2 các số cụ thể.

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ì loại 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 theo không cần phải là một 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();
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);

Tham số

TênLoạiMô tả
startNumberẨn số thấp nhất.
endNumberSố 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ó một 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ì loại 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 theo không cần phải là một 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();
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);

Tham số

TênLoạiMô tả
numberNumberSố 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í bộ lọc để hiển thị các ô có số không bằng bất kỳ số nào được chỉ định số.

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í có bộ lọc trên trang tính DataSource (trang tính được kết nối với một cơ sở dữ liệu hoặc DataSourcePivotTable, một 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);

Tham số

TênLoạiMô tả
numbersNumber[]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)

Thiết lập tiêu chí bộ lọc để hiển thị các ô có văn bản chứa 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 that contain "Northwest" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextContains("Northwest")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Tham số

TênLoạiMô tả
textStringVăn bản mà ô phải có.

Cầu thủ trả bóng

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

whenTextDoesNotContain(text)

Thiết lập tiêu chí bộ lọc để hiển thị các ô có văn bản không chứa văn bản được chỉ định. Chiến lược phát hành đĩa đơn 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);

Tham số

TênLoạiMô tả
textStringVă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)

Thiết lập 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);

Tham số

TênLoạiMô tả
textStringVăn bản mà phầ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)

Thiết lập 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);

Tham số

TênLoạiMô tả
textStringVă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í bộ lọc để hiển thị các ô có văn bản bằng với bất kỳ văn bản nào được chỉ định giá trị. Văn bản này 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í có bộ lọc trên trang tính DataSource (trang tính được kết nối với một cơ sở dữ liệu hoặc DataSourcePivotTable, một 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);

Tham số

TênLoạiMô tả
textsString[]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)

Thiết lập tiêu chí bộ lọc để hiển thị các ô có văn bản không bằng văn bản được chỉ định. Chiến lược phát hành đĩa đơn 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í có bộ lọc trên trang tính DataSource (trang tính được kết nối với một cơ sở dữ liệu hoặc DataSourcePivotTable, một 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);

Tham số

TênLoạiMô tả
textStringVăn bản mà văn bản của ô không thể 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í bộ 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 giá trị. Văn bản này 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í có bộ lọc trên trang tính DataSource (trang tính được kết nối với một cơ sở dữ liệu hoặc DataSourcePivotTable, một 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);

Tham số

TênLoạiMô tả
textsString[]Các giá trị văn bản mà một ô không thể bằng.

Cầu thủ trả bóng

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

whenTextStartsWith(text)

Thiết lập tiêu chí lọc để hiển thị các ô có văn bản bắt đầu 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 starts with "pre" and sets it to column B.
let criteria = SpreadsheetApp.newFilterCriteria()
                             .whenTextStartsWith("pre")
                             .build();
filter.setColumnFilterCriteria(2, criteria);

Tham số

TênLoạiMô tả
textStringVăn bản mà phần đầu 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.

withCriteria(criteria, args)

Đặt tiêu chí bộ lọc thành một điều kiện boolean được xác định bằng các giá trị BooleanCriteria, chẳng hạn như dưới dạng 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 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 tại.

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 thì không áp dụng cho tất cả cá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();
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);

Tham số

TênLoạiMô tả
criteriaBooleanCriteriaLoại tiêu chí boolean.
argsObject[]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 chúng 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.