Enum DataValidationCriteria

DataValidationCriteria

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

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

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

أماكن إقامة

الموقعTypeالوصف
DATE_AFTEREnumيتطلب تاريخًا بعد القيمة المقدمة.
DATE_BEFOREEnumيتطلب تاريخًا يقع قبل القيمة المحددة.
DATE_BETWEENEnumتتطلب تاريخًا يقع بين القيم المحددة.
DATE_EQUAL_TOEnumيتطلب تاريخًا يساوي القيمة المحددة.
DATE_IS_VALID_DATEEnumيجب إدخال تاريخ.
DATE_NOT_BETWEENEnumتتطلب تاريخًا ليس بين القيم المعطاة.
DATE_ON_OR_AFTEREnumيتطلب تاريخًا يقع في أو بعد القيمة المقدمة.
DATE_ON_OR_BEFOREEnumيتطلب تاريخًا يقع في أو قبل القيمة المقدمة.
NUMBER_BETWEENEnumتتطلب عددًا يقع بين القيم المعطاة.
NUMBER_EQUAL_TOEnumيتطلب رقمًا يساوي القيمة المحددة.
NUMBER_GREATER_THANEnumيجب إدخال رقم أكبر من القيمة المقدَّمة.
NUMBER_GREATER_THAN_OR_EQUAL_TOEnumيتطلب رقمًا أكبر من أو يساوي القيمة المحددة.
NUMBER_LESS_THANEnumيجب إدخال رقم أقل من القيمة المقدَّمة.
NUMBER_LESS_THAN_OR_EQUAL_TOEnumيتطلب رقمًا أقل من أو يساوي القيمة المقدمة.
NUMBER_NOT_BETWEENEnumتتطلب رقمًا ليس بين القيم المحددة.
NUMBER_NOT_EQUAL_TOEnumتتطلب رقمًا لا يساوي القيمة المحددة.
TEXT_CONTAINSEnumتتطلب أن يحتوي الإدخال على القيمة المذكورة.
TEXT_DOES_NOT_CONTAINEnumتتطلب ألا يحتوي الإدخال على القيمة المحددة.
TEXT_EQUAL_TOEnumتتطلب أن يكون المدخل مساويًا للقيمة المحددة.
TEXT_IS_VALID_EMAILEnumتتطلب أن يكون الإدخال في شكل عنوان بريد إلكتروني.
TEXT_IS_VALID_URLEnumتتطلب أن يكون الإدخال في شكل عنوان URL.
VALUE_IN_LISTEnumتتطلب أن يكون المدخل مساويًا لإحدى القيم المحددة.
VALUE_IN_RANGEEnumيتطلب أن يكون المدخل مساويًا لقيمة في نطاق معين.
CUSTOM_FORMULAEnumيتطلب الإدخال أن يؤدي الإدخال إلى تقييم الصيغة المحددة إلى true.
CHECKBOXEnumيتطلب أن يكون الإدخال قيمة مخصّصة أو قيمة منطقية، ويتم عرضه في شكل مربّع اختيار.