เครื่องมือสร้างกฎการตรวจสอบข้อมูล
// Set the data validation for cell A1 to require a value from B1:B10. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
build() | DataValidation | สร้างกฎการตรวจสอบข้อมูลจากการตั้งค่าที่ใช้กับเครื่องมือสร้าง |
copy() | DataValidationBuilder | สร้างเครื่องมือสร้างสำหรับกฎการตรวจสอบข้อมูลตามการตั้งค่าของกฎนี้ |
getAllowInvalid() | Boolean | แสดงผล true หากกฎแสดงคำเตือนเมื่ออินพุตไม่ผ่านการตรวจสอบข้อมูล หรือ false หากปฏิเสธอินพุตทั้งหมด |
getCriteriaType() | DataValidationCriteria | รับประเภทเกณฑ์ของกฎตามที่กำหนดไว้ใน enum ของ DataValidationCriteria |
getCriteriaValues() | Object[] | รับอาร์เรย์ของอาร์กิวเมนต์สำหรับเกณฑ์ของกฎ |
getHelpText() | String | รับข้อความช่วยเหลือของกฎ หรือnull หากไม่มีการตั้งค่าข้อความช่วยเหลือ |
requireCheckbox() | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดให้อินพุตเป็นค่าบูลีน โดยค่านี้จะแสดงผลเป็นช่องทำเครื่องหมาย |
requireCheckbox(checkedValue) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดให้อินพุตเป็นค่าที่ระบุหรือเว้นว่างไว้ |
requireCheckbox(checkedValue, uncheckedValue) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเป็นค่าใดค่าหนึ่งที่ระบุ |
requireDate() | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดวันที่ |
requireDateAfter(date) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่หลังจากค่าที่กำหนด |
requireDateBefore(date) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ก่อนค่าที่กำหนด |
requireDateBetween(start, end) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ที่อยู่ระหว่าง 2 หรือ 2 วันที่ระบุ |
requireDateEqualTo(date) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่เท่ากับค่าที่กำหนด |
requireDateNotBetween(start, end) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ที่ไม่อยู่ระหว่าง และไม่ใช่วันที่ที่ระบุทั้งสองวัน |
requireDateOnOrAfter(date) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ในหรือหลังจากค่าที่ระบุ |
requireDateOnOrBefore(date) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ในหรือก่อนค่าที่ระบุ |
requireFormulaSatisfied(formula) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้สูตรที่ระบุต้องประมวลผลเป็น true |
requireNumberBetween(start, end) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่อยู่ระหว่าง 2 หรือ 2 หมายเลขที่ระบุ |
requireNumberEqualTo(number) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขเท่ากับค่าที่กำหนด |
requireNumberGreaterThan(number) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดให้มีตัวเลขที่มากกว่าค่าที่กำหนด |
requireNumberGreaterThanOrEqualTo(number) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่มากกว่าหรือเท่ากับค่าที่กำหนด |
requireNumberLessThan(number) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่น้อยกว่าค่าที่กำหนด |
requireNumberLessThanOrEqualTo(number) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่น้อยกว่าหรือเท่ากับค่าที่กำหนด |
requireNumberNotBetween(start, end) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่ไม่อยู่ระหว่าง และไม่ใช่ตัวเลขที่ระบุทั้ง 2 จำนวน |
requireNumberNotEqualTo(number) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่ไม่เท่ากับค่าที่กำหนด |
requireTextContains(text) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้อินพุตมีค่าที่กำหนด |
requireTextDoesNotContain(text) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้อินพุตไม่มีค่าที่ระบุ |
requireTextEqualTo(text) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าที่กำหนด |
requireTextIsEmail() | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้ข้อมูลที่ป้อนอยู่ในรูปแบบอีเมล |
requireTextIsUrl() | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้อินพุตอยู่ในรูปแบบของ URL |
requireValueInList(values) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าใดค่าหนึ่งที่ระบุ |
requireValueInList(values, showDropdown) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าใดค่าหนึ่งที่ระบุ พร้อมด้วยตัวเลือกในการซ่อนเมนูแบบเลื่อนลง |
requireValueInRange(range) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าในช่วงที่กำหนด |
requireValueInRange(range, showDropdown) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าในช่วงที่กำหนด โดยมีตัวเลือกให้ซ่อนเมนูแบบเลื่อนลง |
setAllowInvalid(allowInvalidData) | DataValidationBuilder | ตั้งค่าว่าจะแสดงคำเตือนเมื่ออินพุตไม่ผ่านการตรวจสอบข้อมูลไหม หรือว่าจะปฏิเสธอินพุตทั้งหมดเลยหรือไม่ |
setHelpText(helpText) | DataValidationBuilder | ตั้งค่าข้อความช่วยเหลือที่จะปรากฏเมื่อผู้ใช้วางเมาส์เหนือเซลล์ที่ตั้งค่าการตรวจสอบข้อมูลไว้ |
withCriteria(criteria, args) | DataValidationBuilder | ตั้งค่ากฎการตรวจสอบข้อมูลเป็นเกณฑ์ที่กำหนดโดยค่า DataValidationCriteria ซึ่งโดยปกติแล้วจะนำมาจาก criteria และ arguments ของกฎที่มีอยู่ |
เอกสารประกอบโดยละเอียด
build()
สร้างกฎการตรวจสอบข้อมูลจากการตั้งค่าที่ใช้กับเครื่องมือสร้าง
รีเทิร์น
DataValidation
— การนำเสนอกฎการตรวจสอบข้อมูล
copy()
สร้างเครื่องมือสร้างสำหรับกฎการตรวจสอบข้อมูลตามการตั้งค่าของกฎนี้
// Change existing data validation rules that require a date in 2013 to require a date in 2014. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างตามการตั้งค่าของกฎนี้
getAllowInvalid()
แสดงผล true
หากกฎแสดงคำเตือนเมื่ออินพุตไม่ผ่านการตรวจสอบข้อมูล หรือ false
หากปฏิเสธอินพุตทั้งหมด ค่าเริ่มต้นสำหรับกฎการตรวจสอบข้อมูลใหม่คือ true
รีเทิร์น
Boolean
— true
หากกฎอนุญาตอินพุตที่ไม่ผ่านการตรวจสอบข้อมูล false
หากไม่เป็นเช่นนั้น
getCriteriaType()
รับประเภทเกณฑ์ของกฎตามที่กำหนดไว้ใน enum ของ DataValidationCriteria
หากต้องการดูอาร์กิวเมนต์สำหรับเกณฑ์ ให้ใช้ getCriteriaValues()
หากต้องการใช้ค่าเหล่านี้เพื่อสร้างหรือแก้ไขกฎการตรวจสอบข้อมูล โปรดดู withCriteria(criteria, args)
// Log information about the data validation rule for cell A1. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = cell.getDataValidation(); if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.') }
รีเทิร์น
DataValidationCriteria
— ประเภทของเกณฑ์การตรวจสอบข้อมูล
getCriteriaValues()
รับอาร์เรย์ของอาร์กิวเมนต์สำหรับเกณฑ์ของกฎ หากต้องการดูประเภทเกณฑ์ ให้ใช้ getCriteriaType()
หากต้องการใช้ค่าเหล่านี้เพื่อสร้างหรือแก้ไขกฎการตรวจสอบข้อมูล ให้ดูที่ withCriteria(criteria, args)
// Log information about the data validation rule for cell A1. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = cell.getDataValidation(); if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.') }
รีเทิร์น
Object[]
— อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะกับประเภทเกณฑ์ของกฎ จำนวนอาร์กิวเมนต์และประเภทตรงกับเมธอด require...()
ที่เกี่ยวข้องของคลาส DataValidationBuilder
getHelpText()
รับข้อความช่วยเหลือของกฎ หรือnull
หากไม่มีการตั้งค่าข้อความช่วยเหลือ
รีเทิร์น
String
— ข้อความช่วยเหลือของกฎ หรือ null
ถ้าไม่ได้ตั้งค่าข้อความช่วยเหลือไว้
requireCheckbox()
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดให้อินพุตเป็นค่าบูลีน โดยค่านี้จะแสดงผลเป็นช่องทำเครื่องหมาย
// Set the data validation for cell A1 to require a boolean value; the value is rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build(); cell.setDataValidation(rule);
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireCheckbox(checkedValue)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดให้อินพุตเป็นค่าที่ระบุหรือเว้นว่างไว้ เมื่ออินพุตตรงกับค่าที่ระบุ เซลล์จะแสดงผลเป็นช่องทำเครื่องหมายที่เลือก เมื่ออินพุตว่างเปล่า เซลล์จะแสดงผลเป็นช่องทำเครื่องหมายที่ไม่ได้ทำเครื่องหมาย
// Set the data validation for cell A1 to require a custom checked value that is rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
checkedValue | Object | ค่าที่กําหนดให้กับช่องที่ทำเครื่องหมาย |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireCheckbox(checkedValue, uncheckedValue)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเป็นค่าใดค่าหนึ่งที่ระบุ เมื่ออินพุตคือ checkedValue
เซลล์จะแสดงผลเป็นช่องทำเครื่องหมายที่เลือก เมื่ออินพุตคือ uncheckedValue
เซลล์จะแสดงผลเป็นช่องทำเครื่องหมายที่ไม่ได้ทำเครื่องหมาย
// Set the data validation for cell A1 to require custom checked values that are rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED', 'PENDING').build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
checkedValue | Object | ค่าที่กําหนดให้กับช่องที่ทำเครื่องหมาย |
uncheckedValue | Object | ค่าที่กําหนดให้กับช่องที่ไม่ได้ทำเครื่องหมาย |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireDate()
ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดวันที่
// Set the data validation for cell A1 to require a date. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDate().build(); cell.setDataValidation(rule);
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireDateAfter(date)
ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่หลังจากค่าที่กำหนด ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date
แต่จะใช้เฉพาะช่องวัน เดือน และปี
// Set the data validation for cell A1 to require a date after January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateAfter(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
date | Date | วันที่ล่าสุดที่ระบบไม่ยอมรับ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireDateBefore(date)
ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ก่อนค่าที่กำหนด ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date
แต่จะใช้เฉพาะช่องวัน เดือน และปี
// Set the data validation for cell A1 to require a date before January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateBefore(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
date | Date | วันที่แรกที่ยอมรับไม่ได้ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireDateBetween(start, end)
ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ที่อยู่ระหว่าง 2 หรือ 2 วันที่ระบุ ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date
แต่จะใช้เฉพาะช่องวัน เดือน และปี
// Set the data validation for cell A1 to require a date in 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
start | Date | วันที่แรกสุดที่ยอมรับได้ |
end | Date | วันที่ล่าสุดที่ยอมรับได้ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireDateEqualTo(date)
ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่เท่ากับค่าที่กำหนด ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date
แต่จะใช้เฉพาะช่องวัน เดือน และปี
// Set the data validation for cell A1 to require a date equal to January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013')) .build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
date | Date | วันที่ยอมรับเพียงอย่างเดียว |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireDateNotBetween(start, end)
ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ที่ไม่อยู่ระหว่าง และไม่ใช่วันที่ที่ระบุทั้งสองวัน ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date
แต่จะใช้เฉพาะช่องวัน เดือน และปี
// Set the data validation for cell A1 to require a date not in 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
start | Date | วันที่แรกที่ยอมรับไม่ได้ |
end | Date | วันที่ล่าสุดที่ระบบไม่ยอมรับ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireDateOnOrAfter(date)
ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ในหรือหลังจากค่าที่ระบุ ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date
แต่จะใช้เฉพาะช่องวัน เดือน และปี
// Set the data validation for cell A1 to require a date on or after January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateOnOrAfter(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
date | Date | วันที่แรกสุดที่ยอมรับได้ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireDateOnOrBefore(date)
ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ในหรือก่อนค่าที่ระบุ ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ Date
แต่จะใช้เฉพาะช่องวัน เดือน และปี
// Set the data validation for cell A1 to require a date on or before January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateOnOrBefore(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
date | Date | วันที่ล่าสุดที่ยอมรับได้ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireFormulaSatisfied(formula)
ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้สูตรที่ระบุต้องประมวลผลเป็น true
// Set the data validation for cell A1 to equal B1 with a custom formula. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireFormulaSatisfied('=EQ(A1,B1)').build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
formula | String | สูตรที่กำหนดเองซึ่งจะประเมินเป็น true หากอินพุตถูกต้อง |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireNumberBetween(start, end)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่อยู่ระหว่าง 2 หรือ 2 หมายเลขที่ระบุ
// Set the data validation for cell A1 to require a number between 1 and 10. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
start | Number | ค่าต่ำสุดที่ยอมรับได้ |
end | Number | ค่าสูงสุดที่ยอมรับได้ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireNumberEqualTo(number)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขเท่ากับค่าที่กำหนด
// Set the data validation for cell A1 to require a number equal to 3.1415926536. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
number | Number | ค่าที่ยอมรับได้เพียงค่าเดียว |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireNumberGreaterThan(number)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดให้มีตัวเลขที่มากกว่าค่าที่กำหนด
// Set the data validation for cell A1 to require a number greater than 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
number | Number | ค่าสูงสุดที่ยอมรับไม่ได้ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireNumberGreaterThanOrEqualTo(number)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่มากกว่าหรือเท่ากับค่าที่กำหนด
// Set the data validation for cell A1 to require a number greater than or equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
number | Number | ค่าต่ำสุดที่ยอมรับได้ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireNumberLessThan(number)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่น้อยกว่าค่าที่กำหนด
// Set the data validation for cell A1 to require a number less than 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
number | Number | ค่าต่ำสุดที่ยอมรับไม่ได้ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireNumberLessThanOrEqualTo(number)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่น้อยกว่าหรือเท่ากับค่าที่กำหนด
// Set the data validation for cell A1 to require a number less than or equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
number | Number | ค่าสูงสุดที่ยอมรับได้ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireNumberNotBetween(start, end)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่ไม่อยู่ระหว่าง และไม่ใช่ตัวเลขที่ระบุทั้ง 2 จำนวน
// Set the data validation for cell A1 to require a number not between 1 and 10. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
start | Number | ค่าต่ำสุดที่ยอมรับไม่ได้ |
end | Number | ค่าสูงสุดที่ยอมรับไม่ได้ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireNumberNotEqualTo(number)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดตัวเลขที่ไม่เท่ากับค่าที่กำหนด
// Set the data validation for cell A1 to require a number not equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
number | Number | ค่าที่ไม่ยอมรับเพียงอย่างเดียว |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireTextContains(text)
ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้อินพุตมีค่าที่กำหนด
// Set the data validation for cell A1 to require any value that includes "Google". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
text | String | ค่าที่ต้องมีในอินพุต |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireTextDoesNotContain(text)
ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้อินพุตไม่มีค่าที่ระบุ
// Set the data validation for cell A1 to require any value that does not include "@". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
text | String | ค่าที่ต้องไม่มีอยู่ในอินพุต |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireTextEqualTo(text)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าที่กำหนด
// Set the data validation for cell A1 to require "Yes". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
text | String | ค่าที่ยอมรับได้เพียงค่าเดียว |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireTextIsEmail()
ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้ข้อมูลที่ป้อนอยู่ในรูปแบบอีเมล
// Set the data validation for cell A1 to require text in the form of an email address. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build(); cell.setDataValidation(rule);
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireTextIsUrl()
ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกำหนดให้อินพุตอยู่ในรูปแบบของ URL
// Set the data validation for cell A1 to require text in the form of a URL. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build(); cell.setDataValidation(rule);
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireValueInList(values)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าใดค่าหนึ่งที่ระบุ
// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
values | String[] | อาร์เรย์ของค่าที่ยอมรับได้ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireValueInList(values, showDropdown)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าใดค่าหนึ่งที่ระบุ พร้อมด้วยตัวเลือกในการซ่อนเมนูแบบเลื่อนลง
// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
values | String[] | อาร์เรย์ของค่าที่ยอมรับได้ |
showDropdown | Boolean | true หากสเปรดชีตควรแสดงเมนูแบบเลื่อนลงสำหรับค่าดังกล่าว หรือให้ false หากไม่ต้องการ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireValueInRange(range)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าในช่วงที่กำหนด
// Set the data validation for cell A1 to require a value from B1:B10, with a dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
range | Range | ช่วงที่มีค่าที่ยอมรับได้ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
requireValueInRange(range, showDropdown)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตเท่ากับค่าในช่วงที่กำหนด โดยมีตัวเลือกให้ซ่อนเมนูแบบเลื่อนลง
// Set the data validation for cell A1 to require value from B1:B10, with no dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build(); cell.setDataValidation(rule);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
range | Range | ช่วงที่มีค่าที่ยอมรับได้ |
showDropdown | Boolean | true หากสเปรดชีตควรแสดงเมนูแบบเลื่อนลงสำหรับค่าดังกล่าว หรือให้ false หากไม่ต้องการ |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
setAllowInvalid(allowInvalidData)
ตั้งค่าว่าจะแสดงคำเตือนเมื่ออินพุตไม่ผ่านการตรวจสอบข้อมูลไหม หรือว่าจะปฏิเสธอินพุตทั้งหมดเลยหรือไม่ ค่าเริ่มต้นสำหรับกฎการตรวจสอบข้อมูลใหม่คือ true
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
allowInvalidData | Boolean | true หากกฎควรอนุญาตอินพุตที่ไม่ผ่านการตรวจสอบข้อมูล
false หากไม่อนุญาต |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
setHelpText(helpText)
ตั้งค่าข้อความช่วยเหลือที่จะปรากฏเมื่อผู้ใช้วางเมาส์เหนือเซลล์ที่ตั้งค่าการตรวจสอบข้อมูลไว้
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
helpText | String | ข้อความช่วยเหลือที่จะตั้งค่า |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน
withCriteria(criteria, args)
ตั้งค่ากฎการตรวจสอบข้อมูลเป็นเกณฑ์ที่กำหนดโดยค่า DataValidationCriteria
ซึ่งโดยปกติแล้วจะนำมาจาก criteria
และ arguments
ของกฎที่มีอยู่
// Change existing data validation rules that require a date in 2013 to require a date in 2014. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
criteria | DataValidationCriteria | ประเภทของเกณฑ์การตรวจสอบข้อมูล |
args | Object[] | อาร์เรย์ของอาร์กิวเมนต์ที่เหมาะกับประเภทเกณฑ์ จำนวนอาร์กิวเมนต์และประเภทตรงกับเมธอด require...() ที่เกี่ยวข้องข้างต้น |
รีเทิร์น
DataValidationBuilder
— เครื่องมือสร้างนี้สำหรับการทำเชน