Class ConditionalFormatRuleBuilder

ConditionalFormatRuleBuilder

Builder für Regeln zur bedingten 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.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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 werden.
copy()	ConditionalFormatRuleBuilder	Gibt eine Voreinstellung zur Regelerstellung 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 Gradientenbedingungskriterien verwendet.
getRanges()	Range[]	Ruft die Bereiche ab, auf die diese Regel zur bedingten Formatierung angewendet wird.
setBackground(color)	ConditionalFormatRuleBuilder	Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest.
setBackgroundObject(color)	ConditionalFormatRuleBuilder	Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest.
setBold(bold)	ConditionalFormatRuleBuilder	Legt die Fettformatierung für das Format der bedingten Formatierungsregel fest.
setFontColor(color)	ConditionalFormatRuleBuilder	Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest.
setFontColorObject(color)	ConditionalFormatRuleBuilder	Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest.
setGradientMaxpoint(color)	ConditionalFormatRuleBuilder	Löscht den Gradientenhöchstwert der Regel für die bedingte Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel.
setGradientMaxpointObject(color)	ConditionalFormatRuleBuilder	Löscht den Gradientenhöchstwert der Regel für die bedingte Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel.
setGradientMaxpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Gradienten-Maximalpunktfelder der Regel für die bedingte Formatierung fest.
setGradientMaxpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Gradienten-Maximalpunktfelder der Regel für die bedingte Formatierung fest.
setGradientMidpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für den Gradientenmittelpunkt der bedingten Formatierung fest.
setGradientMidpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Felder für den Gradientenmittelpunkt der bedingten Formatierung fest.
setGradientMinpoint(color)	ConditionalFormatRuleBuilder	Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Minimalwert in den Bereichen der Regel.
setGradientMinpointObject(color)	ConditionalFormatRuleBuilder	Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Minimalwert in den Bereichen der Regel.
setGradientMinpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Gradientenminpoint-Felder der Regel für die bedingte Formatierung fest.
setGradientMinpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	Legt die Gradientenminpoint-Felder der Regel für die bedingte Formatierung fest.
setItalic(italic)	ConditionalFormatRuleBuilder	Legt Text kursiv für das Format der Regel für die bedingte Formatierung fest.
setRanges(ranges)	ConditionalFormatRuleBuilder	Legt einen oder mehrere Bereiche fest, auf die diese Regel für die bedingte Formatierung angewendet wird.
setStrikethrough(strikethrough)	ConditionalFormatRuleBuilder	Hiermit wird der Text für das Format der Regel für die bedingte Formatierung durchgestrichen.
setUnderline(underline)	ConditionalFormatRuleBuilder	Legt Text unterstrichen für das Format der Regel für die bedingte Formatierung fest.
whenCellEmpty()	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Zelle leer ist.
whenCellNotEmpty()	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die Zelle nicht leer ist.
whenDateAfter(date)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum nach dem angegebenen Wert liegt.
whenDateAfter(date)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum nach dem angegebenen relativen Datum liegt.
whenDateBefore(date)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum vor dem angegebenen Datum liegt.
whenDateBefore(date)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum vor dem angegebenen relativen Datum liegt.
whenDateEqualTo(date)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum dem angegebenen Datum entspricht.
whenDateEqualTo(date)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum dem angegebenen relativen Datum entspricht.
whenFormulaSatisfied(formula)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn die angegebene Formel true ergibt.
whenNumberBetween(start, end)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl zwischen zwei angegebenen Werten liegt oder einer dieser Werte ist.
whenNumberEqualTo(number)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl dem angegebenen Wert entspricht.
whenNumberGreaterThan(number)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl größer als der angegebene Wert ist.
whenNumberGreaterThanOrEqualTo(number)	ConditionalFormatRuleBuilder	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl größer oder gleich dem angegebenen Wert ist.
whenNumberLessThan(number)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl kleiner als der angegebene Wert ist.
whenNumberLessThanOrEqualTo(number)	ConditionalFormatRuleBuilder	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn eine Zahl kleiner oder gleich dem angegebenen Wert ist.
whenNumberNotBetween(start, end)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl nicht zwischen zwei angegebenen Werten liegt oder keiner dieser Werte ist.
whenNumberNotEqualTo(number)	ConditionalFormatRuleBuilder	Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl nicht dem angegebenen Wert entspricht.
whenTextContains(text)	ConditionalFormatRuleBuilder	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe den angegebenen Wert enthält.
whenTextDoesNotContain(text)	ConditionalFormatRuleBuilder	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe den angegebenen Wert nicht enthält.
whenTextEndsWith(text)	ConditionalFormatRuleBuilder	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe mit dem angegebenen Wert endet.
whenTextEqualTo(text)	ConditionalFormatRuleBuilder	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe dem angegebenen Wert entspricht.
whenTextStartsWith(text)	ConditionalFormatRuleBuilder	Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, wenn die Eingabe mit dem angegebenen Wert beginnt.
withCriteria(criteria, args)	ConditionalFormatRuleBuilder	Legt die Regel für die bedingte Formatierung auf Kriterien fest, die durch BooleanCriteria-Werte definiert sind, die in der Regel aus criteria und arguments einer vorhandenen Regel übernommen werden.

Detaillierte Dokumentation

build()

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

Return

ConditionalFormatRule: Eine Darstellung der Regel für die bedingte Formatierung

---

copy()

Gibt eine Voreinstellung zur Regelerstellung mit den Einstellungen dieser Regel zurück.

Return

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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

Return

BooleanCondition: das boolesche Bedingungsobjekt oder null, wenn die Regel keine boolesche Bedingung verwendet

---

getGradientCondition()

Ruft die GradientCondition-Informationen der Regel ab, wenn diese Regel Gradientenbedingungskriterien verwendet. Andernfalls wird null zurückgegeben.

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

Return

GradientCondition: das Verlaufsbedingungsobjekt oder null, wenn in der Regel keine Gradientenbedingung verwendet wird

---

getRanges()

Ruft die Bereiche ab, auf die diese Regel zur bedingten Formatierung angewendet wird.

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

Return

Range[]: Die Bereiche, auf die diese Regel zur bedingten Formatierung angewendet wird.

---

setBackground(color)

Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest. Wenn Sie null übergeben, wird die Einstellung 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".

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

Parameter

Name	Typ	Beschreibung
color	String	Die gewünschte Farbe oder null zum Löschen.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

setBackgroundObject(color)

Legt die Hintergrundfarbe für das Format der Regel für die bedingte Formatierung fest. Wenn Sie null übergeben, wird die Einstellung 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".

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

Parameter

Name	Typ	Beschreibung
color	Color	Das zu löschende Farbobjekt oder null.

Return

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setBold(bold)

Legt die Fettformatierung für das Format der bedingten Formatierungsregel fest. Wenn bold den Wert true hat, wird Text in der Regel fett formatiert, wenn die Bedingung erfüllt ist. Wenn false, entfernt die Regel alle vorhandenen Fettdrucke, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Einstellung für die Fettformatierung 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBold(true)
    .setRanges([range])
    .build();
var 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; null entfernt diese Einstellung.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

setFontColor(color)

Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest. Wenn Sie null übergeben, wird die Einstellung für die Schriftfarbe 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".

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

Parameter

Name	Typ	Beschreibung
color	String	Die gewünschte Farbe oder null zum Löschen.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

setFontColorObject(color)

Legt die Schriftfarbe für das Format der Regel für die bedingte Formatierung fest. Wenn Sie null übergeben, wird die Einstellung für die Schriftfarbe 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".

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

Parameter

Name	Typ	Beschreibung
color	Color	Das zu löschende Farbobjekt oder null.

Return

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setGradientMaxpoint(color)

Löscht den Gradientenhöchstwert der Regel für die bedingte Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel. Außerdem wird die Höchstpunktfarbe 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.

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

Parameter

Name	Typ	Beschreibung
color	String	Die festzulegende Höchstpunktfarbe.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

setGradientMaxpointObject(color)

Löscht den Gradientenhöchstwert der Regel für die bedingte Formatierung und verwendet stattdessen den Maximalwert in den Bereichen der Regel. Außerdem wird die Höchstpunktfarbe 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 theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

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

Parameter

Name	Typ	Beschreibung
color	Color	Das festzulegende Farbobjekt für den Höchstwert.

Return

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setGradientMaxpointObjectWithValue(color, type, value)

Legt die Gradienten-Maximalpunktfelder der Regel für die bedingte Formatierung 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.

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

Parameter

Name	Typ	Beschreibung
color	Color	Die festzulegende Höchstpunktfarbe.
type	InterpolationType	Der festzulegende Höchstwertinterpolationstyp.
value	String	Der Höchstwert, der festgelegt werden soll.

Return

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setGradientMaxpointWithValue(color, type, value)

Legt die Gradienten-Maximalpunktfelder der Regel für die bedingte Formatierung 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.

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

Parameter

Name	Typ	Beschreibung
color	String	Die festzulegende Höchstpunktfarbe.
type	InterpolationType	Der festzulegende Höchstwertinterpolationstyp.
value	String	Der Höchstwert, der festgelegt werden soll.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

setGradientMidpointObjectWithValue(color, type, value)

Legt die Felder für den Gradientenmittelpunkt der bedingten Formatierung fest. Löscht alle Mittelpunktfelder, wenn der als Interpolationstyp übergebene Wert 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.

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

Parameter

Name	Typ	Beschreibung
color	Color	Die Mittelpunktfarbe, die festgelegt werden soll.
type	InterpolationType	Der festzulegende Mittelwertinterpolationstyp oder null zum Löschen.
value	String	Der festzulegende Mittelpunktwert.

Return

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setGradientMidpointWithValue(color, type, value)

Legt die Felder für den Gradientenmittelpunkt der bedingten Formatierung fest. Löscht alle Mittelpunktfelder, wenn der als Interpolationstyp übergebene Wert 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.

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

Parameter

Name	Typ	Beschreibung
color	String	Die Mittelpunktfarbe, die festgelegt werden soll.
type	InterpolationType	Der festzulegende Mittelwertinterpolationstyp oder null zum Löschen.
value	String	Der festzulegende Mittelpunktwert.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

setGradientMinpoint(color)

Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Minimalwert in den Bereichen der Regel. Legt außerdem die Minpoint-Farbe des Farbverlaufs auf die Eingabefarbe fest.

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

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

Parameter

Name	Typ	Beschreibung
color	String	Die festzulegende Mindestpunktfarbe.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

setGradientMinpointObject(color)

Löscht den Gradientenmindestwert der Regel für die bedingte Formatierung und verwendet stattdessen den Minimalwert in den Bereichen der Regel. Legt außerdem die Minpoint-Farbe des Farbverlaufs auf die Eingabefarbe fest.

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

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

Parameter

Name	Typ	Beschreibung
color	Color	Das festzulegende Minpoint-Farbobjekt.

Return

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setGradientMinpointObjectWithValue(color, type, value)

Legt die Gradientenminpoint-Felder der Regel für die bedingte Formatierung 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.

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

Parameter

Name	Typ	Beschreibung
color	Color	Die festzulegende Mindestpunktfarbe.
type	InterpolationType	Der festzulegende Minpoint-Interpolationstyp.
value	String	Der festzulegende Mindestwert.

Return

ConditionalFormatRuleBuilder: Der Builder für die Verkettung.

---

setGradientMinpointWithValue(color, type, value)

Legt die Gradientenminpoint-Felder der Regel für die bedingte Formatierung 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.

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

Parameter

Name	Typ	Beschreibung
color	String	Die festzulegende Mindestpunktfarbe.
type	InterpolationType	Der festzulegende Minpoint-Interpolationstyp.
value	String	Der festzulegende Mindestwert.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

setItalic(italic)

Legt Text kursiv für das Format der Regel für die bedingte Formatierung fest. Wenn für italic der Wert true gilt, wird Text in der Regel kursiv gesetzt, wenn die Bedingung erfüllt ist. Bei false entfernt die Regel vorhandene Kursivschrift, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Einstellung für den Kursivformat 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".

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

Parameter

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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

setRanges(ranges)

Legt einen oder mehrere Bereiche fest, auf die diese Regel für die bedingte Formatierung angewendet wird. Durch diesen Vorgang werden alle vorhandenen Bereiche ersetzt. Durch das Festlegen eines leeren Arrays 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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeOne = sheet.getRange("A1:B3");
var rangeTwo = sheet.getRange("D4:F6");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([rangeOne, rangeTwo])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parameter

Name	Typ	Beschreibung
ranges	Range[]	Die Bereiche, auf die diese Regel zur bedingten Formatierung angewendet wird.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

setStrikethrough(strikethrough)

Hiermit wird der Text für das Format der Regel für die bedingte Formatierung durchgestrichen. Wenn strikethrough den Wert true hat, wird durch die Regel der Text durchgestrichen, wenn die Bedingung erfüllt ist. Wenn die Bedingung false erfüllt ist, werden alle vorhandenen durchgestrichenen Formatierungen entfernt. Wenn Sie null übergeben, wird die Einstellung für das durchgestrichene Format aus der Regel entfernt.

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

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setStrikethrough(true)
    .setRanges([range])
    .build();
var 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 Formatbedingung erfüllt ist; null entfernt diese Einstellung.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

setUnderline(underline)

Legt Text unterstrichen für das Format der Regel für die bedingte Formatierung fest. Wenn underline den Wert true hat, unterstreicht die Regel Text, wenn die Bedingung erfüllt ist. Wenn false, entfernt die Regel alle vorhandenen Unterstreichungen, wenn die Bedingung erfüllt ist. Wenn Sie null übergeben, wird die Einstellung für das Unterstreichen 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setUnderline(true)
    .setRanges([range])
    .build();
var 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 Formatierungsbedingung erfüllt ist; null entfernt diese Einstellung.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenCellEmpty()

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, 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.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenCellNotEmpty()

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, 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.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellNotEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenDateAfter(date)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, 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.

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

Parameter

Name	Typ	Beschreibung
date	Date	Das späteste Datum.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenDateAfter(date)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, 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.

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

Parameter

Name	Typ	Beschreibung
date	RelativeDate	Das späteste Datum im Verhältnis zum ausgewählten Datumstyp.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenDateBefore(date)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, 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.

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

Parameter

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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenDateBefore(date)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, 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.

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

Parameter

Name	Typ	Beschreibung
date	RelativeDate	Das späteste Datum im Verhältnis zum ausgewählten Datumstyp.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenDateEqualTo(date)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum dem angegebenen Datum entspricht.

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

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

Parameter

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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenDateEqualTo(date)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn ein Datum dem angegebenen relativen Datum entspricht.

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

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

Parameter

Name	Typ	Beschreibung
date	RelativeDate	Das späteste Datum im Verhältnis zum ausgewählten Datumstyp.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenFormulaSatisfied(formula)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, 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)".

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

Parameter

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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenNumberBetween(start, end)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl zwischen zwei angegebenen Werten liegt oder einer 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 between 1 and 10.

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

Parameter

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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenNumberEqualTo(number)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, 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.

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

Parameter

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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenNumberGreaterThan(number)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, 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.

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

Parameter

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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenNumberGreaterThanOrEqualTo(number)

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, 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.

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

Parameter

Name	Typ	Beschreibung
number	Number	Der niedrigste akzeptable Wert.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenNumberLessThan(number)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, 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.

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

Parameter

Name	Typ	Beschreibung
number	Number	Der niedrigste inakzeptable Wert.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenNumberLessThanOrEqualTo(number)

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, 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.

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

Parameter

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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenNumberNotBetween(start, end)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl nicht zwischen zwei angegebenen Werten liegt oder 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.

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

Parameter

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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenNumberNotEqualTo(number)

Legt fest, dass die Regel für die bedingte Formatierung ausgelöst wird, wenn eine Zahl nicht dem angegebenen Wert entspricht.

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

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

Parameter

Name	Typ	Beschreibung
number	Number	Der einzige inakzeptable Wert.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenTextContains(text)

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, 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".

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

Parameter

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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenTextDoesNotContain(text)

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, 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".

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

Parameter

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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenTextEndsWith(text)

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEndsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenTextEqualTo(text)

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, 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".

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

Parameter

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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

whenTextStartsWith(text)

Legt die Regel für die bedingte Formatierung fest, die ausgelöst wird, 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextStartsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung

---

withCriteria(criteria, args)

Legt die Regel für die bedingte Formatierung auf Kriterien fest, die durch BooleanCriteria-Werte definiert sind, die in der Regel aus criteria und arguments einer vorhandenen Regel übernommen werden.

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

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

Parameter

Name	Typ	Beschreibung
criteria	BooleanCriteria	Der Typ des Kriteriums für die bedingte Formatierung.
args	Object[]	Ein Array mit Argumenten entsprechend dem Kriterientyp. Die Anzahl der Argumente und ihr Typ stimmen mit der entsprechenden when...()-Methode oben überein.

Return

ConditionalFormatRuleBuilder: der Builder für die Verkettung