Class DataValidationBuilder

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

MethodeRückgabetypKurzbeschreibung
build()DataValidationErstellt eine Datenvalidierungsregel aus den auf das Builder-Objekt angewendeten Einstellungen.
copy()DataValidationBuilderErstellt ein Builder-Objekt für eine Datenvalidierungsregel basierend auf den Einstellungen dieser Regel.
getAllowInvalid()BooleanGibt true zurück, wenn für die Regel eine Warnung angezeigt wird, wenn die Eingabe die Datenvalidierung nicht besteht, oder false, wenn die Eingabe vollständig abgelehnt wird.
getCriteriaType()DataValidationCriteriaRuft den Kriterientyp der Regel ab, wie in der DataValidationCriteria-Enumeration definiert.
getCriteriaValues()Object[]Ruft ein Array von Argumenten für die Kriterien der Regel ab.
getHelpText()StringRuft den Hilfetext der Regel ab oder null, wenn kein Hilfetext festgelegt ist.
requireCheckbox()DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass die Eingabe ein boolescher Wert sein muss. Dieser Wert wird als Kästchen gerendert.
requireCheckbox(checkedValue)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass die Eingabe der angegebene Wert oder leer sein muss.
requireCheckbox(checkedValue, uncheckedValue)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass die Eingabe einer der angegebenen Werte sein muss.
requireDate()DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist.
requireDateAfter(date)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass ein Datum nach dem angegebenen Wert erforderlich ist.
requireDateBefore(date)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass ein Datum vor dem angegebenen Wert erforderlich ist.
requireDateBetween(start, end)DataValidationBuilderLegt die Regel zur Datenvalidierung so fest, dass ein Datum erforderlich ist, das zwischen zwei angegebenen Datumsangaben liegt oder mit einer der beiden übereinstimmt.
requireDateEqualTo(date)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass ein Datum erforderlich ist, das dem angegebenen Wert entspricht.
requireDateNotBetween(start, end)DataValidationBuilderLegt die Daten-Validierungsregel so fest, dass ein Datum erforderlich ist, das nicht zwischen zwei angegebenen Datumsangaben liegt und auch nicht mit einer der beiden übereinstimmt.
requireDateOnOrAfter(date)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass ein Datum ab dem angegebenen Wert erforderlich ist.
requireDateOnOrBefore(date)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass ein Datum vor oder gleich dem angegebenen Wert erforderlich ist.
requireFormulaSatisfied(formula)DataValidationBuilderLegt die Regel zur Datenvalidierung so fest, dass die angegebene Formel zu true ausgewertet werden muss.
requireNumberBetween(start, end)DataValidationBuilderLegt die Regel zur Datenvalidierung so fest, dass eine Zahl erforderlich ist, die zwischen zwei angegebenen Zahlen liegt oder eine der beiden Zahlen ist.
requireNumberEqualTo(number)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass eine Zahl erforderlich ist, die dem angegebenen Wert entspricht.
requireNumberGreaterThan(number)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass eine Zahl erforderlich ist, die größer als der angegebene Wert ist.
requireNumberGreaterThanOrEqualTo(number)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass eine Zahl größer oder gleich dem angegebenen Wert erforderlich ist.
requireNumberLessThan(number)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass eine Zahl kleiner als der angegebene Wert erforderlich ist.
requireNumberLessThanOrEqualTo(number)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass eine Zahl kleiner oder gleich dem angegebenen Wert erforderlich ist.
requireNumberNotBetween(start, end)DataValidationBuilderLegt fest, dass für die Datenvalidierungsregel eine Zahl erforderlich ist, die nicht zwischen zwei angegebenen Zahlen liegt und auch nicht eine der beiden Zahlen ist.
requireNumberNotEqualTo(number)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass eine Zahl erforderlich ist, die nicht dem angegebenen Wert entspricht.
requireTextContains(text)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass die Eingabe den angegebenen Wert enthalten muss.
requireTextDoesNotContain(text)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass die Eingabe den angegebenen Wert nicht enthalten darf.
requireTextEqualTo(text)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass die Eingabe dem angegebenen Wert entsprechen muss.
requireTextIsEmail()DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass die Eingabe in Form einer E‑Mail-Adresse erfolgen muss.
requireTextIsUrl()DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass die Eingabe in Form einer URL erfolgen muss.
requireValueInList(values)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass die Eingabe einem der angegebenen Werte entsprechen muss.
requireValueInList(values, showDropdown)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass die Eingabe einem der angegebenen Werte entsprechen muss. Das Drop-down-Menü kann ausgeblendet werden.
requireValueInRange(range)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass die Eingabe einem Wert im angegebenen Bereich entsprechen muss.
requireValueInRange(range, showDropdown)DataValidationBuilderLegt die Datenvalidierungsregel so fest, dass die Eingabe einem Wert im angegebenen Bereich entsprechen muss. Das Drop-down-Menü kann ausgeblendet werden.
setAllowInvalid(allowInvalidData)DataValidationBuilderLegt fest, ob eine Warnung angezeigt werden soll, wenn die Eingabe die Datenvalidierung nicht besteht, oder ob die Eingabe vollständig abgelehnt werden soll.
setHelpText(helpText)DataValidationBuilderLegt 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)DataValidationBuilderLegt die Datenvalidierungsregel auf Kriterien fest, die durch DataValidationCriteria-Werte definiert werden, die in der Regel aus dem criteria und arguments einer vorhandenen Regel stammen.

Detaillierte Dokumentation

build()

Erstellt eine Datenvalidierungsregel aus den auf das Builder-Objekt angewendeten Einstellungen.

Rückflug

DataValidation: Darstellung der Regel für die Datenvalidierung

copy()

Erstellt ein Builder-Objekt 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 für die Regel eine Warnung angezeigt wird, 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 in der DataValidationCriteria-Enumeration definiert. Verwenden Sie getCriteriaValues(), um die Argumente für die Kriterien abzurufen. Informationen dazu, wie Sie diese Werte zum Erstellen oder Ändern einer Datenvalidierungsregel verwenden, finden 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

DataValidationCriteria – der Typ der Datenvalidierungskriterien

getCriteriaValues()

Ruft ein Array von Argumenten für die Kriterien der Regel ab. Verwenden Sie getCriteriaType(), um den Kriterientyp abzurufen. Informationen dazu, wie Sie diese Werte zum Erstellen oder Ändern einer Datenvalidierungsregel verwenden, finden 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, die dem Kriterientyp der Regel entsprechen. Die Anzahl der Argumente und ihr Typ stimmen mit der entsprechenden require...()-Methode der DataValidationBuilder-Klasse überein.

getHelpText()

Ruft den Hilfetext der Regel ab 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 gerendert. 

// 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 der angegebene Wert oder leer sein muss. Wenn die Eingabe mit dem angegebenen Wert übereinstimmt, wird die Zelle als angekreuztes 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

Parameter

NameTypBeschreibung
checkedValueObjectDer Wert, der einem angekreuzten Kästchen zugewiesen ist.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireCheckbox(checkedValue, uncheckedValue)

Legt die Datenvalidierungsregel so fest, dass die Eingabe einer der angegebenen Werte sein muss. Wenn die Eingabe checkedValue ist, wird die Zelle als angekreuztes 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireCheckbox('APPROVED', 'PENDING')
                 .build();
cell.setDataValidation(rule);

Parameter

NameTypBeschreibung
checkedValueObjectDer Wert, der einem angekreuzten Kästchen zugewiesen ist.
uncheckedValueObjectDer Wert, der einem nicht angekreuzten 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 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 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

NameTypBeschreibung
dateDateDas spätestmögliche Datum.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireDateBefore(date)

Legt die Datenvalidierungsregel so fest, dass ein Datum vor dem angegebenen Wert erforderlich ist. 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 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

NameTypBeschreibung
dateDateDas früheste unzulässige Datum.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireDateBetween(start, end)

Legt die Regel zur Datenvalidierung so fest, dass ein Datum erforderlich ist, das zwischen zwei angegebenen Datumsangaben liegt oder eines der beiden angegebenen Datumsangaben 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.
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

NameTypBeschreibung
startDateDas frühestmögliche akzeptable Datum.
endDateDas spätestmögliche 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 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateEqualTo(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parameter

NameTypBeschreibung
dateDateDas einzig akzeptable Datum.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireDateNotBetween(start, end)

Legt die Daten-Validierungsregel so fest, dass ein Datum erforderlich ist, das nicht zwischen zwei angegebenen Datumsangaben liegt und auch nicht mit einer der beiden übereinstimmt. 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.
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

NameTypBeschreibung
startDateDas früheste unzulässige Datum.
endDateDas spätestmögliche Datum.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireDateOnOrAfter(date)

Legt die Datenvalidierungsregel so fest, dass ein Datum ab dem angegebenen Wert erforderlich ist. 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parameter

NameTypBeschreibung
dateDateDas frühestmögliche akzeptable Datum.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireDateOnOrBefore(date)

Legt die Datenvalidierungsregel so fest, dass ein Datum vor oder gleich dem angegebenen Wert erforderlich ist. 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parameter

NameTypBeschreibung
dateDateDas spätestmögliche Datum.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireFormulaSatisfied(formula)

Legt die Regel zur Datenvalidierung so fest, 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

NameTypBeschreibung
formulaStringEine benutzerdefinierte Formel, die mit true ausgewertet wird, wenn die Eingabe gültig ist.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireNumberBetween(start, end)

Legt die Regel zur Datenvalidierung so fest, dass eine Zahl erforderlich ist, die zwischen zwei angegebenen Zahlen liegt oder eine der beiden Zahlen ist. 

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

NameTypBeschreibung
startNumberDer niedrigste akzeptable Wert.
endNumberDer höchste akzeptable 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

NameTypBeschreibung
numberNumberDer einzige zulässige Wert.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireNumberGreaterThan(number)

Legt die Datenvalidierungsregel so fest, dass eine Zahl erforderlich ist, die größer als der angegebene Wert 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

NameTypBeschreibung
numberNumberDer höchste unzulässige Wert.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireNumberGreaterThanOrEqualTo(number)

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

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

NameTypBeschreibung
numberNumberDer niedrigste akzeptable 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

NameTypBeschreibung
numberNumberDer 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

NameTypBeschreibung
numberNumberDer höchste akzeptable Wert.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireNumberNotBetween(start, end)

Legt fest, dass für die Datenvalidierungsregel eine Zahl erforderlich ist, die nicht zwischen zwei angegebenen Zahlen liegt und auch nicht eine der beiden Zahlen 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

NameTypBeschreibung
startNumberDer niedrigste inakzeptable Wert.
endNumberDer höchste unzulässige Wert.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireNumberNotEqualTo(number)

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

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

NameTypBeschreibung
numberNumberDer 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

NameTypBeschreibung
textStringDer Wert, den die Eingabe enthalten muss.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireTextDoesNotContain(text)

Legt die Datenvalidierungsregel so fest, 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

NameTypBeschreibung
textStringDer 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

NameTypBeschreibung
textStringDer 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()

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.
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

NameTypBeschreibung
valuesString[]Ein Array zulässiger Werte.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireValueInList(values, showDropdown)

Legt die Datenvalidierungsregel so fest, dass die Eingabe einem der angegebenen Werte entsprechen muss. Das Drop-down-Menü kann optional ausgeblendet werden. 

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

NameTypBeschreibung
valuesString[]Ein Array zulässiger Werte.
showDropdownBooleantrue, wenn in der Tabelle ein Drop-down-Menü für die Werte angezeigt werden soll; false, wenn nicht.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireValueInRange(range)

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

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

NameTypBeschreibung
rangeRangeEin Bereich, der die zulässigen Werte enthält.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

requireValueInRange(range, showDropdown)

Legt die Datenvalidierungsregel so fest, dass die Eingabe einem Wert im angegebenen Bereich entsprechen muss. Das Drop-down-Menü kann ausgeblendet werden. 

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

NameTypBeschreibung
rangeRangeEin Bereich, der die zulässigen Werte enthält.
showDropdownBooleantrue, wenn in der Tabelle ein Drop-down-Menü für die Werte angezeigt werden soll; false, wenn nicht.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

setAllowInvalid(allowInvalidData)

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

Parameter

NameTypBeschreibung
allowInvalidDataBooleantrue, wenn die Regel Eingaben zulassen soll, die die Datenvalidierung nicht bestehen; false, wenn nicht.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

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

NameTypBeschreibung
helpTextStringDer festzulegende Hilfetext.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung

withCriteria(criteria, args)

Legt die Datenvalidierungsregel auf Kriterien fest, die durch DataValidationCriteria-Werte definiert werden, die in der Regel aus dem criteria und arguments 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

NameTypBeschreibung
criteriaDataValidationCriteriaDer Typ der Datenvalidierungskriterien.
argsObject[]Ein Array von Argumenten, die dem Kriterientyp entsprechen. Die Anzahl der Argumente und ihr Typ stimmen mit der entsprechenden require...()-Methode oben überein.

Rückflug

DataValidationBuilder – dieser Builder zur Verkettung