Class DataValidationBuilder

DataValidationBuilder

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

// 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ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกําหนดวันที่ที่อยู่ระหว่าง 1 หรือ 2 วันที่ที่ระบุ
requireDateEqualTo(date)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกําหนดวันที่ที่เท่ากับค่าที่ระบุ
requireDateNotBetween(start, end)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ที่ไม่อยู่ระหว่าง และไม่ใช่ 2 วันที่ที่ระบุ
requireDateOnOrAfter(date)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกําหนดวันที่ในหรือหลังจากค่าที่ระบุ
requireDateOnOrBefore(date)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกําหนดวันที่ในหรือก่อนค่าที่ระบุ
requireFormulaSatisfied(formula)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกําหนดให้สูตรที่ระบุประเมินเป็น true
requireNumberBetween(start, end)DataValidationBuilderตั้งค่ากฎการตรวจสอบข้อมูลให้ต้องมีตัวเลขที่อยู่ระหว่าง หรือเป็น 1 ใน 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

รีเทิร์น

Booleantrue หากกฎอนุญาตอินพุตที่ไม่ผ่านการตรวจสอบข้อมูล 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var 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.
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);

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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


requireDateBetween(start, end)

ตั้งค่ากฎการตรวจสอบข้อมูลเพื่อกําหนดวันที่ที่อยู่ระหว่าง 1 หรือ 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);

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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


requireDateNotBetween(start, end)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ระบุวันที่ที่ไม่อยู่ระหว่าง และไม่อยู่ใน 2 วันที่ที่ระบุ ระบบจะไม่สนใจช่องเวลาของออบเจ็กต์ 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);

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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


requireNumberBetween(start, end)

ตั้งค่ากฎการตรวจสอบข้อมูลให้ต้องมีตัวเลขที่อยู่ระหว่าง หรือเป็น 1 ใน 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);

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valuesString[]อาร์เรย์ของค่าที่ยอมรับได้
showDropdownBooleantrue หากสเปรดชีตควรแสดงเมนูแบบเลื่อนลงสำหรับค่า 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);

พารามิเตอร์

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

รีเทิร์น

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.
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);

พารามิเตอร์

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

รีเทิร์น

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