หากต้องการเพิ่มเกณฑ์ในตัวกรอง คุณต้องทำดังนี้
- สร้างเครื่องมือสร้างเกณฑ์โดยใช้
SpreadsheetApp.newFilterCriteria()
- เพิ่มการตั้งค่าให้เครื่องมือสร้างโดยใช้เมธอดจากชั้นเรียนนี้
- ใช้
build()
เพื่อรวมเกณฑ์เข้ากับการตั้งค่าที่ระบุ
การใช้งานทั่วไป
ซ่อนค่าในชีต
ตัวอย่างต่อไปนี้ได้รับตัวกรองที่มีอยู่ของชีตและเพิ่มเกณฑ์ที่ซ่อนเซลล์ใน คอลัมน์ C ที่มีคำว่า "สวัสดี" หรือ "โลก" เกณฑ์ในตัวอย่างนี้สามารถใช้กับ ตัวกรองในชีตGrid
ซึ่งเป็นประเภทเริ่มต้นของชีต
let ss = SpreadsheetApp.getActiveSheet(); let filter = ss.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() .setHiddenValues(["hello", "world"]) .build(); filter.setColumnFilterCriteria(3, criteria);
แสดงเฉพาะเซลล์ที่ไม่ว่าง
ตัวอย่างต่อไปนี้เป็นการเพิ่มตัวกรองลงในแผ่นงานDataSource
ซึ่งเป็นแผ่นงานที่
ซึ่งเชื่อมต่อกับฐานข้อมูลได้ โดยมีเกณฑ์ที่แสดงเฉพาะเซลล์ใน "หมวดหมู่" คอลัมน์
ที่ไม่ว่างเปล่า
// 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);
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
build() | FilterCriteria | ประกอบเกณฑ์ตัวกรองโดยใช้การตั้งค่าที่คุณเพิ่มลงในเครื่องมือสร้างเกณฑ์ |
copy() | FilterCriteriaBuilder | คัดลอกเกณฑ์ตัวกรองนี้และสร้างเครื่องมือสร้างเกณฑ์ที่คุณสามารถใช้กับเกณฑ์อื่น ตัวกรอง |
getCriteriaType() | BooleanCriteria | แสดงผลประเภทบูลีนของเกณฑ์ เช่น CELL_EMPTY |
getCriteriaValues() | Object[] | แสดงผลอาร์เรย์ของอาร์กิวเมนต์สำหรับเกณฑ์บูลีน |
getHiddenValues() | String[] | แสดงผลค่าที่ตัวกรองซ่อนไว้ |
getVisibleBackgroundColor() | Color | แสดงผลสีพื้นหลังที่ใช้เป็นเกณฑ์ตัวกรอง |
getVisibleForegroundColor() | Color | แสดงผลสีพื้นหน้าที่ใช้เป็นเกณฑ์ตัวกรอง |
getVisibleValues() | String[] | แสดงผลค่าที่ตัวกรองตาราง Pivot แสดง |
setHiddenValues(values) | FilterCriteriaBuilder | กำหนดค่าที่จะซ่อน |
setVisibleBackgroundColor(visibleBackgroundColor) | FilterCriteriaBuilder | ตั้งค่าสีพื้นหลังที่ใช้เป็นเกณฑ์ตัวกรอง |
setVisibleForegroundColor(visibleForegroundColor) | FilterCriteriaBuilder | ตั้งค่าสีพื้นหน้าที่ใช้เป็นเกณฑ์ตัวกรอง |
setVisibleValues(values) | FilterCriteriaBuilder | กำหนดค่าที่จะแสดงในตาราง Pivot |
whenCellEmpty() | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ว่าง |
whenCellNotEmpty() | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่ไม่ว่างเปล่า |
whenDateAfter(date) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองซึ่งแสดงเซลล์ที่มีวันที่อยู่หลังจากวันที่ที่ระบุ |
whenDateAfter(date) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองซึ่งแสดงเซลล์ที่มีวันที่ที่อยู่หลังวันที่สัมพัทธ์ที่ระบุ |
whenDateBefore(date) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองซึ่งแสดงเซลล์ที่มีวันที่อยู่ก่อนวันที่ที่ระบุ |
whenDateBefore(date) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองซึ่งแสดงเซลล์ที่มีวันที่ที่อยู่ก่อนวันที่สัมพัทธ์ที่ระบุ |
whenDateEqualTo(date) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองซึ่งแสดงเซลล์ที่มีวันที่ซึ่งเท่ากับวันที่ที่ระบุ |
whenDateEqualTo(date) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองซึ่งแสดงเซลล์ที่มีวันที่ซึ่งเท่ากับวันที่สัมพัทธ์ที่ระบุ |
whenDateEqualToAny(dates) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีวันที่ตรงกับวันที่ที่ระบุ |
whenDateNotEqualTo(date) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่ไม่เท่ากับวันที่ที่ระบุ |
whenDateNotEqualToAny(dates) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีวันที่ที่ไม่เท่ากับรายการใดๆ ที่ระบุ วันที่ |
whenFormulaSatisfied(formula) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีสูตรที่ระบุ (เช่น =B:B<C:C ) ที่
ประเมินผลเป็น true |
whenNumberBetween(start, end) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขอยู่ระหว่าง 2 หรือ 2 หมายเลขที่ระบุ |
whenNumberEqualTo(number) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขเท่ากับจำนวนที่ระบุ |
whenNumberEqualToAny(numbers) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขเท่ากับเซลล์ที่ระบุ ตัวเลข |
whenNumberGreaterThan(number) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขมากกว่าจำนวนที่ระบุ |
whenNumberGreaterThanOrEqualTo(number) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขมากกว่าหรือเท่ากับที่ระบุ หมายเลข |
whenNumberLessThan(number) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขน้อยกว่าจำนวนที่ระบุ |
whenNumberLessThanOrEqualTo(number) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขน้อยกว่าหรือเท่ากับที่ระบุ หมายเลข |
whenNumberNotBetween(start, end) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขไม่อยู่ระหว่าง 2 และไม่ใช่ทั้ง 2 หมายเลขที่ระบุ |
whenNumberNotEqualTo(number) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขไม่เท่ากับจำนวนที่ระบุ |
whenNumberNotEqualToAny(numbers) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขไม่เท่ากับเซลล์ที่ระบุ ตัวเลข |
whenTextContains(text) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความที่มีข้อความที่ระบุ |
whenTextDoesNotContain(text) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความซึ่งไม่มีข้อความที่ระบุ |
whenTextEndsWith(text) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความซึ่งลงท้ายด้วยข้อความที่ระบุ |
whenTextEqualTo(text) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความเท่ากับข้อความที่ระบุ |
whenTextEqualToAny(texts) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความเท่ากับข้อความที่ระบุ |
whenTextNotEqualTo(text) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความที่ไม่เท่ากับข้อความที่ระบุ |
whenTextNotEqualToAny(texts) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความที่ไม่เท่ากับรายการใดๆ ที่ระบุ |
whenTextStartsWith(text) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความซึ่งเริ่มต้นด้วยข้อความที่ระบุ |
withCriteria(criteria, args) | FilterCriteriaBuilder | ตั้งค่าเกณฑ์ตัวกรองเป็นเงื่อนไขบูลีนที่กำหนดโดยค่า BooleanCriteria เช่น
เป็น CELL_EMPTY หรือ NUMBER_GREATER_THAN |
เอกสารโดยละเอียด
build()
ประกอบเกณฑ์ตัวกรองโดยใช้การตั้งค่าที่คุณเพิ่มลงในเครื่องมือสร้างเกณฑ์
// 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);
รีเทิร์น
FilterCriteria
— การนำเสนอเกณฑ์ตัวกรอง
copy()
คัดลอกเกณฑ์ตัวกรองนี้และสร้างเครื่องมือสร้างเกณฑ์ที่คุณสามารถใช้กับเกณฑ์อื่น ตัวกรอง
คุณสามารถใช้วิธีนี้กับตัวกรองประเภทใดก็ได้ หากใช้ตัวกรองชีต คุณจะทำสิ่งต่อไปนี้ได้ คัดลอกเกณฑ์ไปยังคอลัมน์อื่น
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);
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างเกณฑ์ตัวกรองตามเกณฑ์ตัวกรองนี้
getCriteriaType()
แสดงผลประเภทบูลีนของเกณฑ์ เช่น CELL_EMPTY
เพื่อเรียนรู้เกี่ยวกับประเภทต่างๆ
ของเกณฑ์บูลีน โปรดดู enum BooleanCriteria
ผู้ใช้มักใช้วิธีนี้ในการเพิ่มเกณฑ์เงื่อนไขบูลีนลงในตัวกรองโดยไม่ต้องแทนที่ เกณฑ์ที่มีอยู่
- หากต้องการดูอาร์กิวเมนต์สำหรับเกณฑ์ ให้ใช้
getCriteriaValues()
- หากต้องการใช้ประเภทของเกณฑ์และค่าเกณฑ์ในการสร้างหรือแก้ไขเกณฑ์ตัวกรอง โปรดดู
withCriteria(criteria, args)
คุณสามารถใช้วิธีนี้กับตัวกรองประเภทใดก็ได้ หากเกณฑ์ตัวกรองไม่ใช่บูลีน
สภาพสินค้า แสดงผล 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);
รีเทิร์น
BooleanCriteria
— ประเภทของเกณฑ์บูลีน หรือ null
หากเกณฑ์ไม่ใช่ค่าบูลีน
getCriteriaValues()
แสดงผลอาร์เรย์ของอาร์กิวเมนต์สำหรับเกณฑ์บูลีน เกณฑ์บูลีนบางประเภทไม่มี
อาร์กิวเมนต์และแสดงผลอาร์เรย์ที่ว่างเปล่า เช่น CELL_NOT_EMPTY
ผู้ใช้มักใช้วิธีนี้ในการเพิ่มเกณฑ์เงื่อนไขบูลีนลงในตัวกรองโดยไม่ต้องแทนที่ เกณฑ์ที่มีอยู่
- หากต้องการดูประเภทเกณฑ์บูลีน ให้ใช้
getCriteriaType()
- หากต้องการใช้ประเภทของเกณฑ์และค่าเกณฑ์ในการสร้างหรือแก้ไขเกณฑ์ตัวกรอง โปรดดู
withCriteria(criteria, args)
คุณสามารถใช้วิธีนี้กับตัวกรองประเภทใดก็ได้
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);
รีเทิร์น
Object[]
— อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะกับประเภทเกณฑ์แบบบูลีน จำนวนอาร์กิวเมนต์ และประเภทของพวกเขาตรงกับเมธอดwhen...()
ที่เกี่ยวข้องของคลาสFilterCriteriaBuilder
getHiddenValues()
แสดงผลค่าที่ตัวกรองซ่อนไว้
ใช้เกณฑ์นี้กับตัวกรองในชีต Grid
ซึ่งเป็นประเภทเริ่มต้นของชีต
แสดงผล null
หากคุณเรียกใช้เมธอดนี้สำหรับตัวกรองประเภทอื่นๆ
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);
รีเทิร์น
String[]
— อาร์เรย์ของค่าที่ตัวกรองซ่อนไว้
getVisibleBackgroundColor()
แสดงผลสีพื้นหลังที่ใช้เป็นเกณฑ์ตัวกรอง เซลล์ที่มีสีพื้นหลังนี้จะยังคงอยู่ มองเห็นได้
ใช้เกณฑ์นี้กับตัวกรองในชีต Grid
ซึ่งเป็นประเภทเริ่มต้นของชีต
แสดงผล null
หากคุณเรียกใช้เมธอดนี้สำหรับตัวกรองประเภทอื่นๆ
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);
รีเทิร์น
Color
— สีพื้นหลังที่ใช้เป็นเกณฑ์ตัวกรอง
getVisibleForegroundColor()
แสดงผลสีพื้นหน้าที่ใช้เป็นเกณฑ์ตัวกรอง เซลล์ที่มีสีพื้นหน้าจะยังคงอยู่ มองเห็นได้
ใช้เกณฑ์นี้กับตัวกรองในชีต Grid
ซึ่งเป็นประเภทเริ่มต้นของชีต
แสดงผล null
หากคุณเรียกใช้เมธอดนี้สำหรับตัวกรองประเภทอื่นๆ
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);
รีเทิร์น
Color
— สีพื้นหน้าที่ใช้เป็นเกณฑ์ตัวกรอง
getVisibleValues()
แสดงผลค่าที่ตัวกรองตาราง Pivot แสดง
เกณฑ์นี้มีไว้สำหรับตัวกรองในตาราง Pivot ที่ไม่ได้เชื่อมต่อกับฐานข้อมูลเท่านั้น แสดงผลอาร์เรย์ที่ว่างเปล่าสำหรับตัวกรองประเภทอื่นๆ
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);
รีเทิร์น
String[]
— อาร์เรย์ของค่าที่ตัวกรองตาราง Pivot แสดง
setHiddenValues(values)
กำหนดค่าที่จะซ่อน ล้างค่าที่มองเห็นได้หรือค่าซ่อนที่มีอยู่
คุณสามารถใช้เกณฑ์นี้สำหรับตัวกรองใน Grid
ชีตเท่านั้น โดยค่าเริ่มต้น
ของชีต
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
values | String[] | รายการค่าที่จะซ่อน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
setVisibleBackgroundColor(visibleBackgroundColor)
ตั้งค่าสีพื้นหลังที่ใช้เป็นเกณฑ์ตัวกรอง เซลล์ที่มีสีพื้นหลังนี้จะยังคงอยู่ มองเห็นได้ การตั้งค่าเกณฑ์ตัวกรองสีพื้นหลังจะนำเกณฑ์ตัวกรองสีปัจจุบันออก จากเครื่องมือสร้างนี้
คุณสามารถใช้เกณฑ์นี้สำหรับตัวกรองใน Grid
ชีตเท่านั้น โดยค่าเริ่มต้น
ของชีต
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
visibleBackgroundColor | Color | สีพื้นหลังที่จะตั้งค่า สีต้องเป็นรูปแบบ RGB สี วิธีนี้ไม่รองรับสีธีม |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
setVisibleForegroundColor(visibleForegroundColor)
ตั้งค่าสีพื้นหน้าที่ใช้เป็นเกณฑ์ตัวกรอง เซลล์ที่มีสีพื้นหน้าจะยังคงอยู่ มองเห็นได้ การตั้งค่าเกณฑ์ตัวกรองสีพื้นหน้าจะนำเกณฑ์ตัวกรองสีปัจจุบันทั้งหมดออก จากเครื่องมือสร้างนี้
คุณสามารถใช้เกณฑ์นี้สำหรับตัวกรองใน Grid
ชีตเท่านั้น โดยค่าเริ่มต้น
ของชีต
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
visibleForegroundColor | Color | สีพื้นหน้าที่จะตั้งค่า สีต้องเป็นรูปแบบ RGB สี วิธีนี้ไม่รองรับสีธีม |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
setVisibleValues(values)
กำหนดค่าที่จะแสดงในตาราง Pivot ล้างค่าที่มองเห็นได้หรือค่าซ่อนที่มีอยู่
คุณสามารถใช้เกณฑ์นี้สำหรับตัวกรองในตาราง Pivot ที่ไม่ได้เชื่อมต่อกับ ฐานข้อมูล
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
values | String[] | รายการค่าที่จะแสดง |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenCellEmpty()
ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ว่าง
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้
// 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);
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenCellNotEmpty()
ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่ไม่ว่างเปล่า
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้
// 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);
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenDateAfter(date)
ตั้งค่าเกณฑ์ตัวกรองซึ่งแสดงเซลล์ที่มีวันที่อยู่หลังจากวันที่ที่ระบุ
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ เชื่อมต่อกับฐานข้อมูลอยู่ ประเภทข้อมูลของคอลัมน์ที่ใช้กรองต้องเป็นวันที่ หาก ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล แต่ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่เชื่อมต่อ ต้องเป็นวันที่ แต่หากไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | Date | วันที่ล่าสุดที่จะซ่อน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenDateAfter(date)
ตั้งค่าเกณฑ์ตัวกรองซึ่งแสดงเซลล์ที่มีวันที่ที่อยู่หลังวันที่สัมพัทธ์ที่ระบุ ถึง
ดูตัวเลือกวันที่สัมพัทธ์ที่แจกแจง RelativeDate
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ เชื่อมต่อกับฐานข้อมูลอยู่ ประเภทข้อมูลของคอลัมน์ที่ใช้กรองต้องเป็นวันที่ หาก ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล แต่ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่เชื่อมต่อ ต้องเป็นวันที่ แต่หากไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | RelativeDate | วันที่ล่าสุดที่เกี่ยวข้อง |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenDateBefore(date)
ตั้งค่าเกณฑ์ตัวกรองซึ่งแสดงเซลล์ที่มีวันที่อยู่ก่อนวันที่ที่ระบุ
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ เชื่อมต่อกับฐานข้อมูลอยู่ ประเภทข้อมูลของคอลัมน์ที่ใช้กรองต้องเป็นวันที่ หาก ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล แต่ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่เชื่อมต่อ ต้องเป็นวันที่ แต่หากไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | Date | วันที่แรกสุดที่จะซ่อน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenDateBefore(date)
ตั้งค่าเกณฑ์ตัวกรองซึ่งแสดงเซลล์ที่มีวันที่ที่อยู่ก่อนวันที่สัมพัทธ์ที่ระบุ
หากต้องการดูตัวเลือกวันที่สัมพัทธ์ โปรดดู Enum RelativeDate
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ เชื่อมต่อกับฐานข้อมูลอยู่ ประเภทข้อมูลของคอลัมน์ที่ใช้กรองต้องเป็นวันที่ หาก ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล แต่ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่เชื่อมต่อ ต้องเป็นวันที่ แต่หากไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | RelativeDate | วันที่สัมพัทธ์เร็วที่สุดที่จะซ่อน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenDateEqualTo(date)
ตั้งค่าเกณฑ์ตัวกรองซึ่งแสดงเซลล์ที่มีวันที่ซึ่งเท่ากับวันที่ที่ระบุ
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ เชื่อมต่อกับฐานข้อมูลอยู่ ประเภทข้อมูลของคอลัมน์ที่ใช้กรองต้องเป็นวันที่ หาก ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล แต่ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่เชื่อมต่อ ต้องเป็นวันที่ แต่หากไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | Date | วันที่ที่ค่าของเซลล์ต้องตรงกัน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenDateEqualTo(date)
ตั้งค่าเกณฑ์ตัวกรองซึ่งแสดงเซลล์ที่มีวันที่ซึ่งเท่ากับวันที่สัมพัทธ์ที่ระบุ
หากต้องการดูตัวเลือกวันที่สัมพัทธ์ โปรดดู Enum RelativeDate
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ เชื่อมต่อกับฐานข้อมูลอยู่ ประเภทข้อมูลของคอลัมน์ที่ใช้กรองต้องเป็นวันที่ หาก ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล แต่ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่เชื่อมต่อ ต้องเป็นวันที่ แต่หากไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | RelativeDate | วันที่สัมพัทธ์ที่ค่าของเซลล์ต้องตรงกัน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenDateEqualToAny(dates)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีวันที่ตรงกับวันที่ที่ระบุ
คุณสามารถใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ให้ใช้
เกณฑ์ที่มีตัวกรองในชีต DataSource
ซึ่งเป็นแผ่นงานที่เชื่อมต่อกับ
ฐานข้อมูลหรือ DataSourcePivotTable
ตาราง Pivot ที่สร้างจากชีต 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
dates | Date[] | วันที่ที่จะแสดง |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenDateNotEqualTo(date)
ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่ไม่เท่ากับวันที่ที่ระบุ
คุณสามารถใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ให้ใช้
เกณฑ์ที่มีตัวกรองในชีต DataSource
ซึ่งเป็นแผ่นงานที่เชื่อมต่อกับ
ฐานข้อมูลหรือ DataSourcePivotTable
ตาราง Pivot ที่สร้างจากชีต DataSource
ประเภทข้อมูลของคอลัมน์ที่ใช้กรองต้องเป็นวันที่
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
date | Date | วันที่ที่จะซ่อน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenDateNotEqualToAny(dates)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีวันที่ที่ไม่เท่ากับรายการใดๆ ที่ระบุ วันที่
คุณสามารถใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ให้ใช้
เกณฑ์ที่มีตัวกรองในชีต DataSource
ซึ่งเป็นแผ่นงานที่เชื่อมต่อกับ
ฐานข้อมูลหรือ DataSourcePivotTable
ตาราง Pivot ที่สร้างจากชีต 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
dates | Date[] | วันที่ที่จะซ่อน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenFormulaSatisfied(formula)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีสูตรที่ระบุ (เช่น =B:B<C:C
) ที่
ประเมินผลเป็น true
คุณสามารถใช้เกณฑ์นี้เพื่อกรองข้อมูลที่ไม่ได้เชื่อมต่อกับฐานข้อมูลเท่านั้น
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
formula | String | สูตรที่กำหนดเองซึ่งประเมินค่าเป็น true หากอินพุตถูกต้อง |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenNumberBetween(start, end)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขอยู่ระหว่าง 2 หรือ 2 หมายเลขที่ระบุ
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ ที่มีการเชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่ใช้กรองจะต้องเป็นตัวเลข ถ้า ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่ ต้องเป็นตัวเลข แต่ถ้าไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
start | Number | จำนวนต่ำสุดที่จะแสดง |
end | Number | จำนวนสูงสุดที่จะแสดง |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenNumberEqualTo(number)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขเท่ากับจำนวนที่ระบุ
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ ที่มีการเชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่ใช้กรองจะต้องเป็นตัวเลข ถ้า ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่ ต้องเป็นตัวเลข แต่ถ้าไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Number | จำนวนที่จะแสดง |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenNumberEqualToAny(numbers)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขเท่ากับเซลล์ที่ระบุ ตัวเลข
คุณสามารถใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ให้ใช้
เกณฑ์ที่มีตัวกรองในชีต DataSource
ซึ่งเป็นแผ่นงานที่เชื่อมต่อกับ
ฐานข้อมูลหรือ DataSourcePivotTable
ตาราง Pivot ที่สร้างจากชีต 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
numbers | Number[] | ตัวเลขที่จะแสดง |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenNumberGreaterThan(number)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขมากกว่าจำนวนที่ระบุ
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ ที่มีการเชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่ใช้กรองจะต้องเป็นตัวเลข ถ้า ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่ ต้องเป็นตัวเลข แต่ถ้าไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Number | จำนวนสูงสุดที่จะซ่อน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenNumberGreaterThanOrEqualTo(number)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขมากกว่าหรือเท่ากับที่ระบุ หมายเลข
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ ที่มีการเชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่ใช้กรองจะต้องเป็นตัวเลข ถ้า ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่ ต้องเป็นตัวเลข แต่ถ้าไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Number | จำนวนต่ำสุดที่จะแสดง |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenNumberLessThan(number)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขน้อยกว่าจำนวนที่ระบุ
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ ที่มีการเชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่ใช้กรองจะต้องเป็นตัวเลข ถ้า ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่ ต้องเป็นตัวเลข แต่ถ้าไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Number | ตัวเลขต่ำสุดที่จะซ่อน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenNumberLessThanOrEqualTo(number)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขน้อยกว่าหรือเท่ากับที่ระบุ หมายเลข
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ ที่มีการเชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่ใช้กรองจะต้องเป็นตัวเลข ถ้า ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่ ต้องเป็นตัวเลข แต่ถ้าไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Number | จำนวนสูงสุดที่จะแสดง |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenNumberNotBetween(start, end)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขไม่อยู่ระหว่าง 2 และไม่ใช่ทั้ง 2 หมายเลขที่ระบุ
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ ที่มีการเชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่ใช้กรองจะต้องเป็นตัวเลข ถ้า ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่ ต้องเป็นตัวเลข แต่ถ้าไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
start | Number | ตัวเลขต่ำสุดจะซ่อน |
end | Number | จำนวนสูงสุดที่จะซ่อน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenNumberNotEqualTo(number)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขไม่เท่ากับจำนวนที่ระบุ
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ หากคุณใช้เกณฑ์นี้กับข้อมูลที่มีลักษณะดังนี้ ที่มีการเชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่ใช้กรองจะต้องเป็นตัวเลข ถ้า ข้อมูลไม่ได้เชื่อมต่อกับฐานข้อมูล ประเภทข้อมูลของคอลัมน์ที่คุณกรองจะไม่ ต้องเป็นตัวเลข แต่ถ้าไม่ใช่ คุณอาจได้รับผลลัพธ์ที่ไม่คาดคิด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
number | Number | หมายเลขที่จะซ่อน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenNumberNotEqualToAny(numbers)
ตั้งค่าเกณฑ์ตัวกรองให้แสดงเซลล์ที่มีตัวเลขไม่เท่ากับเซลล์ที่ระบุ ตัวเลข
คุณสามารถใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ให้ใช้
เกณฑ์ที่มีตัวกรองในชีต DataSource
ซึ่งเป็นแผ่นงานที่เชื่อมต่อกับ
ฐานข้อมูลหรือ DataSourcePivotTable
ตาราง Pivot ที่สร้างจากชีต 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
numbers | Number[] | ตัวเลขที่จะซ่อน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenTextContains(text)
ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความที่มีข้อความที่ระบุ ข้อความ ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ข้อความที่เซลล์ต้องมี |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenTextDoesNotContain(text)
ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความซึ่งไม่มีข้อความที่ระบุ จะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ข้อความที่เซลล์ต้องไม่มี |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenTextEndsWith(text)
ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความซึ่งลงท้ายด้วยข้อความที่ระบุ ข้อความ ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ข้อความที่ส่วนท้ายข้อความในเซลล์ต้องมี |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenTextEqualTo(text)
ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความเท่ากับข้อความที่ระบุ ข้อความ ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ข้อความที่ข้อความของเซลล์ต้องเท่ากัน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenTextEqualToAny(texts)
ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความเท่ากับข้อความที่ระบุ ข้อความจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
คุณสามารถใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ให้ใช้
เกณฑ์ที่มีตัวกรองในชีต DataSource
ซึ่งเป็นแผ่นงานที่เชื่อมต่อกับ
ฐานข้อมูลหรือ DataSourcePivotTable
ตาราง Pivot ที่สร้างจากชีต 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
texts | String[] | ค่าข้อความที่เซลล์ต้องเท่ากัน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenTextNotEqualTo(text)
ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความที่ไม่เท่ากับข้อความที่ระบุ จะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
คุณสามารถใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ให้ใช้
เกณฑ์ที่มีตัวกรองในชีต DataSource
ซึ่งเป็นแผ่นงานที่เชื่อมต่อกับ
ฐานข้อมูลหรือ DataSourcePivotTable
ตาราง Pivot ที่สร้างจากชีต 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ข้อความที่ข้อความของเซลล์ไม่สามารถเท่ากัน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenTextNotEqualToAny(texts)
ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความที่ไม่เท่ากับรายการใดๆ ที่ระบุ ข้อความจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
คุณสามารถใช้เกณฑ์นี้กับข้อมูลที่เชื่อมต่อกับฐานข้อมูลเท่านั้น เช่น ให้ใช้
เกณฑ์ที่มีตัวกรองในชีต DataSource
ซึ่งเป็นแผ่นงานที่เชื่อมต่อกับ
ฐานข้อมูลหรือ DataSourcePivotTable
ตาราง Pivot ที่สร้างจากชีต 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
texts | String[] | ค่าข้อความที่เซลล์ไม่สามารถเท่ากัน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
whenTextStartsWith(text)
ตั้งค่าเกณฑ์ตัวกรองเพื่อแสดงเซลล์ที่มีข้อความซึ่งเริ่มต้นด้วยข้อความที่ระบุ ข้อความ ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ข้อความที่จุดเริ่มต้นของข้อความเซลล์ต้องมี |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่
withCriteria(criteria, args)
ตั้งค่าเกณฑ์ตัวกรองเป็นเงื่อนไขบูลีนที่กำหนดโดยค่า BooleanCriteria
เช่น
เป็น CELL_EMPTY
หรือ NUMBER_GREATER_THAN
วิธีคัดลอกเงื่อนไขบูลีนจาก
เกณฑ์ที่มีอยู่ ให้กำหนดพารามิเตอร์สำหรับเมธอดนี้โดยใช้ getCriteriaType()
และ getCriteriaValues()
ใน
เกณฑ์ที่มีอยู่
คุณสามารถใช้เกณฑ์นี้กับตัวกรองประเภทใดก็ได้ แต่BooleanCriteria
บางรายการไม่สามารถใช้ได้
ใช้ได้กับตัวกรองทั้งหมด
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
criteria | BooleanCriteria | ประเภทของเกณฑ์บูลีน |
args | Object[] | อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะสมกับประเภทเกณฑ์ จำนวนอาร์กิวเมนต์และ
ประเภทของพวกเขาตรงกับเมธอด when...() ที่เกี่ยวข้องด้านบน |
รีเทิร์น
FilterCriteriaBuilder
— เครื่องมือสร้างนี้สำหรับการทำสายโซ่