Class 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() Data Validation یک قانون اعتبارسنجی داده از تنظیمات اعمال شده به سازنده می‌سازد.
copy() Data Validation Builder بر اساس تنظیمات این قانون، یک سازنده برای قانون اعتبارسنجی داده‌ها ایجاد می‌کند.
get Allow Invalid() Boolean اگر قانون هنگام عدم اعتبارسنجی ورودی، هشداری نشان دهد، true را برمی‌گرداند، و اگر ورودی را به طور کامل رد کند، false را برمی‌گرداند.
get Criteria Type() Data Validation Criteria نوع معیار قانون را همانطور که در شمارش Data Validation Criteria تعریف شده است، برمی‌گرداند.
get Criteria Values() Object[] آرایه‌ای از آرگومان‌ها را برای معیارهای قاعده دریافت می‌کند.
get Help Text() String متن راهنمای قانون را برمی‌گرداند، یا اگر متن راهنمایی تنظیم نشده باشد، null برمی‌گرداند.
require Checkbox() Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که ورودی باید یک مقدار بولی باشد؛ این مقدار به صورت یک کادر انتخاب نمایش داده می‌شود.
require Checkbox(checkedValue) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که ورودی باید مقدار مشخص شده یا خالی باشد.
require Checkbox(checkedValue, uncheckedValue) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که ورودی باید یکی از مقادیر مشخص شده باشد.
require Date() Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که به تاریخ نیاز داشته باشد.
require Date After(date) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که پس از مقدار داده شده، به تاریخ نیاز داشته باشد.
require Date Before(date) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که قبل از مقدار داده شده، به تاریخ نیاز داشته باشد.
require Date Between(start, end) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که تاریخی را الزامی کند که بین دو تاریخ مشخص شده یا یکی از آنها باشد.
require Date Equal To(date) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که تاریخی برابر با مقدار داده شده را الزامی کند.
require Date Not Between(start, end) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که تاریخی را الزامی کند که بین دو تاریخ مشخص شده قرار نگیرد و هیچ‌کدام از آنها نباشد.
require Date On Or After(date) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که نیاز به یک تاریخ در یا بعد از مقدار داده شده داشته باشد.
require Date On Or Before(date) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که نیاز به یک تاریخ قبل یا بعد از مقدار داده شده داشته باشد.
require Formula Satisfied(formula) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که الزام کند فرمول داده شده به true ارزیابی شود.
require Number Between(start, end) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که عددی را که بین دو عدد مشخص شده قرار می‌گیرد یا یکی از آنهاست، الزامی کند.
require Number Equal To(number) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که عددی برابر با مقدار داده شده را الزامی کند.
require Number Greater Than(number) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که عددی بزرگتر از مقدار داده شده را الزامی کند.
require Number Greater Than Or Equal To(number) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که عددی بزرگتر یا مساوی مقدار داده شده را الزامی کند.
require Number Less Than(number) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که عددی کمتر از مقدار داده شده را الزامی کند.
require Number Less Than Or Equal To(number) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که عددی کمتر یا مساوی مقدار داده شده را الزامی کند.
require Number Not Between(start, end) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که عددی را الزامی کند که بین دو عدد مشخص شده قرار نگیرد و هیچ‌کدام از آنها نباشد.
require Number Not Equal To(number) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که عددی غیر از مقدار داده شده را الزامی کند.
require Text Contains(text) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که ورودی حتماً باید حاوی مقدار داده شده باشد.
require Text Does Not Contain(text) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که ورودی حاوی مقدار داده شده نباشد.
require Text Equal To(text) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که الزام کند ورودی برابر با مقدار داده شده باشد.
require Text Is Email() Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که ورودی باید به شکل آدرس ایمیل باشد.
require Text Is Url() Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که ورودی باید به شکل URL باشد.
require Value In List(values) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که ورودی باید برابر با یکی از مقادیر داده شده باشد.
require Value In List(values, showDropdown) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که ورودی باید برابر با یکی از مقادیر داده شده باشد، و گزینه‌ای برای پنهان کردن منوی کشویی نیز دارد.
require Value In Range(range) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که ورودی باید برابر با مقداری در محدوده داده شده باشد.
require Value In Range(range, showDropdown) Data Validation Builder قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که ورودی باید برابر با مقداری در محدوده داده شده باشد، و گزینه‌ای برای پنهان کردن منوی کشویی نیز دارد.
set Allow Invalid(allowInvalidData) Data Validation Builder تعیین می‌کند که آیا هنگام عدم موفقیت اعتبارسنجی داده در ورودی، هشداری نمایش داده شود یا اینکه ورودی به طور کامل رد شود.
set Help Text(helpText) Data Validation Builder متن راهنمایی را تنظیم می‌کند که هنگام قرار گرفتن ماوس کاربر روی سلولی که اعتبارسنجی داده‌ها روی آن تنظیم شده است، نمایش داده می‌شود.
with Criteria(criteria, args) Data Validation Builder قانون اعتبارسنجی داده‌ها را بر اساس معیارهای تعریف‌شده توسط مقادیر Data Validation Criteria تنظیم می‌کند، که معمولاً از 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 تعریف شده است، دریافت می‌کند. برای دریافت آرگومان‌های معیار، 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);

پارامترها

نام نوع توضیحات
checked Value 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireCheckbox('APPROVED', 'PENDING')
                 .build();
cell.setDataValidation(rule);

پارامترها

نام نوع توضیحات
checked Value Object مقداری که به یک کادر علامت زده شده اختصاص داده می‌شود.
unchecked Value Object مقداری که به یک کادر علامت زده نشده اختصاص داده می‌شود.

بازگشت

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

پارامترها

نام نوع توضیحات
date Date آخرین تاریخ غیرقابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
date Date زودترین تاریخ غیرقابل قبول.

بازگشت

DataValidationBuilder — این سازنده، برای زنجیره‌سازی

requireDateBetween(start, end)

قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که تاریخی را الزامی کند که بین دو تاریخ مشخص شده یا یکی از آنها باشد. فیلدهای زمان اشیاء 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);

پارامترها

نام نوع توضیحات
start Date زودترین تاریخ قابل قبول.
end Date آخرین تاریخ قابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
date Date تنها تاریخ قابل قبول.

بازگشت

DataValidationBuilder — این سازنده، برای زنجیره‌سازی

requireDateNotBetween(start, end)

قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که تاریخی را الزامی کند که بین دو تاریخ مشخص قرار نگیرد و هیچ‌کدام از آنها نباشد. فیلدهای زمان اشیاء 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);

پارامترها

نام نوع توضیحات
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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

پارامترها

نام نوع توضیحات
date Date زودترین تاریخ قابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
date Date آخرین تاریخ قابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
formula String یک فرمول سفارشی که در صورت معتبر بودن ورودی، مقدار true (true) را ارزیابی می‌کند.

بازگشت

DataValidationBuilder — این سازنده، برای زنجیره‌سازی

requireNumberBetween(start, end)

قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که عددی را که بین دو عدد مشخص شده قرار می‌گیرد یا یکی از آنهاست، الزامی کند. 

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

پارامترها

نام نوع توضیحات
start Number کمترین مقدار قابل قبول.
end Number بالاترین مقدار قابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
number Number تنها مقدار قابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
number Number بالاترین مقدار غیرقابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
number Number کمترین مقدار قابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
number Number کمترین مقدار غیرقابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
number Number بالاترین مقدار قابل قبول.

بازگشت

DataValidationBuilder — این سازنده، برای زنجیره‌سازی

requireNumberNotBetween(start, end)

قانون اعتبارسنجی داده‌ها را طوری تنظیم می‌کند که عددی را الزامی کند که بین دو عدد مشخص شده قرار نگیرد و هیچ‌کدام از آنها نباشد. 

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

پارامترها

نام نوع توضیحات
start Number کمترین مقدار غیرقابل قبول.
end Number بالاترین مقدار غیرقابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
number Number تنها مقدار غیرقابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
text String مقداری که ورودی باید شامل آن باشد.

بازگشت

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

پارامترها

نام نوع توضیحات
text String مقداری که ورودی نباید شامل آن باشد.

بازگشت

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

پارامترها

نام نوع توضیحات
text String تنها مقدار قابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
values String[] مجموعه‌ای از مقادیر قابل قبول.

بازگشت

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

پارامترها

نام نوع توضیحات
values String[] مجموعه‌ای از مقادیر قابل قبول.
show Dropdown Boolean اگر صفحه گسترده باید یک منوی کشویی برای مقادیر نشان دهد، true و در غیر این صورت 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);

پارامترها

نام نوع توضیحات
range Range محدوده‌ای که شامل مقادیر قابل قبول است.

بازگشت

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

پارامترها

نام نوع توضیحات
range Range محدوده‌ای که شامل مقادیر قابل قبول است.
show Dropdown Boolean اگر صفحه گسترده باید یک منوی کشویی برای مقادیر نشان دهد، true و در غیر این صورت false برمی‌گرداند.

بازگشت

DataValidationBuilder — این سازنده، برای زنجیره‌سازی

setAllowInvalid(allowInvalidData)

تنظیم می‌کند که آیا هنگام عدم موفقیت اعتبارسنجی داده در ورودی، هشداری نشان داده شود یا اینکه ورودی به طور کامل رد شود. پیش‌فرض برای قوانین اعتبارسنجی داده جدید، true است.

پارامترها

نام نوع توضیحات
allow Invalid Data Boolean اگر قانون باید ورودی‌هایی را که اعتبارسنجی داده‌ها را رد می‌کنند، مجاز بداند، true و در غیر این صورت false .

بازگشت

DataValidationBuilder — این سازنده، برای زنجیره‌سازی

setHelpText(helpText)

متن راهنمایی را تنظیم می‌کند که هنگام قرار گرفتن ماوس کاربر روی سلولی که اعتبارسنجی داده‌ها روی آن تنظیم شده است، نمایش داده می‌شود.

پارامترها

نام نوع توضیحات
help Text 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.
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);

پارامترها

نام نوع توضیحات
criteria Data Validation Criteria نوع معیارهای اعتبارسنجی داده‌ها.
args Object[] آرایه‌ای از آرگومان‌ها متناسب با نوع معیار؛ تعداد آرگومان‌ها و نوع آنها با متد require...() مربوطه در بالا مطابقت دارد.

بازگشت

DataValidationBuilder — این سازنده، برای زنجیره‌سازی