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 วัน
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 วัน ระบบจะละเว้นช่องเวลาของออบเจ็กต์ 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 — ตัวสร้างนี้สําหรับการต่อเชื่อม