Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
KriterienfürdieDatenvalidierung
Eine Aufzählung, die die Kriterien für die Datenvalidierung darstellt, die für einen Bereich festgelegt werden können.
Um ein Enum aufzurufen, rufen Sie die übergeordnete Klasse, den Namen und die Eigenschaft auf. Beispiel:
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);
Attribute
Attribut
Typ
Beschreibung
DATE_AFTER
Enum
Erfordert ein Datum, das nach dem angegebenen Wert liegt.
DATE_BEFORE
Enum
Erfordert ein Datum, das vor dem angegebenen Wert liegt.
DATE_BETWEEN
Enum
Erfordert ein Datum zwischen den angegebenen Werten.
DATE_EQUAL_TO
Enum
Erfordert ein Datum, das dem angegebenen Wert entspricht.
DATE_IS_VALID_DATE
Enum
Erfordert ein Datum.
DATE_NOT_BETWEEN
Enum
Erfordert ein Datum, das nicht zwischen den angegebenen Werten liegt.
DATE_ON_OR_AFTER
Enum
Ein Datum, das dem angegebenen Wert entspricht oder danach liegt.
DATE_ON_OR_BEFORE
Enum
Erfordert ein Datum, das am oder vor dem angegebenen Wert liegt.
NUMBER_BETWEEN
Enum
Erfordert eine Zahl zwischen den angegebenen Werten.
NUMBER_EQUAL_TO
Enum
Erfordert eine Zahl, die dem angegebenen Wert entspricht.
NUMBER_GREATER_THAN
Enum
Erfordert eine Zahl, die größer als der angegebene Wert ist.
NUMBER_GREATER_THAN_OR_EQUAL_TO
Enum
Erfordert eine Zahl, die größer oder gleich dem angegebenen Wert ist.
NUMBER_LESS_THAN
Enum
Erfordert eine Zahl, die kleiner als der angegebene Wert ist.
NUMBER_LESS_THAN_OR_EQUAL_TO
Enum
Erfordert eine Zahl, die kleiner oder gleich dem angegebenen Wert ist.
NUMBER_NOT_BETWEEN
Enum
Erfordert eine Zahl, die nicht zwischen den angegebenen Werten liegt.
NUMBER_NOT_EQUAL_TO
Enum
Geben Sie eine Zahl ein, die nicht gleich dem angegebenen Wert ist.
TEXT_CONTAINS
Enum
Erfordert, dass die Eingabe den angegebenen Wert enthält.
TEXT_DOES_NOT_CONTAIN
Enum
Gibt an, dass die Eingabe den angegebenen Wert nicht enthalten darf.
TEXT_EQUAL_TO
Enum
Erfordert, dass die Eingabe dem angegebenen Wert entspricht.
TEXT_IS_VALID_EMAIL
Enum
Die Eingabe muss in Form einer E‑Mail-Adresse erfolgen.
TEXT_IS_VALID_URL
Enum
Die Eingabe muss in Form einer URL erfolgen.
VALUE_IN_LIST
Enum
Erfordert, dass die Eingabe einem der angegebenen Werte entspricht.
VALUE_IN_RANGE
Enum
Erfordert, dass die Eingabe einem Wert im angegebenen Bereich entspricht.
CUSTOM_FORMULA
Enum
Erfordert, dass die Eingabe dazu führt, dass die angegebene Formel zu true ausgewertet wird.
CHECKBOX
Enum
Erfordert, dass die Eingabe ein benutzerdefinierter Wert oder ein boolescher Wert ist. Wird als Checkbox gerendert.
DATE_AFTER_RELATIVE
Enum
Erfordert ein Datum, das nach dem relativen Datumswert liegt.
DATE_BEFORE_RELATIVE
Enum
Das Datum muss vor dem relativen Datumswert liegen.
DATE_EQUAL_TO_RELATIVE
Enum
Erfordert ein Datum, das dem relativen Datumswert entspricht.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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. |"]]