تعداد يمثّل معايير التحقّق من صحة البيانات التي يمكن ضبطها على نطاق.
لاستدعاء تعداد، عليك استدعاء الفئة الرئيسية والاسم والخاصية. مثلاً:
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 | يتطلّب تاريخًا يساوي قيمة التاريخ النسبي. |