Diese Seite wurde von der Cloud Translation API übersetzt.

Class DataValidationBuilder

Builder für Datenvalidierungsregeln.

// Set the data validation for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`build()`	`DataValidation`	Erstellt eine Datenvalidierungsregel aus den Einstellungen, die auf den Builder angewendet werden.
`copy()`	`DataValidationBuilder`	Erstellt einen Builder für eine Datenvalidierungsregel auf Basis der Einstellungen dieser Regel.
`getAllowInvalid()`	`Boolean`	Gibt `true` zurück, wenn die Regel eine Warnung anzeigt, wenn die Eingabe die Datenvalidierung fehlschlägt, oder `false`, wenn sie die Eingabe vollständig ablehnt.
`getCriteriaType()`	`DataValidationCriteria`	Ruft den Kriterientyp der Regel entsprechend der Definition in `DataValidationCriteria`-Enum ab.
`getCriteriaValues()`	`Object[]`	Ruft ein Array mit Argumenten für die Kriterien der Regel ab.
`getHelpText()`	`String`	Ruft den Hilfetext der Regel oder `null` ab, wenn kein Hilfetext festgelegt wurde.
`requireCheckbox()`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel erfordert, dass die Eingabe ein boolescher Wert ist. Dieser Wert wird als Kästchen gerendert.
`requireCheckbox(checkedValue)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe der angegebene Wert ist oder leer ist.
`requireCheckbox(checkedValue, uncheckedValue)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel erfordert, dass die Eingabe einer der angegebenen Werte ist.
`requireDate()`	`DataValidationBuilder`	Legt fest, dass für die Datenvalidierungsregel ein Datum erforderlich ist.
`requireDateAfter(date)`	`DataValidationBuilder`	Legt fest, dass in der Datenvalidierungsregel ein Datum nach dem angegebenen Wert erforderlich ist.
`requireDateBefore(date)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel ein Datum vor dem angegebenen Wert erfordert.
`requireDateBetween(start, end)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel ein Datum erfordert, das zwischen zwei angegebenen Daten liegt oder eines dieser Daten ist.
`requireDateEqualTo(date)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel ein Datum erfordert, das dem angegebenen Wert entspricht.
`requireDateNotBetween(start, end)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel ein Datum erfordert, das nicht zwischen zwei angegebenen Datumsangaben liegt und auch nicht dieses ist.
`requireDateOnOrAfter(date)`	`DataValidationBuilder`	Legt fest, dass für die Datenvalidierungsregel ein Datum erforderlich ist, das dem angegebenen Wert entspricht oder danach liegt.
`requireDateOnOrBefore(date)`	`DataValidationBuilder`	Legt fest, dass für die Datenvalidierungsregel ein Datum erforderlich ist, das dem angegebenen Wert entspricht oder davor liegt.
`requireFormulaSatisfied(formula)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die angegebene Formel als `true` ausgewertet werden muss.
`requireNumberBetween(start, end)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die zwischen zwei angegebenen Zahlen liegt oder eine dieser Zahlen ist.
`requireNumberEqualTo(number)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die dem angegebenen Wert entspricht.
`requireNumberGreaterThan(number)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel größer als der angegebene Wert ist.
`requireNumberGreaterThanOrEqualTo(number)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die größer oder gleich dem angegebenen Wert ist.
`requireNumberLessThan(number)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die kleiner als der angegebene Wert ist.
`requireNumberLessThanOrEqualTo(number)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die kleiner oder gleich dem angegebenen Wert ist.
`requireNumberNotBetween(start, end)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass eine Zahl erforderlich ist, die nicht zwischen zwei angegebenen Zahlen liegt und auch nicht zwischen zwei angegeben ist.
`requireNumberNotEqualTo(number)`	`DataValidationBuilder`	Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die nicht dem angegebenen Wert entspricht.
`requireTextContains(text)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe den angegebenen Wert enthält.
`requireTextDoesNotContain(text)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe nicht den angegebenen Wert enthält.
`requireTextEqualTo(text)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe dem angegebenen Wert entsprechen muss.
`requireTextIsEmail()`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe in Form einer E-Mail-Adresse erfolgen muss.
`requireTextIsUrl()`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe in Form einer URL erfolgen muss.
`requireValueInList(values)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe einem der angegebenen Werte entspricht.
`requireValueInList(values, showDropdown)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe einem der angegebenen Werte entspricht, mit einer Option zum Ausblenden des Drop-down-Menüs.
`requireValueInRange(range)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe einem Wert im angegebenen Bereich entspricht.
`requireValueInRange(range, showDropdown)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe einem Wert im angegebenen Bereich entspricht, mit einer Option zum Ausblenden des Drop-down-Menüs.
`setAllowInvalid(allowInvalidData)`	`DataValidationBuilder`	Legt fest, ob eine Warnung angezeigt werden soll, wenn die Datenvalidierung fehlschlägt, oder ob die Eingabe vollständig abgelehnt werden soll.
`setHelpText(helpText)`	`DataValidationBuilder`	Legt den Hilfetext fest, der angezeigt wird, wenn der Nutzer den Mauszeiger auf die Zelle bewegt, für die die Datenvalidierung festgelegt ist.
`withCriteria(criteria, args)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel auf Kriterien fest, die durch `DataValidationCriteria`-Werte definiert sind, die normalerweise aus `criteria` und `arguments` einer vorhandenen Regel übernommen werden.

Detaillierte Dokumentation

`build()`

Erstellt eine Datenvalidierungsregel aus den Einstellungen, die auf den Builder angewendet werden.

Return

DataValidation: Eine Darstellung der Datenvalidierungsregel

`copy()`

Erstellt einen Builder für eine Datenvalidierungsregel auf Basis der Einstellungen dieser Regel.

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var 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);

Return

DataValidationBuilder – ein Builder, der auf den Einstellungen dieser Regel basiert

`getAllowInvalid()`

Gibt true zurück, wenn die Regel eine Warnung anzeigt, wenn die Eingabe die Datenvalidierung fehlschlägt, oder false, wenn sie die Eingabe vollständig ablehnt. Die Standardeinstellung für neue Datenvalidierungsregeln ist true.

Return

Boolean: true, wenn die Regel eine Eingabe zulässt, bei der die Datenvalidierung fehlschlägt; false, wenn dies nicht der Fall ist

`getCriteriaType()`

Ruft den Kriterientyp der Regel entsprechend der Definition in DataValidationCriteria-Enum ab. Verwenden Sie getCriteriaValues(), um die Argumente für die Kriterien abzurufen. Informationen zur Verwendung dieser Werte zum Erstellen oder Ändern einer Datenvalidierungsregel finden Sie unter withCriteria(criteria, args).

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

Return

DataValidationCriteria – der Typ der Datenvalidierungskriterien

`getCriteriaValues()`

Ruft ein Array mit Argumenten für die Kriterien der Regel ab. Verwenden Sie getCriteriaType(), um den Kriterientyp abzurufen. Wie Sie diese Werte verwenden, um eine Datenvalidierungsregel zu erstellen oder zu ändern, erfahren Sie unter withCriteria(criteria, args).

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

Return

Object[]: Ein Array mit Argumenten entsprechend dem Kriterientyp der Regel. Die Anzahl der Argumente und ihr Typ stimmen mit der entsprechenden require...()-Methode der DataValidationBuilder-Klasse überein.

`getHelpText()`

Ruft den Hilfetext der Regel oder null ab, wenn kein Hilfetext festgelegt wurde.

Return

String – der Hilfetext der Regel oder null, wenn kein Hilfetext festgelegt wurde

`requireCheckbox()`

Legt fest, dass die Datenvalidierungsregel erfordert, dass die Eingabe ein boolescher Wert ist. Dieser Wert wird als Kästchen gerendert.

// Set the data validation for cell A1 to require a boolean value; the value is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireCheckbox(checkedValue)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe der angegebene Wert ist oder leer ist. Wenn die Eingabe mit dem angegebenen Wert übereinstimmt, wird die Zelle als aktiviertes Kästchen gerendert. Wenn die Eingabe leer ist, wird die Zelle als deaktiviertes Kästchen gerendert.

// Set the data validation for cell A1 to require a custom checked value that is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`checkedValue`	`Object`	Wert, der einem Kästchen zugewiesen ist

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireCheckbox(checkedValue, uncheckedValue)`

Legt fest, dass die Datenvalidierungsregel erfordert, dass die Eingabe einer der angegebenen Werte ist. Wenn die Eingabe checkedValue ist, wird die Zelle als angeklicktes Kästchen gerendert. Wenn die Eingabe uncheckedValue ist, wird die Zelle als deaktiviertes Kästchen gerendert.

// Set the data validation for cell A1 to require custom checked values that are rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED', 'PENDING').build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`checkedValue`	`Object`	Wert, der einem Kästchen zugewiesen ist
`uncheckedValue`	`Object`	Wert, der einem deaktivierten Kontrollkästchen zugewiesen ist

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireDate()`

Legt fest, dass für die Datenvalidierungsregel ein Datum erforderlich ist.

// Set the data validation for cell A1 to require a date.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDate().build();
cell.setDataValidation(rule);

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireDateAfter(date)`

Legt fest, dass in der Datenvalidierungsregel ein Datum nach dem angegebenen Wert erforderlich ist. Die Zeitfelder des Objekts Date werden ignoriert. Es werden nur die Felder für Tag, Monat und Jahr verwendet.

// Set the data validation for cell A1 to require a date after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das späteste inakzeptable Datum.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireDateBefore(date)`

Legt fest, dass die Datenvalidierungsregel ein Datum vor dem angegebenen Wert erfordert. Die Zeitfelder des Objekts Date werden ignoriert. Es werden nur die Felder für Tag, Monat und Jahr verwendet.

// Set the data validation for cell A1 to require a date before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das früheste inakzeptable Datum.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireDateBetween(start, end)`

Legt fest, dass die Datenvalidierungsregel ein Datum erfordert, das zwischen zwei angegebenen Daten liegt oder eines dieser Daten ist. Die Zeitfelder der Date-Objekte werden ignoriert. Es werden nur die Felder für Tag, Monat und Jahr verwendet.

// Set the data validation for cell A1 to require a date in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`start`	`Date`	Das früheste akzeptable Datum.
`end`	`Date`	Das späteste zulässige Datum.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireDateEqualTo(date)`

Legt fest, dass die Datenvalidierungsregel ein Datum erfordert, das dem angegebenen Wert entspricht. Die Zeitfelder des Date-Objekts werden ignoriert. Es werden nur die Felder für Tag, Monat und Jahr verwendet.

// Set the data validation for cell A1 to require a date equal to January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013'))
    .build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das einzige zulässige Datum.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireDateNotBetween(start, end)`

Legt fest, dass die Datenvalidierungsregel ein Datum erfordert, das nicht zwischen zwei angegebenen Datumsangaben liegt und auch nicht dieses ist. Die Zeitfelder der Date-Objekte werden ignoriert. Es werden nur die Felder für Tag, Monat und Jahr verwendet.

// Set the data validation for cell A1 to require a date not in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`start`	`Date`	Das früheste inakzeptable Datum.
`end`	`Date`	Das späteste inakzeptable Datum.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireDateOnOrAfter(date)`

Legt fest, dass für die Datenvalidierungsregel ein Datum erforderlich ist, das dem angegebenen Wert entspricht oder danach liegt. Die Zeitfelder des Date-Objekts werden ignoriert. Es werden nur die Felder für Tag, Monat und Jahr verwendet.

// Set the data validation for cell A1 to require a date on or after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das früheste akzeptable Datum.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireDateOnOrBefore(date)`

Legt fest, dass für die Datenvalidierungsregel ein Datum erforderlich ist, das dem angegebenen Wert entspricht oder davor liegt. Die Zeitfelder des Date-Objekts werden ignoriert. Es werden nur die Felder für Tag, Monat und Jahr verwendet.

// Set the data validation for cell A1 to require a date on or before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das späteste zulässige Datum.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireFormulaSatisfied(formula)`

Legt die Datenvalidierungsregel so fest, dass die angegebene Formel als true ausgewertet werden muss.

// Set the data validation for cell A1 to equal B1 with a custom formula.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireFormulaSatisfied('=EQ(A1,B1)').build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`formula`	`String`	Eine benutzerdefinierte Formel, die `true` ergibt, wenn die Eingabe gültig ist.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireNumberBetween(start, end)`

Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die zwischen zwei angegebenen Zahlen liegt oder eine dieser Zahlen ist.

// Set the data validation for cell A1 to require a number between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`start`	`Number`	Der niedrigste akzeptable Wert.
`end`	`Number`	Der höchste akzeptable Wert.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireNumberEqualTo(number)`

Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die dem angegebenen Wert entspricht.

// Set the data validation for cell A1 to require a number equal to 3.1415926536.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der einzige zulässige Wert.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireNumberGreaterThan(number)`

Legt fest, dass die Datenvalidierungsregel größer als der angegebene Wert ist.

// Set the data validation for cell A1 to require a number greater than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der höchste inakzeptable Wert.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireNumberGreaterThanOrEqualTo(number)`

Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die größer oder gleich dem angegebenen Wert ist.

// Set the data validation for cell A1 to require a number greater than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der niedrigste akzeptable Wert.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireNumberLessThan(number)`

Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die kleiner als der angegebene Wert ist.

// Set the data validation for cell A1 to require a number less than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der niedrigste inakzeptable Wert.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireNumberLessThanOrEqualTo(number)`

Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die kleiner oder gleich dem angegebenen Wert ist.

// Set the data validation for cell A1 to require a number less than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der höchste akzeptable Wert.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireNumberNotBetween(start, end)`

Legt die Datenvalidierungsregel so fest, dass eine Zahl erforderlich ist, die nicht zwischen zwei angegebenen Zahlen liegt und auch nicht zwischen zwei angegeben ist.

// Set the data validation for cell A1 to require a number not between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`start`	`Number`	Der niedrigste inakzeptable Wert.
`end`	`Number`	Der höchste inakzeptable Wert.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireNumberNotEqualTo(number)`

Legt fest, dass die Datenvalidierungsregel eine Zahl erfordert, die nicht dem angegebenen Wert entspricht.

// Set the data validation for cell A1 to require a number not equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der einzige inakzeptable Wert.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireTextContains(text)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe den angegebenen Wert enthält.

// Set the data validation for cell A1 to require any value that includes "Google".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Der Wert, den die Eingabe enthalten muss.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireTextDoesNotContain(text)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe nicht den angegebenen Wert enthält.

// Set the data validation for cell A1 to require any value that does not include "@".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Der Wert, den die Eingabe nicht enthalten darf.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireTextEqualTo(text)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe dem angegebenen Wert entsprechen muss.

// Set the data validation for cell A1 to require "Yes".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Der einzige zulässige Wert.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireTextIsEmail()`

Legt die Datenvalidierungsregel so fest, dass die Eingabe in Form einer E-Mail-Adresse erfolgen muss.

// Set the data validation for cell A1 to require text in the form of an email address.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireTextIsUrl()`

Legt die Datenvalidierungsregel so fest, dass die Eingabe in Form einer URL erfolgen muss.

// Set the data validation for cell A1 to require text in the form of a URL.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireValueInList(values)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe einem der angegebenen Werte entspricht.

// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`values`	`String[]`	Ein Array zulässiger Werte.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireValueInList(values, showDropdown)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe einem der angegebenen Werte entspricht, mit einer Option zum Ausblenden des Drop-down-Menüs.

// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`values`	`String[]`	Ein Array zulässiger Werte.
`showDropdown`	`Boolean`	`true`, wenn die Tabelle ein Drop-down-Menü für die Werte anzeigen soll; `false`, wenn nicht.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireValueInRange(range)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe einem Wert im angegebenen Bereich entspricht.

// Set the data validation for cell A1 to require a value from B1:B10, with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`range`	`Range`	Ein Bereich, der die zulässigen Werte enthält.

Return

DataValidationBuilder – dieser Builder zum Verketten

`requireValueInRange(range, showDropdown)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe einem Wert im angegebenen Bereich entspricht, mit einer Option zum Ausblenden des Drop-down-Menüs.

// Set the data validation for cell A1 to require value from B1:B10, with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build();
cell.setDataValidation(rule);

Parameter

Name	Typ	Beschreibung
`range`	`Range`	Ein Bereich, der die zulässigen Werte enthält.
`showDropdown`	`Boolean`	`true`, wenn die Tabelle ein Drop-down-Menü für die Werte anzeigen soll; `false`, wenn nicht.

Return

DataValidationBuilder – dieser Builder zum Verketten

`setAllowInvalid(allowInvalidData)`

Legt fest, ob eine Warnung angezeigt werden soll, wenn die Datenvalidierung fehlschlägt, oder ob die Eingabe vollständig abgelehnt werden soll. Die Standardeinstellung für neue Datenvalidierungsregeln ist true.

Parameter

Name	Typ	Beschreibung
`allowInvalidData`	`Boolean`	`true`, wenn die Regel eine Eingabe zulassen soll, bei der die Datenvalidierung fehlschlägt; `false`, wenn nicht.

Return

DataValidationBuilder – dieser Builder zum Verketten

`setHelpText(helpText)`

Legt den Hilfetext fest, der angezeigt wird, wenn der Nutzer den Mauszeiger auf die Zelle bewegt, für die die Datenvalidierung festgelegt ist.

Parameter

Name	Typ	Beschreibung
`helpText`	`String`	Der festzulegende Hilfetext.

Return

DataValidationBuilder – dieser Builder zum Verketten

`withCriteria(criteria, args)`

Legt die Datenvalidierungsregel auf Kriterien fest, die durch DataValidationCriteria-Werte definiert sind, die normalerweise aus criteria und arguments einer vorhandenen Regel übernommen werden.

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var 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);

Parameter

Name	Typ	Beschreibung
`criteria`	`DataValidationCriteria`	Der Typ der Datenvalidierungskriterien.
`args`	`Object[]`	Ein Array mit Argumenten entsprechend dem Kriterientyp. Die Anzahl der Argumente und ihr Typ stimmen mit der entsprechenden `require...()`-Methode oben überein.

Return

DataValidationBuilder – dieser Builder zum Verketten