Diese Seite wurde von der Cloud Translation API übersetzt.

Class DataValidationBuilder

Tool zum Erstellen von Regeln für die Datenvalidierung.

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

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`build()`	`DataValidation`	Erstellt eine Datenvalidierungsregel aus den auf den Builder angewendeten Einstellungen.
`copy()`	`DataValidationBuilder`	Erstellt einen Builder für eine Datenvalidierungsregel basierend auf den Einstellungen dieser Regel.
`getAllowInvalid()`	`Boolean`	Gibt `true` zurück, wenn die Regel eine Warnung anzeigt, wenn die Eingabe die Datenvalidierung nicht besteht, oder `false`, wenn die Eingabe vollständig abgelehnt wird.
`getCriteriaType()`	`DataValidationCriteria`	Ruft den Kriterientyp der Regel ab, wie im `DataValidationCriteria`-Enum definiert.
`getCriteriaValues()`	`Object[]`	Ruft ein Array von Argumenten für die Kriterien der Regel ab.
`getHelpText()`	`String`	Der Hilfetext der Regel oder `null`, wenn kein Hilfetext festgelegt ist.
`requireCheckbox()`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe ein boolescher Wert sein muss. Dieser Wert wird als Kästchen dargestellt.
`requireCheckbox(checkedValue)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe den angegebenen Wert haben oder leer sein muss.
`requireCheckbox(checkedValue, uncheckedValue)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe einen der angegebenen Werte haben muss.
`requireDate()`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist.
`requireDateAfter(date)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass ein Datum nach dem angegebenen Wert erforderlich ist.
`requireDateBefore(date)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass ein Datum vor dem angegebenen Wert erforderlich ist.
`requireDateBetween(start, end)`	`DataValidationBuilder`	Mit dieser Option wird in der Datenvalidierungsregel festgelegt, dass ein Datum zwischen zwei oder einem der beiden angegebenen Datumsangaben liegen muss.
`requireDateEqualTo(date)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist, das dem angegebenen Wert entspricht.
`requireDateNotBetween(start, end)`	`DataValidationBuilder`	Mit dieser Option wird in der Datenvalidierungsregel festgelegt, dass ein Datum erforderlich ist, das nicht zwischen zwei angegebenen Datumsangaben liegt und auch nicht mit diesen übereinstimmt.
`requireDateOnOrAfter(date)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass ein Datum am oder nach dem angegebenen Wert erforderlich ist.
`requireDateOnOrBefore(date)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass ein Datum vor oder am angegebenen Wert erforderlich ist.
`requireFormulaSatisfied(formula)`	`DataValidationBuilder`	Mit dieser Regel wird festgelegt, dass die angegebene Formel zu `true` ausgewertet werden muss.
`requireNumberBetween(start, end)`	`DataValidationBuilder`	Mit dieser Option wird in der Datenvalidierungsregel festgelegt, dass eine Zahl zwischen zwei oder einer der beiden angegebenen Zahlen liegen muss.
`requireNumberEqualTo(number)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass eine Zahl erforderlich ist, die dem angegebenen Wert entspricht.
`requireNumberGreaterThan(number)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass eine Zahl größer als der angegebene Wert erforderlich ist.
`requireNumberGreaterThanOrEqualTo(number)`	`DataValidationBuilder`	Mit dieser Option wird in der Datenvalidierungsregel festgelegt, dass eine Zahl größer oder gleich dem angegebenen Wert sein muss.
`requireNumberLessThan(number)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass eine Zahl kleiner als der angegebene Wert erforderlich ist.
`requireNumberLessThanOrEqualTo(number)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass eine Zahl kleiner oder gleich dem angegebenen Wert erforderlich ist.
`requireNumberNotBetween(start, end)`	`DataValidationBuilder`	Mit dieser Option wird in der Datenvalidierungsregel festgelegt, dass eine Zahl erforderlich ist, die nicht zwischen zwei angegebenen Zahlen liegt und auch keine der beiden ist.
`requireNumberNotEqualTo(number)`	`DataValidationBuilder`	Mit dieser Option wird in der Datenvalidierungsregel festgelegt, dass eine Zahl erforderlich ist, die nicht mit dem angegebenen Wert übereinstimmt.
`requireTextContains(text)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe den angegebenen Wert enthalten muss.
`requireTextDoesNotContain(text)`	`DataValidationBuilder`	Mit dieser Option wird die Datenvalidierungsregel so festgelegt, dass die Eingabe den angegebenen Wert nicht enthalten darf.
`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`	Mit dieser Regel wird festgelegt, dass die Eingabe in Form einer URL erfolgen muss.
`requireValueInList(values)`	`DataValidationBuilder`	Legt die Datenvalidierungsregel so fest, dass die Eingabe einem der angegebenen Werte entsprechen muss.
`requireValueInList(values, showDropdown)`	`DataValidationBuilder`	Die Datenvalidierungsregel wird so festgelegt, dass die Eingabe mit einem der angegebenen Werte übereinstimmen muss. Es gibt auch eine Option, das Drop-down-Menü auszublenden.
`requireValueInRange(range)`	`DataValidationBuilder`	Mit dieser Option wird festgelegt, dass die Datenvalidierungsregel erfordert, dass die Eingabe einem Wert im angegebenen Bereich entspricht.
`requireValueInRange(range, showDropdown)`	`DataValidationBuilder`	Mit dieser Regel wird festgelegt, dass die Eingabe einem Wert im angegebenen Bereich entsprechen muss. Es gibt auch eine Option, mit der das Drop-down-Menü ausgeblendet werden kann.
`setAllowInvalid(allowInvalidData)`	`DataValidationBuilder`	Hiermit wird festgelegt, ob eine Warnung angezeigt werden soll, wenn die Eingabe die Datenvalidierung nicht besteht, oder ob die Eingabe vollständig abgelehnt wird.
`setHelpText(helpText)`	`DataValidationBuilder`	Hiermit wird der Hilfetext festgelegt, der angezeigt wird, wenn der Nutzer den Mauszeiger auf die Zelle bewegt, für die die Datenvalidierung festgelegt ist.
`withCriteria(criteria, args)`	`DataValidationBuilder`	Die Datenvalidierungsregel wird auf Kriterien festgelegt, die durch `DataValidationCriteria`-Werte definiert sind, die in der Regel aus den `criteria`- und `arguments`-Werten einer vorhandenen Regel stammen.

Detaillierte Dokumentation

`build()`

Erstellt eine Datenvalidierungsregel aus den auf den Builder angewendeten Einstellungen.

Rückflug

DataValidation – eine Darstellung der Datenvalidierungsregel

`copy()`

Erstellt einen Builder für eine Datenvalidierungsregel basierend auf den Einstellungen dieser Regel.

// 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);

Rückflug

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 nicht besteht, oder false, wenn die Eingabe vollständig abgelehnt wird. Die Standardeinstellung für neue Regeln zur Datenvalidierung ist true.

Rückflug

Boolean – true, wenn die Regel Eingaben zulässt, die die Datenvalidierung nicht bestehen; false, wenn nicht

`getCriteriaType()`

Ruft den Kriterientyp der Regel ab, wie im DataValidationCriteria-Enum definiert. Verwenden Sie getCriteriaValues(), um die Argumente für die Kriterien abzurufen. withCriteria(criteria, args)

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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.');
}

Rückflug

DataValidationCriteria – die Art der Datenvalidierungskriterien

`getCriteriaValues()`

Ruft ein Array von 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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.');
}

Rückflug

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

`getHelpText()`

Der Hilfetext der Regel oder null, wenn kein Hilfetext festgelegt ist.

Rückflug

String: Der Hilfetext der Regel oder null, wenn kein Hilfetext festgelegt ist

`requireCheckbox()`

Legt die Datenvalidierungsregel so fest, dass die Eingabe ein boolescher Wert sein muss. Dieser Wert wird als Kästchen dargestellt.

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireCheckbox(checkedValue)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe den angegebenen Wert haben oder leer sein muss. Wenn die Eingabe mit dem angegebenen Wert übereinstimmt, wird die Zelle als angeklicktes Kästchen dargestellt. Wenn die Eingabe leer ist, wird die Zelle als Kästchen ohne Häkchen dargestellt.

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

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireCheckbox(checkedValue, uncheckedValue)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe einen der angegebenen Werte haben muss. Wenn die Eingabe checkedValue ist, wird die Zelle als angeklicktes Kästchen gerendert. Wenn die Eingabe uncheckedValue ist, wird die Zelle als Kästchen ohne Häkchen dargestellt.

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

Parameter

Name	Typ	Beschreibung
`checkedValue`	`Object`	Der Wert, der einem angeklickten Kästchen zugewiesen ist.
`uncheckedValue`	`Object`	Der Wert, der einem nicht angeklickten Kästchen zugewiesen ist.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireDate()`

Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist.

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireDateAfter(date)`

Legt die Datenvalidierungsregel so fest, dass ein Datum nach dem angegebenen Wert erforderlich ist. Die Uhrzeitfelder des Date-Objekts werden ignoriert. Es werden nur die Felder „Tag“, „Monat“ und „Jahr“ verwendet.

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

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das Datum, das nicht überschritten werden darf.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireDateBefore(date)`

Legt die Datenvalidierungsregel so fest, dass ein Datum vor dem angegebenen Wert erforderlich ist. Die Uhrzeitfelder des Date-Objekts werden ignoriert. Es werden nur die Felder „Tag“, „Monat“ und „Jahr“ verwendet.

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

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das früheste unzulässige Datum.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireDateBetween(start, end)`

Mit dieser Option wird in der Datenvalidierungsregel festgelegt, dass ein Datum zwischen zwei oder einem der beiden angegebenen Datumsangaben liegen muss. Die Uhrzeitfelder der Date-Objekte werden ignoriert. Es werden nur die Felder „Tag“, „Monat“ und „Jahr“ verwendet.

// Set the data validation for cell A1 to require a date in 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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 zulässige Datum.
`end`	`Date`	Das späteste zulässige Datum.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireDateEqualTo(date)`

Legt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist, das dem angegebenen Wert entspricht. Die Uhrzeitfelder des Date-Objekts werden ignoriert. Es werden nur die Felder „Tag“, „Monat“ und „Jahr“ verwendet.

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

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireDateNotBetween(start, end)`

Mit dieser Option wird in der Datenvalidierungsregel festgelegt, dass ein Datum erforderlich ist, das nicht zwischen zwei angegebenen Datumsangaben liegt und auch nicht mit diesen übereinstimmt. Die Uhrzeitfelder der Date-Objekte werden ignoriert. Es werden nur die Felder „Tag“, „Monat“ und „Jahr“ verwendet.

// Set the data validation for cell A1 to require a date not in 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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 unzulässige Datum.
`end`	`Date`	Das Datum, das nicht überschritten werden darf.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireDateOnOrAfter(date)`

Legt die Datenvalidierungsregel so fest, dass ein Datum am oder nach dem angegebenen Wert erforderlich ist. Die Uhrzeitfelder des Date-Objekts werden ignoriert. Es werden nur die Felder „Tag“, „Monat“ und „Jahr“ verwendet.

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

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das früheste zulässige Datum.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireDateOnOrBefore(date)`

Legt die Datenvalidierungsregel so fest, dass ein Datum vor oder am angegebenen Wert erforderlich ist. Die Uhrzeitfelder des Date-Objekts werden ignoriert. Es werden nur die Felder „Tag“, „Monat“ und „Jahr“ verwendet.

// Set the data validation for cell A1 to require a date on or before January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireFormulaSatisfied(formula)`

Mit dieser Regel wird festgelegt, dass die angegebene Formel zu true ausgewertet werden muss.

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

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireNumberBetween(start, end)`

Mit dieser Option wird in der Datenvalidierungsregel festgelegt, dass eine Zahl zwischen zwei oder einer der beiden angegebenen Zahlen liegen muss.

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

Parameter

Name	Typ	Beschreibung
`start`	`Number`	Der niedrigste zulässige Wert.
`end`	`Number`	Der höchste zulässige Wert.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireNumberEqualTo(number)`

Legt die Datenvalidierungsregel so fest, dass eine Zahl erforderlich ist, die dem angegebenen Wert entspricht.

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

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireNumberGreaterThan(number)`

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

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

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der höchste unzulässige Wert.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireNumberGreaterThanOrEqualTo(number)`

Mit dieser Option wird in der Datenvalidierungsregel festgelegt, dass eine Zahl größer oder gleich dem angegebenen Wert sein muss.

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

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireNumberLessThan(number)`

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

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

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireNumberLessThanOrEqualTo(number)`

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

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

Parameter

Name	Typ	Beschreibung
`number`	`Number`	Der höchste zulässige Wert.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireNumberNotBetween(start, end)`

Mit dieser Option wird in der Datenvalidierungsregel festgelegt, dass eine Zahl erforderlich ist, die nicht zwischen zwei angegebenen Zahlen liegt und auch keine der beiden ist.

// Set the data validation for cell A1 to require a number not between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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 unzulässige Wert.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireNumberNotEqualTo(number)`

Mit dieser Option wird in der Datenvalidierungsregel festgelegt, dass eine Zahl erforderlich ist, die nicht mit dem angegebenen Wert übereinstimmt.

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

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireTextContains(text)`

Legt die Datenvalidierungsregel so fest, dass die Eingabe den angegebenen Wert enthalten muss.

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

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireTextDoesNotContain(text)`

Mit dieser Option wird die Datenvalidierungsregel so festgelegt, dass die Eingabe den angegebenen Wert nicht enthalten darf.

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

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`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".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireTextIsUrl()`

Mit dieser Regel wird festgelegt, 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireValueInList(values)`

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

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

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireValueInList(values, showDropdown)`

Die Datenvalidierungsregel wird so festgelegt, dass die Eingabe mit einem der angegebenen Werte übereinstimmen muss. Es gibt auch eine Option, das Drop-down-Menü auszublenden.

// Set the data validation for cell A1 to require "Yes" or "No", with no
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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 in der Tabelle ein Drop-down-Menü für die Werte angezeigt werden soll, `false` andernfalls.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireValueInRange(range)`

Mit dieser Option wird festgelegt, dass die Datenvalidierungsregel erfordert, 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`requireValueInRange(range, showDropdown)`

Mit dieser Regel wird festgelegt, dass die Eingabe einem Wert im angegebenen Bereich entsprechen muss. Es gibt auch eine Option, mit der das Drop-down-Menü ausgeblendet werden kann.

// Set the data validation for cell A1 to require value from B1:B10, with no
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const 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 in der Tabelle ein Drop-down-Menü für die Werte angezeigt werden soll, `false` andernfalls.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`setAllowInvalid(allowInvalidData)`

Hiermit wird festgelegt, ob eine Warnung angezeigt werden soll, wenn die Eingabe die Datenvalidierung nicht besteht, oder ob die Eingabe vollständig abgelehnt wird. Die Standardeinstellung für neue Regeln zur Datenvalidierung ist true.

Parameter

Name	Typ	Beschreibung
`allowInvalidData`	`Boolean`	`true`, wenn die Regel Eingaben zulassen soll, die die Datenvalidierung nicht bestehen, `false` andernfalls.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`setHelpText(helpText)`

Hiermit wird der Hilfetext festgelegt, 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 Hilfetext, der festgelegt werden soll.

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung

`withCriteria(criteria, args)`

Die Datenvalidierungsregel wird auf Kriterien festgelegt, die durch DataValidationCriteria-Werte definiert sind, die in der Regel aus den criteria- und arguments-Werten einer vorhandenen Regel stammen.

// 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);

Parameter

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

Rückflug

DataValidationBuilder – dieser Builder, zur Verkettung