Class FilterCriteriaBuilder

FilterCriteriaBuilder

หากต้องการเพิ่มเกณฑ์ในตัวกรอง คุณต้องทำดังนี้

  1. สร้างเครื่องมือสร้างเกณฑ์โดยใช้ SpreadsheetApp.newFilterCriteria()
  2. เพิ่มการตั้งค่าให้เครื่องมือสร้างโดยใช้เมธอดจากชั้นเรียนนี้
  3. ใช้ 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valuesString[]รายการค่าที่จะซ่อน

รีเทิร์น

FilterCriteriaBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่

การขว้าง

Error — หากค่าใดค่าหนึ่งเป็น null


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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
visibleBackgroundColorColorสีพื้นหลังที่จะตั้งค่า สีต้องเป็นรูปแบบ 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
visibleForegroundColorColorสีพื้นหน้าที่จะตั้งค่า สีต้องเป็นรูปแบบ 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valuesString[]รายการค่าที่จะแสดง

รีเทิร์น

FilterCriteriaBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่

การขว้าง

Error — หากค่าใดค่าหนึ่งเป็น null


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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่ล่าสุดที่จะซ่อน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateRelativeDateวันที่ล่าสุดที่เกี่ยวข้อง

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่แรกสุดที่จะซ่อน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateRelativeDateวันที่สัมพัทธ์เร็วที่สุดที่จะซ่อน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่ที่ค่าของเซลล์ต้องตรงกัน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateRelativeDateวันที่สัมพัทธ์ที่ค่าของเซลล์ต้องตรงกัน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
datesDate[]วันที่ที่จะแสดง

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่ที่จะซ่อน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
datesDate[]วันที่ที่จะซ่อน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
formulaStringสูตรที่กำหนดเองซึ่งประเมินค่าเป็น 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startNumberจำนวนต่ำสุดที่จะแสดง
endNumberจำนวนสูงสุดที่จะแสดง

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberจำนวนที่จะแสดง

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numbersNumber[]ตัวเลขที่จะแสดง

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberจำนวนสูงสุดที่จะซ่อน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberจำนวนต่ำสุดที่จะแสดง

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberตัวเลขต่ำสุดที่จะซ่อน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberจำนวนสูงสุดที่จะแสดง

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startNumberตัวเลขต่ำสุดจะซ่อน
endNumberจำนวนสูงสุดที่จะซ่อน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberหมายเลขที่จะซ่อน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numbersNumber[]ตัวเลขที่จะซ่อน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่เซลล์ต้องมี

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่เซลล์ต้องไม่มี

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่ส่วนท้ายข้อความในเซลล์ต้องมี

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่ข้อความของเซลล์ต้องเท่ากัน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textsString[]ค่าข้อความที่เซลล์ต้องเท่ากัน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่ข้อความของเซลล์ไม่สามารถเท่ากัน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textsString[]ค่าข้อความที่เซลล์ไม่สามารถเท่ากัน

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringข้อความที่จุดเริ่มต้นของข้อความเซลล์ต้องมี

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
criteriaBooleanCriteriaประเภทของเกณฑ์บูลีน
argsObject[]อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะสมกับประเภทเกณฑ์ จำนวนอาร์กิวเมนต์และ ประเภทของพวกเขาตรงกับเมธอด when...() ที่เกี่ยวข้องด้านบน

รีเทิร์น

FilterCriteriaBuilder — เครื่องมือสร้างนี้สำหรับการทำสายโซ่