Enum DataValidationCriteria

معاييرالتحقّقمنالبيانات

تعداد يمثّل معايير التحقّق من صحة البيانات التي يمكن ضبطها على نطاق.

لاستدعاء تعداد، عليك استدعاء الفئة الرئيسية والاسم والخاصية. مثلاً: SpreadsheetApp.DataValidationCriteria.DATE_IS_VALID_DATE

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

الخصائص

الموقع	النوع	الوصف
DATE_AFTER	Enum	يتطلّب تاريخًا لاحقًا للقيمة المحدّدة.
DATE_BEFORE	Enum	تتطلّب تاريخًا يسبق القيمة المحدّدة.
DATE_BETWEEN	Enum	يتطلّب تاريخًا يقع بين القيم المحدّدة.
DATE_EQUAL_TO	Enum	يتطلّب تاريخًا يساوي القيمة المحدّدة.
DATE_IS_VALID_DATE	Enum	يجب إدخال تاريخ.
DATE_NOT_BETWEEN	Enum	تتطلّب تاريخًا ليس بين القيم المحدّدة.
DATE_ON_OR_AFTER	Enum	يجب إدخال تاريخ يوافق القيمة المحدّدة أو يقع بعدها.
DATE_ON_OR_BEFORE	Enum	تتطلّب تاريخًا يقع في أو قبل القيمة المحدّدة.
NUMBER_BETWEEN	Enum	تتطلّب رقمًا يتراوح بين القيم المحدّدة.
NUMBER_EQUAL_TO	Enum	يجب إدخال رقم يساوي القيمة المحدّدة.
NUMBER_GREATER_THAN	Enum	تتطلّب رقمًا أكبر من القيمة المحدّدة.
NUMBER_GREATER_THAN_OR_EQUAL_TO	Enum	يتطلّب رقمًا أكبر من القيمة المحدّدة أو مساويًا لها.
NUMBER_LESS_THAN	Enum	تتطلّب رقمًا أقل من القيمة المحدّدة.
NUMBER_LESS_THAN_OR_EQUAL_TO	Enum	يتطلّب رقمًا أقل من القيمة المحدّدة أو يساويها.
NUMBER_NOT_BETWEEN	Enum	يتطلّب رقمًا ليس بين القيم المحدّدة.
NUMBER_NOT_EQUAL_TO	Enum	يجب إدخال رقم لا يساوي القيمة المحدّدة.
TEXT_CONTAINS	Enum	يجب أن يحتوي الإدخال على القيمة المحدّدة.
TEXT_DOES_NOT_CONTAIN	Enum	يجب ألا يحتوي الإدخال على القيمة المحدّدة.
TEXT_EQUAL_TO	Enum	يجب أن تكون القيمة المُدخَلة مساوية للقيمة المحدّدة.
TEXT_IS_VALID_EMAIL	Enum	يجب أن يكون الإدخال على شكل عنوان بريد إلكتروني.
TEXT_IS_VALID_URL	Enum	يجب أن يكون الإدخال على شكل عنوان URL.
VALUE_IN_LIST	Enum	تتطلّب أن يكون الإدخال مساويًا لإحدى القيم المحدّدة.
VALUE_IN_RANGE	Enum	يجب أن تكون القيمة المُدخَلة مساوية لقيمة في النطاق المحدّد.
CUSTOM_FORMULA	Enum	يجب أن يؤدي الإدخال إلى تقييم الصيغة المحدّدة إلى true.
CHECKBOX	Enum	يتطلّب أن يكون الإدخال قيمة مخصّصة أو قيمة منطقية، ويتم عرضه كمربّع اختيار.
DATE_AFTER_RELATIVE	Enum	يجب إدخال تاريخ لاحق لقيمة التاريخ النسبي.
DATE_BEFORE_RELATIVE	Enum	تتطلّب تاريخًا يسبق قيمة التاريخ النسبي.
DATE_EQUAL_TO_RELATIVE	Enum	يتطلّب تاريخًا يساوي قيمة التاريخ النسبي.