Diese Seite wurde von der Cloud Translation API übersetzt.

Class ConditionalFormatRuleBuilder

Tool zum Erstellen von Regeln für die bedingte Formatierung.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number between 1 and 10.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`build()`	`ConditionalFormatRule`	Erstellt eine Regel für die bedingte Formatierung aus den Einstellungen, die auf den Builder angewendet wurden.
`copy()`	`ConditionalFormatRuleBuilder`	Gibt eine voreingestellte Regelvorlage mit den Einstellungen dieser Regel zurück.
`getBooleanCondition()`	`BooleanCondition`	Ruft die `BooleanCondition`-Informationen der Regel ab, wenn diese Regel boolesche Bedingungskriterien verwendet.
`getGradientCondition()`	`GradientCondition`	Ruft die `GradientCondition`-Informationen der Regel ab, wenn diese Regel Kriterien für stufenweise Bedingungen verwendet.
`getRanges()`	`Range[]`	Hier werden die Bereiche abgerufen, auf die diese Regel für die bedingte Formatierung angewendet wird.
`setBackground(color)`	`ConditionalFormatRuleBuilder`	Legt die Hintergrundfarbe für das Format der bedingten Formatierungsregel fest.
`setBackgroundObject(color)`	`ConditionalFormatRuleBuilder`	Legt die Hintergrundfarbe für das Format der bedingten Formatierungsregel fest.
`setBold(bold)`	`ConditionalFormatRuleBuilder`	Hiermit wird der Text für die Formatierungsregel der bedingten Formatierung fett formatiert.
`setFontColor(color)`	`ConditionalFormatRuleBuilder`	Hiermit wird die Schriftfarbe für das Format der bedingten Formatierungsregel festgelegt.
`setFontColorObject(color)`	`ConditionalFormatRuleBuilder`	Hiermit wird die Schriftfarbe für das Format der bedingten Formatierungsregel festgelegt.
`setGradientMaxpoint(color)`	`ConditionalFormatRuleBuilder`	Der Wert für den Höchstpunkt der Farbabstufung in der bedingten Formatierungsregel wird gelöscht und stattdessen wird der Höchstwert in den Bereichen der Regel verwendet.
`setGradientMaxpointObject(color)`	`ConditionalFormatRuleBuilder`	Der Wert für den Höchstpunkt der Farbabstufung in der bedingten Formatierungsregel wird gelöscht und stattdessen wird der Höchstwert in den Bereichen der Regel verwendet.
`setGradientMaxpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Legt die Felder für den maximalen Punkt des Farbverlaufs der bedingten Formatierungsregel fest.
`setGradientMaxpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Legt die Felder für den maximalen Punkt des Farbverlaufs der bedingten Formatierungsregel fest.
`setGradientMidpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Hier legen Sie die Felder für den Mittelpunkt des Farbverlaufs der bedingten Formatierungsregel fest.
`setGradientMidpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Hier legen Sie die Felder für den Mittelpunkt des Farbverlaufs der bedingten Formatierungsregel fest.
`setGradientMinpoint(color)`	`ConditionalFormatRuleBuilder`	Der Wert für den Mindestpunkt der Farbabstufung der bedingten Formatierungsregel wird gelöscht und stattdessen wird der Mindestwert in den Bereichen der Regel verwendet.
`setGradientMinpointObject(color)`	`ConditionalFormatRuleBuilder`	Der Wert für den Mindestpunkt der Farbabstufung der bedingten Formatierungsregel wird gelöscht und stattdessen wird der Mindestwert in den Bereichen der Regel verwendet.
`setGradientMinpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Legt die Minpunktfelder des Farbverlaufs der bedingten Formatierungsregel fest.
`setGradientMinpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Legt die Minpunktfelder des Farbverlaufs der bedingten Formatierungsregel fest.
`setItalic(italic)`	`ConditionalFormatRuleBuilder`	Legt für die bedingte Formatierungsregel die Formatierung „Kursiv“ fest.
`setRanges(ranges)`	`ConditionalFormatRuleBuilder`	Legt einen oder mehrere Bereiche fest, auf die diese bedingte Formatierungsregel angewendet wird.
`setStrikethrough(strikethrough)`	`ConditionalFormatRuleBuilder`	Hiermit wird der Text durchgestrichen.
`setUnderline(underline)`	`ConditionalFormatRuleBuilder`	Legt die Textunterstreichung für das Format der bedingten Formatierungsregel fest.
`whenCellEmpty()`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn die Zelle leer ist.
`whenCellNotEmpty()`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn die Zelle nicht leer ist.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn ein Datum nach dem angegebenen Wert liegt.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn ein Datum nach dem angegebenen relativen Datum liegt.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn ein Datum vor dem angegebenen Datum liegt.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn ein Datum vor dem angegebenen relativen Datum liegt.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn ein Datum mit dem angegebenen Datum übereinstimmt.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn ein Datum mit dem angegebenen relativen Datum übereinstimmt.
`whenFormulaSatisfied(formula)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn die angegebene Formel `true` ergibt.
`whenNumberBetween(start, end)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl zwischen zwei oder einem der beiden angegebenen Werte liegt.
`whenNumberEqualTo(number)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl dem angegebenen Wert entspricht.
`whenNumberGreaterThan(number)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl größer als der angegebene Wert ist.
`whenNumberGreaterThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl größer oder gleich dem angegebenen Wert ist.
`whenNumberLessThan(number)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl kleiner als der angegebene Wert ist.
`whenNumberLessThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl kleiner oder gleich dem angegebenen Wert ist.
`whenNumberNotBetween(start, end)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl nicht zwischen zwei angegebenen Werten liegt und auch keiner dieser Werte ist.
`whenNumberNotEqualTo(number)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl nicht mit dem angegebenen Wert übereinstimmt.
`whenTextContains(text)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn die Eingabe den angegebenen Wert enthält.
`whenTextDoesNotContain(text)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn die Eingabe den angegebenen Wert nicht enthält.
`whenTextEndsWith(text)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn die Eingabe mit dem angegebenen Wert endet.
`whenTextEqualTo(text)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn die Eingabe dem angegebenen Wert entspricht.
`whenTextStartsWith(text)`	`ConditionalFormatRuleBuilder`	Die bedingte Formatierungsregel wird ausgelöst, wenn die Eingabe mit dem angegebenen Wert beginnt.
`withCriteria(criteria, args)`	`ConditionalFormatRuleBuilder`	Hiermit wird die bedingte Formatregel auf Kriterien festgelegt, die durch `BooleanCriteria`-Werte definiert sind, die in der Regel aus den `criteria`- und `arguments`-Werten einer vorhandenen Regel stammen.

Detaillierte Dokumentation

`build()`

Erstellt eine Regel für die bedingte Formatierung aus den Einstellungen, die auf den Builder angewendet wurden.

Rückflug

ConditionalFormatRule – Darstellung der Regel für die bedingte Formatierung

`copy()`

Gibt eine voreingestellte Regelvorlage mit den Einstellungen dieser Regel zurück.

Rückflug

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

`getBooleanCondition()`

Ruft die BooleanCondition-Informationen der Regel ab, wenn diese Regel boolesche Bedingungskriterien verwendet. Andernfalls wird null zurückgegeben.

// Log the boolean criteria type of the first conditional format rules of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

Rückflug

BooleanCondition: das boolesche Bedingungsobjekt oder null, wenn in der Regel keine boolesche Bedingung verwendet wird.

`getGradientCondition()`

Ruft die GradientCondition-Informationen der Regel ab, wenn diese Regel Kriterien für stufenweise Bedingungen verwendet. Andernfalls wird null zurückgegeben.

// Log the gradient minimum color of the first conditional format rule of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const gradientCondition = rule.getGradientCondition();
if (gradientCondition != null) {
  // Assume the color has ColorType.RGB.
  Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString());
}

Rückflug

GradientCondition: Das Objekt der Gradientenbedingung oder null, wenn in der Regel keine Gradientenbedingung verwendet wird.

`getRanges()`

Hier werden die Bereiche abgerufen, auf die diese Regel für die bedingte Formatierung angewendet wird.

// Log each range of the first conditional format rule of a sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const ranges = rule.getRanges();
for (let i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

Rückflug

Range[]: Bereiche, auf die diese Regel für die bedingte Formatierung angewendet wird.

`setBackground(color)`

Legt die Hintergrundfarbe für das Format der bedingten Formatierungsregel fest. Wenn Sie null übergeben, wird die Formateinstellung für die Hintergrundfarbe aus der Regel entfernt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color to red if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die gewünschte Farbe oder `null`, um die Auswahl aufzuheben.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`setBackgroundObject(color)`

Legt die Hintergrundfarbe für das Format der bedingten Formatierungsregel fest. Wenn Sie null übergeben, wird die Formateinstellung für die Hintergrundfarbe aus der Regel entfernt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color to theme background color if the cell has text
// equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
                  .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBackground(color)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Das gewünschte Farbobjekt oder `null` zum Löschen

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

`setBold(bold)`

Hiermit wird der Text für die Formatierungsregel der bedingten Formatierung fett formatiert. Wenn bold true ist, wird Text durch die Regel fett formatiert, wenn die Bedingung erfüllt ist. Bei false entfernt die Regel alle vorhandenen Fettformatierungen, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Formateinstellung „Fett“ aus der Regel entfernt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn their text bold if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBold(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`bold`	`Boolean`	Gibt an, ob der Text fett formatiert werden soll, wenn die Formatierungsbedingung erfüllt ist. Mit `null` wird diese Einstellung entfernt.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`setFontColor(color)`

Hiermit wird die Schriftfarbe für das Format der bedingten Formatierungsregel festgelegt. Wenn Sie null übergeben, wird die Einstellung für das Schriftfarbenformat aus der Regel entfernt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their font color to red if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setFontColor('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die gewünschte Farbe oder `null`, um die Auswahl aufzuheben.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`setFontColorObject(color)`

Hiermit wird die Schriftfarbe für das Format der bedingten Formatierungsregel festgelegt. Wenn Sie null übergeben, wird die Einstellung für das Schriftfarbenformat aus der Regel entfernt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their font color to theme text color if the cell has text equal to
// "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                  .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setFontColor(color)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Das gewünschte Farbobjekt oder `null` zum Löschen

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

`setGradientMaxpoint(color)`

Der Wert für den Höchstpunkt der Farbabstufung in der bedingten Formatierungsregel wird gelöscht und stattdessen wird der Höchstwert in den Bereichen der Regel verwendet. Außerdem wird die Farbe des Maximalpunkts des Farbverlaufs auf die Eingabefarbe festgelegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere between white and red, based on their
// values in comparison to the ranges minimum and maximum values.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint('#FF0000')
                 .setGradientMinpoint('#FFFFFF')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die Farbe für den Maximalwert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`setGradientMaxpointObject(color)`

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere between theme text and background
// colors, based on their values in comparison to the ranges minimum and maximum
// values.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const textColor = SpreadsheetApp.newColor()
                      .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                      .build();
const backgroundColor =
    SpreadsheetApp.newColor()
        .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
        .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint(textColor)
                 .setGradientMinpoint(backgroundColor)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Das zu festzulegende Farbobjekt für den Maximalwert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

`setGradientMaxpointObjectWithValue(color, type, value)`

Legt die Felder für den maximalen Punkt des Farbverlaufs der bedingten Formatierungsregel fest.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from theme accent 1, accent 2 to accent
// 3 colors, based on their values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color1 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                   .build();
const color2 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                   .build();
const color3 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                   .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     color1,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     color2,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     color3,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Die Farbe für den Maximalwert.
`type`	`InterpolationType`	Der zu festzulegende Interpolationstyp für die Maximalpunkte.
`value`	`String`	Der festzulegende Wert für „maxpoint“.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

`setGradientMaxpointWithValue(color, type, value)`

Legt die Felder für den maximalen Punkt des Farbverlaufs der bedingten Formatierungsregel fest.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from red green to blue, based on their
// values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     '#0000FF',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     '#00FF00',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     '#FF0000',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die Farbe für den Maximalwert.
`type`	`InterpolationType`	Der zu festzulegende Interpolationstyp für die Maximalpunkte.
`value`	`String`	Der festzulegende Wert für „maxpoint“.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`setGradientMidpointObjectWithValue(color, type, value)`

Hier legen Sie die Felder für den Mittelpunkt des Farbverlaufs der bedingten Formatierungsregel fest. Alle Mittelpunktfelder werden gelöscht, wenn der übergebene Interpolationstyp null ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from theme accent 1 to accent 2 to
// accent 3 colors, based on their values in comparison to the values 0, 50, and
// 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color1 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                   .build();
const color2 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                   .build();
const color3 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                   .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     color1,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     color2,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     color3,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Die Farbe für den Mittelwert.
`type`	`InterpolationType`	Der zu festzulegende Mittelpunktinterpolationstyp oder `null` zum Löschen.
`value`	`String`	Der festzulegende Mittelwert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

`setGradientMidpointWithValue(color, type, value)`

Hier legen Sie die Felder für den Mittelpunkt des Farbverlaufs der bedingten Formatierungsregel fest. Alle Mittelpunktfelder werden gelöscht, wenn der übergebene Interpolationstyp null ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from red green to blue, based on their
// values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     '#0000FF',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     '#00FF00',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     '#FF0000',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die Farbe für den Mittelwert.
`type`	`InterpolationType`	Der zu festzulegende Mittelpunktinterpolationstyp oder `null` zum Löschen.
`value`	`String`	Der festzulegende Mittelwert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`setGradientMinpoint(color)`

Der Wert für den Mindestpunkt der Farbabstufung der bedingten Formatierungsregel wird gelöscht und stattdessen wird der Mindestwert in den Bereichen der Regel verwendet. Außerdem wird die Farbe des Minimpunkts des Farbverlaufs auf die Eingabefarbe festgelegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere between white and red, based on their
// values in comparison to the ranges minimum and maximum values.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint('#FF0000')
                 .setGradientMinpoint('#FFFFFF')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die Farbe für den Minimalwert.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`setGradientMinpointObject(color)`

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere between theme text and background
// colors, based on their values in comparison to the ranges minimum and maximum
// values.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const textColor = SpreadsheetApp.newColor()
                      .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                      .build();
const backgroundColor =
    SpreadsheetApp.newColor()
        .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
        .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint(textColor)
                 .setGradientMinpoint(backgroundColor)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Das zu festzulegende Farbobjekt für den Minimalwert.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

`setGradientMinpointObjectWithValue(color, type, value)`

Legt die Minpunktfelder des Farbverlaufs der bedingten Formatierungsregel fest.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from theme accent 1 to accent 2 to
// accent 3 colors, based on their values in comparison to the values 0, 50, and
// 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color1 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                   .build();
const color2 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                   .build();
const color3 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                   .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     color1,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     color2,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     color3,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`Color`	Die Farbe für den Minimalwert.
`type`	`InterpolationType`	Der zu festlegende Interpolationstyp für Minima.
`value`	`String`	Der Wert für den Mindestpunkt.

Rückflug

ConditionalFormatRuleBuilder – Der Builder zur Verkettung.

`setGradientMinpointWithValue(color, type, value)`

Legt die Minpunktfelder des Farbverlaufs der bedingten Formatierungsregel fest.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from red to green to blue, based on
// their values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     '#0000FF',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     '#00FF00',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     '#FF0000',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`color`	`String`	Die Farbe für den Minimalwert.
`type`	`InterpolationType`	Der zu festlegende Interpolationstyp für Minima.
`value`	`String`	Der Wert für den Mindestpunkt.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`setItalic(italic)`

Legt für die bedingte Formatierungsregel die Formatierung „Kursiv“ fest. Wenn italic true ist, wird Text durch die Regel kursiv formatiert, wenn die Bedingung erfüllt ist. Bei false entfernt die Regel vorhandene Kursivformatierungen, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Formateinstellung „Kursiv“ aus der Regel entfernt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn their text italic if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setItalic(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`italic`	`Boolean`	Gibt an, ob der Text kursiv formatiert werden soll, wenn die Formatierungsbedingung erfüllt ist. Mit `null` wird diese Einstellung entfernt.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`setRanges(ranges)`

Legt einen oder mehrere Bereiche fest, auf die diese bedingte Formatierungsregel angewendet wird. Dabei werden alle vorhandenen Bereiche ersetzt. Wenn Sie ein leeres Array festlegen, werden alle vorhandenen Bereiche gelöscht. Eine Regel muss mindestens einen Bereich haben.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3
// and range D4:F6 to turn red if they contain a number between 1 and 10.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeOne = sheet.getRange('A1:B3');
const rangeTwo = sheet.getRange('D4:F6');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([rangeOne, rangeTwo])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`ranges`	`Range[]`	Die Bereiche, auf die diese Regel für die bedingte Formatierung angewendet wird.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`setStrikethrough(strikethrough)`

Hiermit wird der Text durchgestrichen. Wenn strikethrough true ist, wird durch die Regel Text durchgestrichen, wenn die Bedingung erfüllt ist. Bei false entfernt die Regel vorhandene Durchstreichungen, wenn die Bedingung erfüllt ist. Wenn Sie �14 übergeben, wird die Formateinstellung „Durchgestrichen“ aus der Regel entfernt.null

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// strikethrough their text if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setStrikethrough(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`strikethrough`	`Boolean`	Gibt an, ob der Text durchgestrichen werden soll, wenn die Formatierungsbedingung erfüllt ist. Mit `null` wird diese Einstellung entfernt.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`setUnderline(underline)`

Legt die Textunterstreichung für das Format der bedingten Formatierungsregel fest. Wenn underline true ist, wird Text durch die Regel unterstrichen, wenn die Bedingung erfüllt ist. Bei false entfernt die Regel alle vorhandenen Unterstreichungen, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Formateinstellung für Unterstreichungen aus der Regel entfernt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// underline their text if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setUnderline(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`underline`	`Boolean`	Gibt an, ob der Text unterstrichen werden soll, wenn die Formatbedingung erfüllt ist. Mit `null` wird diese Einstellung entfernt.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenCellEmpty()`

Die bedingte Formatierungsregel wird ausgelöst, wenn die Zelle leer ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they are empty.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenCellEmpty()
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenCellNotEmpty()`

Die bedingte Formatierungsregel wird ausgelöst, wenn die Zelle nicht leer ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they are not empty.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenCellNotEmpty()
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenDateAfter(date)`

Die bedingte Formatierungsregel wird ausgelöst, wenn ein Datum nach dem angegebenen Wert liegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a date after 11/4/1993.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateAfter(new Date('11/4/1993'))
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`date`	`Date`	Das aktuelle Datum.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenDateAfter(date)`

Die bedingte Formatierungsregel wird ausgelöst, wenn ein Datum nach dem angegebenen relativen Datum liegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a date after today.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`date`	`RelativeDate`	Das aktuelle Datum bezogen auf den ausgewählten Datumstyp.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenDateBefore(date)`

Die bedingte Formatierungsregel wird ausgelöst, wenn ein Datum vor dem angegebenen Datum liegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a date before 11/4/1993.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateBefore(new Date('11/4/1993'))
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenDateBefore(date)`

Die bedingte Formatierungsregel wird ausgelöst, wenn ein Datum vor dem angegebenen relativen Datum liegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a date before today.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`date`	`RelativeDate`	Das aktuelle Datum bezogen auf den ausgewählten Datumstyp.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenDateEqualTo(date)`

Die bedingte Formatierungsregel wird ausgelöst, wenn ein Datum mit dem angegebenen Datum übereinstimmt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain the date 11/4/1993.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateEqualTo(new Date('11/4/1993'))
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenDateEqualTo(date)`

Die bedingte Formatierungsregel wird ausgelöst, wenn ein Datum mit dem angegebenen relativen Datum übereinstimmt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain todays date.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`date`	`RelativeDate`	Das aktuelle Datum bezogen auf den ausgewählten Datumstyp.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenFormulaSatisfied(formula)`

Die bedingte Formatierungsregel wird ausgelöst, wenn die angegebene Formel true ergibt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they satisfy the condition "=EQ(B4, C3)".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenFormulaSatisfied('=EQ(B4, C3)')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenNumberBetween(start, end)`

Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl zwischen zwei oder einem der beiden angegebenen Werte liegt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number between 1 and 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenNumberEqualTo(number)`

Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl dem angegebenen Wert entspricht.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain the number 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenNumberGreaterThan(number)`

Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl größer als der angegebene Wert ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number greater than 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberGreaterThan(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenNumberGreaterThanOrEqualTo(number)`

Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl größer oder gleich dem angegebenen Wert ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number greater than or equal to 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberGreaterThanOrEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenNumberLessThan(number)`

Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl kleiner als der angegebene Wert ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number less than 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberLessThan(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenNumberLessThanOrEqualTo(number)`

Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl kleiner oder gleich dem angegebenen Wert ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number less than or equal to 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberLessThanOrEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenNumberNotBetween(start, end)`

Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl nicht zwischen zwei angegebenen Werten liegt und auch keiner dieser Werte ist.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number not between 1 and 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberNotBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenNumberNotEqualTo(number)`

Die bedingte Formatierungsregel wird ausgelöst, wenn eine Zahl nicht mit dem angegebenen Wert übereinstimmt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they don't contain the number 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberNotEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenTextContains(text)`

Die bedingte Formatierungsregel wird ausgelöst, wenn die Eingabe den angegebenen Wert enthält.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain the text "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextContains('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenTextDoesNotContain(text)`

Die bedingte Formatierungsregel wird ausgelöst, wenn die Eingabe den angegebenen Wert nicht enthält.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they don't contain the text "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextDoesNotContain('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenTextEndsWith(text)`

Die bedingte Formatierungsregel wird ausgelöst, wenn die Eingabe mit dem angegebenen Wert endet.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they end with the text "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEndsWith('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Text, der mit dem Ende des Strings verglichen werden soll.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenTextEqualTo(text)`

Die bedingte Formatierungsregel wird ausgelöst, wenn die Eingabe dem angegebenen Wert entspricht.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they have text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

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

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`whenTextStartsWith(text)`

Die bedingte Formatierungsregel wird ausgelöst, wenn die Eingabe mit dem angegebenen Wert beginnt.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they start with the text "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextStartsWith('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`text`	`String`	Text, der mit dem Anfang des Strings verglichen werden soll.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung

`withCriteria(criteria, args)`

Hiermit wird die bedingte Formatregel auf Kriterien festgelegt, die durch BooleanCriteria-Werte definiert sind, die in der Regel aus den criteria- und arguments-Werten einer vorhandenen Regel stammen.

// Adds a new conditional format rule that is a copy of the first active
// conditional format rule, except it instead sets its cells to have a black
// background color.

const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
const booleanCondition = rules[0].getBooleanCondition();
if (booleanCondition != null) {
  const rule = SpreadsheetApp.newConditionalFormatRule()
                   .withCriteria(
                       booleanCondition.getCriteriaType(),
                       booleanCondition.getCriteriaValues(),
                       )
                   .setBackground('#000000')
                   .setRanges(rules[0].getRanges())
                   .build();
  rules.push(rule);
}
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
`criteria`	`BooleanCriteria`	Die Art der Kriterien für die bedingte Formatierung.
`args`	`Object[]`	Ein Array von Argumenten, das dem Kriterientyp entspricht. Die Anzahl der Argumente und ihr Typ stimmen mit der entsprechenden `when...()`-Methode oben überein.

Rückflug

ConditionalFormatRuleBuilder – der Builder für die Verkettung