Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tiêu chíxác thựcdữ liệu
Một kiểu liệt kê đại diện cho tiêu chí xác thực dữ liệu có thể được đặt trên một dải ô.
Để gọi một enum, bạn gọi lớp mẹ, tên và thuộc tính của enum đó. Ví dụ: SpreadsheetApp.DataValidationCriteria.DATE_IS_VALID_DATE.
// Change existing data-validation rules that require a date in 2013 to require// a date in 2014.constoldDates=[newDate('1/1/2013'),newDate('12/31/2013')];constnewDates=[newDate('1/1/2014'),newDate('12/31/2014')];constsheet=SpreadsheetApp.getActiveSheet();constrange=sheet.getRange(1,1,sheet.getMaxRows(),sheet.getMaxColumns());construles=range.getDataValidations();for(leti=0;i < rules.length;i++){for(letj=0;j < rules[i].length;j++){construle=rules[i][j];if(rule!=null){constcriteria=rule.getCriteriaType();constargs=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);
Thuộc tính
Thuộc tính
Loại
Mô tả
DATE_AFTER
Enum
Yêu cầu một ngày sau giá trị đã cho.
DATE_BEFORE
Enum
Yêu cầu một ngày trước giá trị đã cho.
DATE_BETWEEN
Enum
Yêu cầu một ngày nằm trong khoảng giữa các giá trị đã cho.
DATE_EQUAL_TO
Enum
Yêu cầu một ngày bằng với giá trị đã cho.
DATE_IS_VALID_DATE
Enum
Bạn phải nhập ngày.
DATE_NOT_BETWEEN
Enum
Yêu cầu một ngày nằm ngoài phạm vi giữa các giá trị đã cho.
DATE_ON_OR_AFTER
Enum
Yêu cầu một ngày trùng hoặc sau giá trị đã cho.
DATE_ON_OR_BEFORE
Enum
Yêu cầu một ngày trùng hoặc trước giá trị đã cho.
NUMBER_BETWEEN
Enum
Yêu cầu một số nằm trong khoảng giữa các giá trị đã cho.
NUMBER_EQUAL_TO
Enum
Yêu cầu một số bằng với giá trị đã cho.
NUMBER_GREATER_THAN
Enum
Yêu cầu một số lớn hơn giá trị đã cho.
NUMBER_GREATER_THAN_OR_EQUAL_TO
Enum
Yêu cầu một số lớn hơn hoặc bằng giá trị đã cho.
NUMBER_LESS_THAN
Enum
Yêu cầu một số nhỏ hơn giá trị đã cho.
NUMBER_LESS_THAN_OR_EQUAL_TO
Enum
Yêu cầu một số nhỏ hơn hoặc bằng giá trị đã cho.
NUMBER_NOT_BETWEEN
Enum
Yêu cầu một số không nằm trong khoảng giữa các giá trị đã cho.
NUMBER_NOT_EQUAL_TO
Enum
Yêu cầu một số không bằng giá trị đã cho.
TEXT_CONTAINS
Enum
Yêu cầu đầu vào chứa giá trị đã cho.
TEXT_DOES_NOT_CONTAIN
Enum
Yêu cầu đầu vào không chứa giá trị đã cho.
TEXT_EQUAL_TO
Enum
Yêu cầu đầu vào phải bằng với giá trị đã cho.
TEXT_IS_VALID_EMAIL
Enum
Yêu cầu dữ liệu đầu vào phải ở dạng địa chỉ email.
TEXT_IS_VALID_URL
Enum
Yêu cầu dữ liệu đầu vào phải ở dạng URL.
VALUE_IN_LIST
Enum
Yêu cầu đầu vào phải bằng một trong các giá trị đã cho.
VALUE_IN_RANGE
Enum
Yêu cầu dữ liệu đầu vào phải bằng một giá trị trong dải ô đã cho.
CUSTOM_FORMULA
Enum
Yêu cầu đầu vào làm cho công thức đã cho đánh giá thành true.
CHECKBOX
Enum
Yêu cầu dữ liệu đầu vào là một giá trị tuỳ chỉnh hoặc một giá trị boolean; được hiển thị dưới dạng hộp đánh dấu.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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. |"]]