Để thêm tiêu chí vào bộ lọc, bạn phải làm như sau:
- Tạo trình tạo tiêu chí bằng
SpreadsheetApp.newFilterCriteria()
. - Thêm chế độ cài đặt vào trình tạo bằng các phương thức trong lớp này.
- Sử dụng
build()
để tập hợp 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ênGrid
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ínhDataSource
,
đượ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ức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
build() | FilterCriteria | 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í. |
copy() | FilterCriteriaBuilder | Sao chép tiêu chí bộ lọc này và tạo một trình tạo tiêu chí để bạn có thể áp dụng cho tiêu chí khác . |
getCriteriaType() | BooleanCriteria | Trả 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() | Color | Trả về màu nền được dùng làm tiêu chí lọc. |
getVisibleForegroundColor() | Color | Trả về màu nền trước được dùng làm tiêu chí lọc. |
getVisibleValues() | String[] | Trả về các giá trị mà bộ lọc bảng tổng hợp hiển thị. |
setHiddenValues(values) | FilterCriteriaBuilder | Đặt các giá trị cần ẩn. |
setVisibleBackgroundColor(visibleBackgroundColor) | FilterCriteriaBuilder | Đặt màu nền được dùng làm tiêu chí lọc. |
setVisibleForegroundColor(visibleForegroundColor) | FilterCriteriaBuilder | Đặt màu nền trước dùng làm tiêu chí lọc. |
setVisibleValues(values) | FilterCriteriaBuilder | Thiết lập các giá trị cần hiển thị trên bảng tổng hợp. |
whenCellEmpty() | FilterCriteriaBuilder | Thiết lập tiêu chí bộ lọc để hiển thị các ô trống. |
whenCellNotEmpty() | FilterCriteriaBuilder | Thiế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) | FilterCriteriaBuilder | 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. |
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) | FilterCriteriaBuilder | Đặt 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) | FilterCriteriaBuilder | 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. |
whenDateNotEqualTo(date) | FilterCriteriaBuilder | Thiế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) | FilterCriteriaBuilder | 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. |
whenFormulaSatisfied(formula) | FilterCriteriaBuilder | Đặt tiêu chí lọc để hiển thị các ô có công thức được chỉ định (chẳng hạn như =B:B<C:C ) mà
cho kết quả là true . |
whenNumberBetween(start, end) | FilterCriteriaBuilder | Đặt tiêu chí 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) | FilterCriteriaBuilder | 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. |
whenNumberEqualToAny(numbers) | FilterCriteriaBuilder | Đặt tiêu chí bộ 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) | FilterCriteriaBuilder | Thiết lập tiêu chí lọc để hiển thị các ô có chứa văn bản chứa văn bản được chỉ định. |
whenTextDoesNotContain(text) | FilterCriteriaBuilder | 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. |
whenTextEndsWith(text) | FilterCriteriaBuilder | 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. |
whenTextEqualTo(text) | FilterCriteriaBuilder | 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. |
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) | FilterCriteriaBuilder | 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. |
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) | FilterCriteriaBuilder | 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. |
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, 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ứcwhen...()
tương ứng của lớpFilterCriteriaBuilder
.
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ị đang hiện 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ên | Loại | Mô tả |
---|---|---|
values | String[] | 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.
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ên | Loại | Mô tả |
---|---|---|
visibleBackgroundColor | Color | Mà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ên | Loại | Mô tả |
---|---|---|
visibleForegroundColor | Color | Mà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ị đang hiện 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ên | Loại | Mô tả |
---|---|---|
values | String[] | Danh sách các giá trị cần hiển thị. |
Cầu thủ trả bóng
FilterCriteriaBuilder
— Trình tạo này, để tạo chuỗi.
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ên | Loại | Mô tả |
---|---|---|
date | Date | Ngà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ên | Loại | Mô tả |
---|---|---|
date | RelativeDate | Ngà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ên | Loại | Mô tả |
---|---|---|
date | Date | Ngày sớm nhất để ẩn. |
Cầu thủ trả bóng
FilterCriteriaBuilder
— Trình tạo này, để tạo chuỗi.
whenDateBefore(date)
Đặt tiêu chí 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ên | Loại | Mô tả |
---|---|---|
date | RelativeDate | Ngày tương đối sớm nhất cần ẩn. |
Cầu thủ trả bóng
FilterCriteriaBuilder
— Trình tạo này, để tạo chuỗi.
whenDateEqualTo(date)
Đặt tiêu chí bộ lọc hiển thị các ô có ngày bằng 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ên | Loại | Mô tả |
---|---|---|
date | Date | Ngà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ên | Loại | Mô tả |
---|---|---|
date | RelativeDate | Ngà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ên | Loại | 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)
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ên | Loại | 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)
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ên | Loại | Mô tả |
---|---|---|
dates | Date[] | 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ên | Loại | Mô tả |
---|---|---|
formula | String | Mộ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í 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ên | Loại | Mô tả |
---|---|---|
start | Number | Số nhỏ 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)
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ên | Loại | Mô tả |
---|---|---|
number | Number | Số cần hiển thị. |
Cầu thủ trả bóng
FilterCriteriaBuilder
— Trình tạo này, để tạo chuỗi.
whenNumberEqualToAny(numbers)
Đặt tiêu chí bộ 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ên | Loại | Mô tả |
---|---|---|
numbers | Number[] | 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ên | Loại | Mô tả |
---|---|---|
number | Number | Số cao nhất cần ẩn. |
Cầu thủ trả bóng
FilterCriteriaBuilder
— Trình tạo này, để tạo chuỗi.
whenNumberGreaterThanOrEqualTo(number)
Đặt tiêu chí 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ên | Loại | Mô tả |
---|---|---|
number | Number | Số 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ên | Loại | Mô tả |
---|---|---|
number | Number | Số 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ên | Loại | 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 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ên | Loại | Mô tả |
---|---|---|
start | Number | Ẩn số thấp nhất. |
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ó 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ên | Loại | Mô tả |
---|---|---|
number | Number | Số cần ẩn. |
Cầu thủ trả bóng
FilterCriteriaBuilder
— Trình tạo này, để tạo chuỗi.
whenNumberNotEqualToAny(numbers)
Đặt tiêu chí 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ên | Loại | 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)
Thiết lập tiêu chí lọc để hiển thị các ô có chứa 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ên | Loại | Mô tả |
---|---|---|
text | String | Vă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ên | Loại | Mô tả |
---|---|---|
text | String | Văn bản mà ô không được chứa. |
Cầu thủ trả bóng
FilterCriteriaBuilder
— Trình tạo này, để tạo chuỗi.
whenTextEndsWith(text)
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ên | Loại | Mô tả |
---|---|---|
text | String | Vă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ên | Loại | Mô tả |
---|---|---|
text | String | Văn bản mà văn bản của ô phải bằng. |
Cầu thủ trả bóng
FilterCriteriaBuilder
— Trình tạo này, để tạo chuỗi.
whenTextEqualToAny(texts)
Đặt tiêu chí 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ên | Loại | Mô tả |
---|---|---|
texts | String[] | Giá trị văn bản mà một ô phải bằng. |
Cầu thủ trả bóng
FilterCriteriaBuilder
— Trình tạo này, để tạo chuỗi.
whenTextNotEqualTo(text)
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ên | Loại | Mô tả |
---|---|---|
text | String | Vă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ên | Loại | Mô tả |
---|---|---|
texts | String[] | 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ên | Loại | Mô tả |
---|---|---|
text | String | Vă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ên | Loại | 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 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.