Class DataValidationBuilder

DataValidationBuilder

เครื่องมือสร้างกฎการตรวจสอบข้อมูล 

// Set the data validation for cell A1 to require a value from B1:B10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
build()DataValidationสร้างกฎการตรวจสอบข้อมูลจากการตั้งค่าที่ใช้กับเครื่องมือสร้าง
copy()DataValidationBuilderสร้างเครื่องมือสร้างสำหรับกฎการตรวจสอบข้อมูลตามการตั้งค่าของกฎนี้
getAllowInvalid()Booleanแสดงผล true หากกฎแสดงคำเตือนเมื่ออินพุตไม่ผ่านการตรวจสอบข้อมูล หรือ false หากปฏิเสธอินพุตทั้งหมด
getCriteriaType()DataValidationCriteriaรับประเภทเกณฑ์ของกฎตามที่กำหนดไว้ใน DataValidationCriteria enum
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 วันที่ ระบุ
requireDateEqualTo(date)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดวันที่ที่เท่ากับค่าที่ระบุ
requireDateNotBetween(start, end)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้ต้องระบุวันที่ที่ไม่อยู่ระหว่างวันที่ที่ระบุ 2 วันและไม่ใช่ทั้ง 2 วัน
requireDateOnOrAfter(date)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้ต้องระบุวันที่ตั้งแต่วันที่ที่ระบุเป็นต้นไป
requireDateOnOrBefore(date)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดวันที่เป็นค่าที่ระบุหรือก่อนหน้านั้น
requireFormulaSatisfied(formula)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าสูตรที่ระบุต้องประเมินเป็น true
requireNumberBetween(start, end)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่อยู่ระหว่างหรือเป็นหมายเลขใดหมายเลขหนึ่งใน 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.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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()

รับประเภทเกณฑ์ของกฎตามที่กำหนดไว้ใน DataValidationCriteria enum หากต้องการรับอาร์กิวเมนต์สำหรับเกณฑ์ ให้ใช้ getCriteriaValues() หากต้องการใช้ค่าเหล่านี้เพื่อสร้างหรือ แก้ไขกฎการตรวจสอบข้อมูล โปรดดูwithCriteria(criteria, args) 

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
checkedValueObjectค่าที่กำหนดให้กับช่องที่เลือก

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireCheckbox(checkedValue, uncheckedValue)

ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อให้ต้องป้อนค่าใดค่าหนึ่งที่ระบุ เมื่อ อินพุตเป็น checkedValue เซลล์จะแสดงเป็นช่องทำเครื่องหมายที่เลือก เมื่อ อินพุตเป็น uncheckedValue ระบบจะแสดงเซลล์เป็นช่องทำเครื่องหมายที่ไม่ได้เลือก 

// Set the data validation for cell A1 to require custom checked values that are
// rendered as a checkbox.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireCheckbox('APPROVED', 'PENDING')
                 .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
checkedValueObjectค่าที่กำหนดให้กับช่องที่เลือก
uncheckedValueObjectค่าที่กำหนดให้กับช่องที่ไม่ได้เลือก

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireDate()

ตั้งค่ากฎการตรวจสอบข้อมูลให้ต้องระบุวันที่ 

// Set the data validation for cell A1 to require a date.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

พารามิเตอร์

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

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireDateBefore(date)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ต้องระบุวันที่ก่อนค่าที่ระบุ ระบบจะไม่สนใจฟิลด์เวลาของออบเจ็กต์ Date แต่จะใช้เฉพาะฟิลด์วัน เดือน และปี 

// Set the data validation for cell A1 to require a date before January 1, 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่เร็วที่สุดที่ยอมรับไม่ได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireDateBetween(start, end)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ต้องระบุวันที่ที่อยู่ระหว่างหรือเป็นวันที่ใดวันที่หนึ่งใน 2 วันที่ ระบุ ระบบจะไม่สนใจฟิลด์เวลาของออบเจ็กต์ Date แต่จะใช้เฉพาะฟิลด์วัน เดือน และปี 

// Set the data validation for cell A1 to require a date in 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation()
        .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013'))
        .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startDateวันที่เร็วที่สุดที่ยอมรับได้
endDateวันที่ล่าสุดที่ยอมรับได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireDateEqualTo(date)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดวันที่ที่เท่ากับค่าที่ระบุ ระบบจะไม่สนใจฟิลด์เวลาของออบเจ็กต์ Date แต่จะใช้เฉพาะฟิลด์วัน เดือน และปี 

// Set the data validation for cell A1 to require a date equal to January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateEqualTo(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่ที่ยอมรับได้เพียงวันเดียว

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireDateNotBetween(start, end)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ต้องระบุวันที่ที่ไม่อยู่ระหว่างวันที่ที่ระบุ 2 วันและไม่ใช่ทั้ง 2 วัน ระบบจะไม่สนใจฟิลด์เวลาของออบเจ็กต์ Date แต่จะใช้เฉพาะฟิลด์วัน เดือน และปี 

// Set the data validation for cell A1 to require a date not in 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation()
        .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013'))
        .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startDateวันที่เร็วที่สุดที่ยอมรับไม่ได้
endDateวันที่ล่าสุดที่ยอมรับไม่ได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireDateOnOrAfter(date)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ต้องระบุวันที่ตั้งแต่วันที่ที่กำหนดเป็นต้นไป ระบบจะไม่สนใจฟิลด์เวลาของออบเจ็กต์ Date แต่จะใช้เฉพาะฟิลด์วัน เดือน และปี 

// Set the data validation for cell A1 to require a date on or after January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
dateDateวันที่เร็วที่สุดที่ยอมรับได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireDateOnOrBefore(date)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดวันที่เป็นค่าที่ระบุหรือก่อนหน้านั้น ระบบจะไม่สนใจฟิลด์เวลา ของออบเจ็กต์ Date และจะใช้เฉพาะฟิลด์วัน เดือน และปีเท่านั้น 

// Set the data validation for cell A1 to require a date on or before January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

พารามิเตอร์

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

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireFormulaSatisfied(formula)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าสูตรที่ระบุต้องประเมินเป็น true 

// Set the data validation for cell A1 to equal B1 with a custom formula.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireFormulaSatisfied('=EQ(A1,B1)')
                 .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
formulaStringสูตรที่กำหนดเองซึ่งประเมินเป็น true หากอินพุตถูกต้อง

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireNumberBetween(start, end)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่อยู่ระหว่างหรือเป็นหมายเลขใดหมายเลขหนึ่งใน 2 หมายเลขที่ระบุ 

// Set the data validation for cell A1 to require a number between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startNumberค่าต่ำสุดที่ยอมรับได้
endNumberค่าสูงสุดที่ยอมรับได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireNumberEqualTo(number)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่เท่ากับค่าที่ระบุ 

// Set the data validation for cell A1 to require a number equal
// to 3.1415926536.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberEqualTo(Math.PI).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าที่ยอมรับได้เพียงค่าเดียว

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireNumberGreaterThan(number)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่มากกว่าค่าที่ระบุ 

// Set the data validation for cell A1 to require a number greater than 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าสูงสุดที่ยอมรับไม่ได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireNumberGreaterThanOrEqualTo(number)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่มากกว่าหรือเท่ากับค่าที่ระบุ 

// Set the data validation for cell A1 to require a number greater than or equal
// to 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberGreaterThanOrEqualTo(0)
                 .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าต่ำสุดที่ยอมรับได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireNumberLessThan(number)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่น้อยกว่าค่าที่ระบุ 

// Set the data validation for cell A1 to require a number less than 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าต่ำสุดที่ยอมรับไม่ได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireNumberLessThanOrEqualTo(number)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่น้อยกว่าหรือเท่ากับค่าที่ระบุ 

// Set the data validation for cell A1 to require a number less than or equal to
// 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberLessThanOrEqualTo(0)
                 .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าสูงสุดที่ยอมรับได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireNumberNotBetween(start, end)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่ไม่อยู่ระหว่างและไม่ใช่ ของตัวเลข 2 ตัวที่ระบุ 

// Set the data validation for cell A1 to require a number not between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
startNumberค่าต่ำสุดที่ยอมรับไม่ได้
endNumberค่าสูงสุดที่ยอมรับไม่ได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireNumberNotEqualTo(number)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดหมายเลขที่ไม่เท่ากับค่าที่ระบุ 

// Set the data validation for cell A1 to require a number not equal to 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
numberNumberค่าเดียวที่ยอมรับไม่ได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireTextContains(text)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตต้องมีค่าที่ระบุ 

// Set the data validation for cell A1 to require any value that includes
// "Google".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringค่าที่อินพุตต้องมี

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireTextDoesNotContain(text)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตต้องไม่มีค่าที่ระบุ 

// Set the data validation for cell A1 to require any value that does not
// include "@".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringค่าที่อินพุตต้องไม่มี

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireTextEqualTo(text)

ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อให้ต้องป้อนค่าที่เท่ากับค่าที่กำหนด 

// Set the data validation for cell A1 to require "Yes".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
textStringค่าที่ยอมรับได้เพียงค่าเดียว

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireTextIsEmail()

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตต้องอยู่ในรูปแบบของอีเมล 

// Set the data validation for cell A1 to require text in the form of an email
// address.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInList(['Yes', 'No'])
                 .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valuesString[]อาร์เรย์ของค่าที่ยอมรับได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireValueInList(values, showDropdown)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตต้องเท่ากับค่าใดค่าหนึ่งที่ระบุ โดยมีตัวเลือกในการซ่อนเมนูแบบเลื่อนลง 

// Set the data validation for cell A1 to require "Yes" or "No", with no
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInList(['Yes', 'No'], false)
                 .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valuesString[]อาร์เรย์ของค่าที่ยอมรับได้
showDropdownBooleantrue หากสเปรดชีตควรแสดงเมนูแบบเลื่อนลงสำหรับค่า false หากไม่

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireValueInRange(range)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตต้องเท่ากับค่าในช่วงที่กำหนด 

// Set the data validation for cell A1 to require a value from B1:B10, with a
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rangeRangeช่วงที่มีค่าที่ยอมรับได้

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

requireValueInRange(range, showDropdown)

ตั้งค่ากฎการตรวจสอบข้อมูลให้กำหนดว่าอินพุตต้องเท่ากับค่าในช่วงที่กำหนด โดยมีตัวเลือกในการซ่อนเมนูแบบเลื่อนลง 

// Set the data validation for cell A1 to require value from B1:B10, with no
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInRange(range, false)
                 .build();
cell.setDataValidation(rule);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
rangeRangeช่วงที่มีค่าที่ยอมรับได้
showDropdownBooleantrue หากสเปรดชีตควรแสดงเมนูแบบเลื่อนลงสำหรับค่า false หากไม่

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

setAllowInvalid(allowInvalidData)

กำหนดว่าจะแสดงคำเตือนเมื่ออินพุตไม่ผ่านการตรวจสอบข้อมูล หรือจะปฏิเสธอินพุตทั้งหมด ค่าเริ่มต้นสำหรับกฎการตรวจสอบข้อมูลใหม่คือ true

พารามิเตอร์

ชื่อประเภทคำอธิบาย
allowInvalidDataBooleantrue หากกฎควรอนุญาตอินพุตที่ตรวจสอบข้อมูลไม่สำเร็จ false หากไม่

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

setHelpText(helpText)

ตั้งค่าข้อความช่วยเหลือที่จะปรากฏเมื่อผู้ใช้วางเมาส์เหนือเซลล์ที่มีการตั้งค่าการตรวจสอบข้อมูล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
helpTextStringข้อความช่วยเหลือที่จะตั้งค่า

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง

withCriteria(criteria, args)

ตั้งค่ากฎการตรวจสอบข้อมูลตามเกณฑ์ที่กำหนดโดยค่า DataValidationCriteria ซึ่งโดยปกติจะนำมาจาก criteria และ arguments ของกฎที่มีอยู่ 

// Change existing data validation rules that require a date in 2013 to require
// a date in 2014.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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);

พารามิเตอร์

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

รีเทิร์น

DataValidationBuilder - เครื่องมือสร้างนี้สำหรับการเชื่อมโยง