Enum DataValidationCriteria
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
เกณฑ์การตรวจสอบข้อมูล
การแจงนับที่แสดงเกณฑ์การตรวจสอบข้อมูลที่ตั้งค่าได้ในช่วง
หากต้องการเรียกใช้ Enum ให้เรียกใช้คลาสหลัก ชื่อ และพร็อพเพอร์ตี้ของ Enum เช่น
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 | ต้องมีวันที่ที่เท่ากับค่าวันที่แบบสัมพัทธ์ |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-04 UTC
[null,null,["อัปเดตล่าสุด 2025-08-04 UTC"],[[["\u003cp\u003e\u003ccode\u003eDataValidationCriteria\u003c/code\u003e is an enumeration used to define data validation rules for cell ranges in Google Sheets.\u003c/p\u003e\n"],["\u003cp\u003eIt provides various criteria like \u003ccode\u003eDATE_BETWEEN\u003c/code\u003e, \u003ccode\u003eNUMBER_GREATER_THAN\u003c/code\u003e, \u003ccode\u003eTEXT_CONTAINS\u003c/code\u003e, and more to enforce data integrity.\u003c/p\u003e\n"],["\u003cp\u003eTo use a specific criterion, you refer to it through \u003ccode\u003eSpreadsheetApp.DataValidationCriteria\u003c/code\u003e followed by the specific property, for instance, \u003ccode\u003eSpreadsheetApp.DataValidationCriteria.DATE_IS_VALID_DATE\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe provided code example demonstrates how to modify existing data validation rules that require a date within a certain range.\u003c/p\u003e\n"]]],["`DataValidationCriteria` defines the types of data validation rules applicable to a spreadsheet range. You can retrieve or modify existing rules on a range, to change the validation criteria. For example, you can update all DATE_BETWEEN rules from a date range in 2013 to a new date range in 2014, by copying and modifying the existing rule, or set new validation criteria on a range to ensure certain data types, including dates, numbers, or text, fit within specified parameters.\n"],null,["# Enum DataValidationCriteria\n\nDataValidationCriteria\n\nAn enumeration representing the data validation criteria that can be set on a range.\n\nTo call an enum, you call its parent class, name, and property. For example, `\nSpreadsheetApp.DataValidationCriteria.DATE_IS_VALID_DATE`.\n\n```javascript\n// Change existing data-validation rules that require a date in 2013 to require\n// a date in 2014.\nconst oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];\nconst newDates = [new Date('1/1/2014'), new Date('12/31/2014')];\nconst sheet = SpreadsheetApp.getActiveSheet();\nconst range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());\nconst rules = range.getDataValidations();\n\nfor (let i = 0; i \u003c rules.length; i++) {\n for (let j = 0; j \u003c rules[i].length; j++) {\n const rule = rules[i][j];\n\n if (rule != null) {\n const criteria = rule.getCriteriaType();\n const args = rule.getCriteriaValues();\n\n if (criteria === SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN &&\n args[0].getTime() === oldDates[0].getTime() &&\n args[1].getTime() === oldDates[1].getTime()) {\n // Create a builder from the existing rule, then change the dates.\n rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();\n }\n }\n }\n}\nrange.setDataValidations(rules);\n``` \n\n### Properties\n\n| Property | Type | Description |\n|-----------------------------------|--------|---------------------------------------------------------------------------------|\n| `DATE_AFTER` | `Enum` | Requires a date that is after the given value. |\n| `DATE_BEFORE` | `Enum` | Requires a date that is before the given value. |\n| `DATE_BETWEEN` | `Enum` | Requires a date that is between the given values. |\n| `DATE_EQUAL_TO` | `Enum` | Requires a date that is equal to the given value. |\n| `DATE_IS_VALID_DATE` | `Enum` | Requires a date. |\n| `DATE_NOT_BETWEEN` | `Enum` | Requires a date that is not between the given values. |\n| `DATE_ON_OR_AFTER` | `Enum` | Require a date that is on or after the given value. |\n| `DATE_ON_OR_BEFORE` | `Enum` | Requires a date that is on or before the given value. |\n| `NUMBER_BETWEEN` | `Enum` | Requires a number that is between the given values. |\n| `NUMBER_EQUAL_TO` | `Enum` | Requires a number that is equal to the given value. |\n| `NUMBER_GREATER_THAN` | `Enum` | Require a number that is greater than the given value. |\n| `NUMBER_GREATER_THAN_OR_EQUAL_TO` | `Enum` | Requires a number that is greater than or equal to the given value. |\n| `NUMBER_LESS_THAN` | `Enum` | Requires a number that is less than the given value. |\n| `NUMBER_LESS_THAN_OR_EQUAL_TO` | `Enum` | Requires a number that is less than or equal to the given value. |\n| `NUMBER_NOT_BETWEEN` | `Enum` | Requires a number that is not between the given values. |\n| `NUMBER_NOT_EQUAL_TO` | `Enum` | Requires a number that is not equal to the given value. |\n| `TEXT_CONTAINS` | `Enum` | Requires that the input contains the given value. |\n| `TEXT_DOES_NOT_CONTAIN` | `Enum` | Requires that the input does not contain the given value. |\n| `TEXT_EQUAL_TO` | `Enum` | Requires that the input is equal to the given value. |\n| `TEXT_IS_VALID_EMAIL` | `Enum` | Requires that the input is in the form of an email address. |\n| `TEXT_IS_VALID_URL` | `Enum` | Requires that the input is in the form of a URL. |\n| `VALUE_IN_LIST` | `Enum` | Requires that the input is equal to one of the given values. |\n| `VALUE_IN_RANGE` | `Enum` | Requires that the input is equal to a value in the given range. |\n| `CUSTOM_FORMULA` | `Enum` | Requires that the input makes the given formula evaluate to `true`. |\n| `CHECKBOX` | `Enum` | Requires that the input is a custom value or a boolean; rendered as a checkbox. |\n| `DATE_AFTER_RELATIVE` | `Enum` | Requires a date that is after the relative date value. |\n| `DATE_BEFORE_RELATIVE` | `Enum` | Requires a date that is before the relative date value. |\n| `DATE_EQUAL_TO_RELATIVE` | `Enum` | Requires a date that is equal to the relative date value. |"]]