Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Kryteriaweryfikacjidanych
Wyliczenie reprezentujące kryteria sprawdzania poprawności danych, które można ustawić w zakresie.
Aby wywołać wyliczenie, wywołaj jego klasę nadrzędną, nazwę i właściwość. Na przykład:
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);
Właściwości
Właściwość
Typ
Opis
DATE_AFTER
Enum
Wymaga daty późniejszej niż podana wartość.
DATE_BEFORE
Enum
Wymagana jest data wcześniejsza niż podana wartość.
DATE_BETWEEN
Enum
Wymaga daty z podanego zakresu.
DATE_EQUAL_TO
Enum
Wymaga daty równej podanej wartości.
DATE_IS_VALID_DATE
Enum
Wymagana jest data.
DATE_NOT_BETWEEN
Enum
Wymaga daty spoza podanego zakresu.
DATE_ON_OR_AFTER
Enum
Wymagaj daty, która jest taka sama jak podana wartość lub późniejsza.
DATE_ON_OR_BEFORE
Enum
Wymaga daty, która przypada w danym dniu lub przed nim.
NUMBER_BETWEEN
Enum
Wymaga podania liczby z określonego zakresu.
NUMBER_EQUAL_TO
Enum
Wymaga liczby równej podanej wartości.
NUMBER_GREATER_THAN
Enum
Wymaga liczby większej od podanej wartości.
NUMBER_GREATER_THAN_OR_EQUAL_TO
Enum
Wymaga liczby większej lub równej podanej wartości.
NUMBER_LESS_THAN
Enum
Wymaga podania liczby mniejszej od podanej wartości.
NUMBER_LESS_THAN_OR_EQUAL_TO
Enum
Wymaga liczby, która jest mniejsza lub równa podanej wartości.
NUMBER_NOT_BETWEEN
Enum
Wymaga podania liczby spoza podanego zakresu.
NUMBER_NOT_EQUAL_TO
Enum
Wymaga liczby, która nie jest równa podanej wartości.
TEXT_CONTAINS
Enum
Wymaga, aby dane wejściowe zawierały podaną wartość.
TEXT_DOES_NOT_CONTAIN
Enum
Wymaga, aby dane wejściowe nie zawierały podanej wartości.
TEXT_EQUAL_TO
Enum
Wymaga, aby dane wejściowe były równe podanej wartości.
TEXT_IS_VALID_EMAIL
Enum
Wymaga, aby dane wejściowe były adresem e-mail.
TEXT_IS_VALID_URL
Enum
Wymaga, aby dane wejściowe miały postać adresu URL.
VALUE_IN_LIST
Enum
Wymaga, aby dane wejściowe były równe jednej z podanych wartości.
VALUE_IN_RANGE
Enum
Wymaga, aby dane wejściowe były równe wartości w podanym zakresie.
CUSTOM_FORMULA
Enum
Wymaga, aby dane wejściowe powodowały, że podana formuła zwraca wartość true.
CHECKBOX
Enum
Wymaga, aby dane wejściowe były wartością niestandardową lub logiczną; renderowane jako pole wyboru.
DATE_AFTER_RELATIVE
Enum
Wymaga daty późniejszej niż względna wartość daty.
DATE_BEFORE_RELATIVE
Enum
Wymagana jest data wcześniejsza niż wartość daty względnej.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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. |"]]